t.w.h.HTTPClient(basic.LineReceiver) : class documentation

Part of twisted.web.http View Source View In Hierarchy

Known subclasses: twisted.protocols.shoutcast.ShoutcastClient, twisted.web.client.HTTPPageGetter, twisted.web.google.GoogleChecker, twisted.web.proxy.ProxyClient, twisted.web.xmlrpc.QueryProtocol, twisted.words.protocols.msn.PassportLogin, twisted.words.protocols.msn.PassportNexus

A client for HTTP 1.0.

Notes: You probably want to send a 'Host' header with the name of the site you're connecting to, in order to not break name based virtual hosting.
Instance VariableslengthThe length of the request body in bytes. (type: int )
firstLineAre we waiting for the first header line? (type: bool )
__bufferThe buffer that stores the response to the HTTP request. (type: A StringIO object. )
_headerPart or all of an HTTP request header. (type: str )
Method sendCommand Undocumented
Method sendHeader Undocumented
Method endHeaders Undocumented
Method extractHeader Given a complete HTTP header, extract the field name and value and process the header.
Method lineReceived Parse the status line and headers for an HTTP request.
Method connectionLost Called when the connection is shut down.
Method handleResponseEnd The response has been completely received.
Method handleResponsePart Undocumented
Method connectionMade Called when a connection is made.
Method handleStatus Called when the status-line is received.
Method handleHeader Called every time a header is received.
Method handleEndHeaders Called when all headers have been received.
Method rawDataReceived Override this for when raw data is received.

Inherited from LineReceiver:

Method clearLineBuffer Clear buffered data.
Method dataReceived Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)
Method setLineMode Sets the line-mode of this receiver.
Method setRawMode Sets the raw mode of this receiver. Further data received will be sent to rawDataReceived rather than lineReceived.
Method sendLine Sends a line to the other end of the connection.
Method lineLengthExceeded Called when the maximum line length has been reached. Override if it needs to be dealt with in some special way.

Inherited from BaseProtocol (via LineReceiver, Protocol):

Method makeConnection Make a connection to a transport and a server.

Inherited from _PauseableMixin (via LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented
def sendCommand(self, command, path): (source)
Undocumented
def sendHeader(self, name, value): (source)
Undocumented
def endHeaders(self): (source)
Undocumented
def extractHeader(self, header): (source)
Given a complete HTTP header, extract the field name and value and process the header.
Parametersheadera complete HTTP request header of the form 'field-name: value'. (type: str )
def lineReceived(self, line): (source)
Parse the status line and headers for an HTTP request.
ParameterslinePart of an HTTP request header. Request bodies are parsed in rawDataReceived. (type: str )
def connectionLost(self, reason): (source)

Called when the connection is shut down.

Clear any circular references here, and any external references to this Protocol. The connection has been closed.
Parametersreason (type: twisted.python.failure.Failure )
def handleResponseEnd(self): (source)

The response has been completely received.

This callback may be invoked more than once per request.
def handleResponsePart(self, data): (source)
Undocumented
def connectionMade(self): (source)

Called when a connection is made.

This may be considered the initializer of the protocol, because it is called when the connection is completed. For clients, this is called once the connection to the server has been established; for servers, this is called after an accept() call stops blocking and a socket has been received. If you need to send any greeting or initial message, do it here.
def handleStatus(self, version, status, message): (source)
Called when the status-line is received.
Parametersversione.g. 'HTTP/1.0'
statuse.g. '200' (type: str )
messagee.g. 'OK'
def handleHeader(self, key, val): (source)
Called every time a header is received.
def handleEndHeaders(self): (source)
Called when all headers have been received.
def rawDataReceived(self, data): (source)
Override this for when raw data is received.
API Documentation for Twisted, generated by pydoctor at 2011-10-27 16:17:34.