11.6.1 HTTPConnection Objects

HTTPConnection instances have the following methods:

request( method, url[, body[, headers]]): This will send a request to the server using the HTTP request method method and the selector url. If the body argument is present, it should be a string of data to send after the headers are finished. The header Content-Length is automatically set to the correct value. The headers argument should be a mapping of extra HTTP headers to send with the request.

getresponse( ): Should be called after a request is sent to get the response from the server. Returns an HTTPResponse instance.

set_debuglevel( level): Set the debugging level (the amount of debugging output printed). The default debug level is 0, meaning no debugging output is printed.

send( data): Send data to the server. This should be used directly only after the endheaders() method has been called and before getreply() has been called.

putrequest( request, selector[, skip_host[, skip_accept_encoding]]): This should be the first call after the connection to the server has been made. It sends a line to the server consisting of the request string, the selector string, and the HTTP version (HTTP/1.1). To disable automatic sending of Host: or Accept-Encoding: headers (for example to accept additional content encodings), specify skip_host or skip_accept_encoding with non-False values. Changed in version 2.4: skip_accept_encoding argument added.

putheader( header, argument[, ...]): Send an RFC 822-style header to the server. It sends a line to the server consisting of the header, a colon and a space, and the first argument. If more arguments are given, continuation lines are sent, each consisting of a tab and an argument.

endheaders( ): Send a blank line to the server, signalling the end of the headers.

See About this document... for information on suggesting changes.