Class HTTPRequest

source code

object --+
         |
        HTTPRequest

An HTTP Request (and response).

A single HTTP connection may consist of multiple request/response pairs.

server: the Server object which is receiving this request.
conn: the HTTPConnection object on which this request connected.

inheaders: a dict of request headers.
outheaders: a list of header tuples to write in the response.
ready: when True, the request has been parsed and is ready to begin
    generating the response. When False, signals the calling Connection
    that the response should not be generated and the connection should
    close.
close_connection: signals the calling Connection that the request
    should close. This does not imply an error! The client and/or
    server may each request that the connection be closed.
chunked_write: if True, output will be encoded with the "chunked"
    transfer-coding. This value is set automatically inside
    send_headers.

Parse a Request-URI into (scheme, authority, path).

Note that Request-URI's must be one of:
    
    Request-URI    = "*" | absoluteURI | abs_path | authority

Therefore, a Request-URI which starts with a double forward-slash
cannot be a "net_path":

    net_path      = "//" authority [ abs_path ]

Instead, it must be interpreted as an "abs_path" with an empty first
path segment:

    abs_path      = "/"  path_segments
    path_segments = segment *( "/" segment )
    segment       = *pchar *( ";" param )
    param         = *pchar