twisted.web._newclient.HTTPParser : API documentation

class documentation

class twisted.web._newclient.HTTPParser(LineReceiver): (source)

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`.
Class Variable	delimiter	Undocumented
Class Variable	CONNECTION_CONTROL_HEADERS	Undocumented
Method	connectionMade	Called when a connection is made.
Instance Variable	connHeaders	Undocumented
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.
Instance Variable	bodyDecoder	Undocumented
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 LineReceiver:

Class Variable	MAX_LENGTH	The maximum length of a line to allow (If a sent line is longer than this, the connection is dropped). Default is 16384.
Instance Variable	line_mode	Undocumented
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.
Instance Variable	_buffer	Undocumented
Instance Variable	_busyReceiving	Undocumented

Inherited from Protocol (via LineReceiver):

Class Variable	factory	Undocumented
Method	logPrefix	Return a prefix matching the class name, to identify log messages related to this protocol instance.
Method	connectionLost	Called when the connection is shut down.

Inherited from BaseProtocol (via LineReceiver, Protocol):

Instance Variable	connected	Undocumented
Instance Variable	transport	Undocumented
Method	makeConnection	Make a connection to a transport and a server.

Inherited from _PauseableMixin (via LineReceiver):

Instance Variable	paused	Undocumented
Method	pauseProducing	Undocumented
Method	resumeProducing	Undocumented
Method	stopProducing	Undocumented

headers = (source)

All of the non-connection control message headers yet received.

state = (source)

overridden in twisted.web._newclient.HTTPClientParser

State indicator for the response parsing state machine. One of STATUS, HEADER, BODY, DONE.

_partialHeader = (source)

None or a list of the lines of a multiline header while that header is being received.

delimiter = (source)

overrides twisted.protocols.basic.LineReceiver.delimiter

Undocumented

(type: bytes)

CONNECTION_CONTROL_HEADERS = (source)

Undocumented

(type: set[bytes])

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.

connHeaders = (source)

Undocumented

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.

bodyDecoder = (source)

overridden in twisted.web._newclient.HTTPClientParser

Undocumented

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.

Parameters status The 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 20.12.1 at 2021-02-28 19:53:36.