httpcode 0.6
httpcode - explain HTTP status code
License: MIT

::

     _   _ _____ _____ ____   ____ ___  ____  _____
    | | | |_   _|_   _|  _ \ / ___/ _ \|  _ \| ____|
    | |_| | | |   | | | |_) | |  | | | | | | |  _|
    |  _  | | |   | | |  __/| |__| |_| | |_| | |___
    |_| |_| |_|   |_| |_|    \____\___/|____/|_____|


`httpcode` is a little utility that explains the meaning of an HTTP
status code on the command line.

`http://httpcode.readthedocs.org <http://httpcode.readthedocs.org>`_

Installation
------------

::

    $ [sudo] pip install httpcode

There is also an official DEB package available at
`http://packages.debian.org/sid/httpcode <http://packages.debian.org/sid/httpcode>`_


Usage
-----

Explain 405 status code

::

    $ hc 405
    Status code 405
    Message: Method Not Allowed
    Code explanation: Specified method is invalid for this resource.

Or 418 status code :)

::

    $ hc 418
    Status code 418
    Message: I'm a teapot
    Code explanation: The HTCPCP server is a teapot

List all codes

::

    $ hc
    Status code 100
    Message: Continue
    Code explanation: Request received, please continue

    Status code 101
    Message: Switching Protocols
    Code explanation: Switching to new protocol; obey Upgrade header

    Status code 200
    Message: OK
    Code explanation: Request fulfilled, document follows

    ...

Search code(s) by description (case-insensitive)

::

    $ hc -s too
    Status code 413
    Message: Request Entity Too Large
    Code explanation: Entity is too large.

    Status code 414
    Message: Request-URI Too Long
    Code explanation: URI is too long.

Filter codes with a regex

::

    $ hc 30[12]
    Status code 301
    Message: Moved Permanently
    Code explanation: Object moved permanently -- see URI list

    Status code 302
    Message: Found
    Code explanation: Object moved temporarily -- see URI list

Use an 'x' for any digit

::

    $ hc 1xx
    Status code 100
    Message: Continue
    Code explanation: Request received, please continue

    Status code 101
    Message: Switching Protocols
    Code explanation: Switching to new protocol; obey Upgrade header

Show help

::

    $ hc -h
    Usage: hc [code] [options]

    code may contain regular expression or use 'x' to denote any digit
    code examples: 418, 30[12], 3.*, 1xx

    Without parameters lists all available
    HTTP status codes and their description


    Options:
      -h, --help            show this help message and exit
      -s SEARCH, --search=SEARCH
                            Search for a code by name or description. Search text
                            may contain regular expressions.

Roadmap
-------

Add more codes


Change History
==============

0.6 (2017-04-03)
----------------
- Use argparse instead of optparse
- Declare as Python 2.7+ and Python 3 compatible

0.5 (2011-12-30)
----------------
- Colorize HTTP codes

0.4 (2011-12-27)
----------------
- regex and 'x' can be used as part of an HTTP code
  https://github.com/rspivak/httpcode/pull/6

0.3 (2011-12-22)
----------------
- Add -s/--search option to search for code by description
  https://github.com/rspivak/httpcode/pull/3

0.2 (2011-12-21)
----------------
- Add HTTP code 418 (I'm a teapot): https://github.com/rspivak/httpcode/pull/2
- Bugfix: https://github.com/rspivak/httpcode/issues/1

0.1 (2011-12-21)
----------------
- Initial release