11.5 httplib -- HTTP protocol client


This module defines a class which implements the client side of the HTTP protocol. It is normally not used directly -- the module urllib uses it to handle URLs that use HTTP.

The module defines one class, HTTP:

class HTTP([host[, port]])
An HTTP instance represents one transaction with an HTTP server. It should be instantiated passing it a host and optional port number. If no port number is passed, the port is extracted from the host string if it has the form host:port, else the default HTTP port (80) is used. If no host is passed, no connection is made, and the connect() method should be used to connect to a server. For example, the following calls all create instances that connect to the server at the same host and port:

>>> h1 = httplib.HTTP('www.cwi.nl')
>>> h2 = httplib.HTTP('www.cwi.nl:80')
>>> h3 = httplib.HTTP('www.cwi.nl', 80)

Once an HTTP instance has been connected to an HTTP server, it should be used as follows:

Make exactly one call to the putrequest() method.

Make zero or more calls to the putheader() method.

Call the endheaders() method (this can be omitted if step 4 makes no calls).

Optional calls to the send() method.

Call the getreply() method.

Call the getfile() method and read the data off the file object that it returns.

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