twisted.web._newclient.HTTPParser(LineReceiver) class documentation

Part of twisted.web._newclient View Source (View In Hierarchy)

Known subclasses: twisted.web._newclient.HTTPClientParser

HTTPParser handles the parsing side of HTTP processing. With a suitable subclass, it can parse either the client side or the server side of the connection.

Instance Variable headers All of the non-connection control message headers yet received.
Instance Variable state State indicator for the response parsing state machine. One of STATUS, HEADER, BODY, DONE.
Method connectionMade Called when a connection is made.
Method switchToBodyMode Switch to body parsing mode - interpret any more bytes delivered as part of the message body and deliver them to the given decoder.
Method lineReceived Handle one line from a response.
Method rawDataReceived Pass data from the message body to the body decoder object.
Method isConnectionControlHeader Return True if the given lower-cased name is the name of a connection control header (rather than an entity header).
Method statusReceived Callback invoked whenever the first line of a new message is received. Override this.
Method headerReceived Store the given header in self.headers.
Method allHeadersReceived Callback invoked after the last header is passed to headerReceived. Override this to change to the BODY or DONE state.
Instance Variable _partialHeader None or a list of the lines of a multiline header while that header is being received.

Inherited from _PauseableMixin (via LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented

Inherited from _PauseableMixin (via LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented

Inherited from _PauseableMixin (via LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented

Inherited from _PauseableMixin (via LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented
headers =
All of the non-connection control message headers yet received.
state =
State indicator for the response parsing state machine. One of STATUS, HEADER, BODY, DONE.
_partialHeader =
None or a list of the lines of a multiline header while that header is being received.
def connectionMade(self): (source)
from twisted.internet.interfaces.IProtocol
overrides twisted.internet.protocol.BaseProtocol.connectionMade

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 switchToBodyMode(self, decoder): (source)

Switch to body parsing mode - interpret any more bytes delivered as part of the message body and deliver them to the given decoder.

def lineReceived(self, line): (source)
overrides twisted.protocols.basic.LineReceiver.lineReceived

Handle one line from a response.

def rawDataReceived(self, data): (source)
overrides twisted.protocols.basic.LineReceiver.rawDataReceived

Pass data from the message body to the body decoder object.

def isConnectionControlHeader(self, name): (source)
overridden in twisted.web._newclient.HTTPClientParser

Return True if the given lower-cased name is the name of a connection control header (rather than an entity header).

According to RFC 2616, section 14.10, the tokens in the Connection header are probably relevant here. However, I am not sure what the practical consequences of either implementing or ignoring that are. So I leave it unimplemented for the time being.

def statusReceived(self, status): (source)
overridden in twisted.web._newclient.HTTPClientParser

Callback invoked whenever the first line of a new message is received. Override this.

ParametersstatusThe first line of an HTTP request or response message without trailing CR LF. (type: bytes)
def headerReceived(self, name, value): (source)

Store the given header in self.headers.

def allHeadersReceived(self): (source)
overridden in twisted.web._newclient.HTTPClientParser

Callback invoked after the last header is passed to headerReceived. Override this to change to the BODY or DONE state.

API Documentation for Twisted, generated by pydoctor at 2017-06-11 10:59:01.