twisted.web.client.Response class documentation

Part of twisted.web.client (View In Hierarchy)

Implements interfaces: twisted.web.iweb.IResponse

A Response instance describes an HTTP response received from an HTTP server.

Response should not be subclassed or instantiated.

Method __init__
Method setPreviousResponse Set the reference to the previous IResponse.
Method deliverBody Dispatch the given IProtocol depending of the current state of the response.
Instance Variable _transport See __init__.
Instance Variable _bodyProtocol The IProtocol provider to which the body is delivered. None before one has been registered with deliverBody.
Instance Variable _bodyBuffer A list of the strings passed to bodyDataReceived before deliverBody is called. None afterwards.
Instance Variable _state Indicates what state this Response instance is in, particularly with respect to delivering bytes from the response body to an application-supplied protocol object. This may be one of 'INITIAL', 'CONNECTED', 'DEFERRED_CLOSE', or 'FINISHED', with the following meanings:
  • INITIAL: This is the state Response objects start in. No protocol has yet been provided and the underlying transport may still have bytes to deliver to it.
  • DEFERRED_CLOSE: If the underlying transport indicates all bytes have been delivered but no application-provided protocol is yet available, the Response moves to this state. Data is buffered and waiting for a protocol to be delivered to.
  • CONNECTED: If a protocol is provided when the state is INITIAL, the Response moves to this state. Any buffered data is delivered and any data which arrives from the transport subsequently is given directly to the protocol.
  • FINISHED: If a protocol is provided in the DEFERRED_CLOSE state, the Response moves to this state after delivering all buffered data to the protocol. Otherwise, if the Response is in the CONNECTED state, if the transport indicates there is no more data, the Response moves to this state. Nothing else can happen once the Response is in this state.
(type: str)
Class Method _construct Private constructor.
Method _deliverBody_INITIAL Deliver any buffered data to protocol and prepare to deliver any future data to it. Move to the 'CONNECTED' state.
Method _deliverBody_CONNECTED It is invalid to attempt to deliver data to a protocol when it is already being delivered to another protocol.
Method _deliverBody_DEFERRED_CLOSE Deliver any buffered data to protocol and then disconnect the protocol. Move to the 'FINISHED' state.
Method _deliverBody_FINISHED It is invalid to attempt to deliver data to a protocol after the response body has been delivered to another protocol.
Method _bodyDataReceived Called by HTTPClientParser with chunks of data from the response body. They will be buffered or delivered to the protocol passed to deliverBody.
Method _bodyDataReceived_INITIAL Buffer any data received for later delivery to a protocol passed to deliverBody.
Method _bodyDataReceived_CONNECTED Deliver any data received to the protocol to which this Response is connected.
Method _bodyDataReceived_DEFERRED_CLOSE It is invalid for data to be delivered after it has been indicated that the response body has been completely delivered.
Method _bodyDataReceived_FINISHED It is invalid for data to be delivered after the response body has been delivered to a protocol.
Method _bodyDataFinished Called by HTTPClientParser when no more body data is available. If the optional reason is supplied, this indicates a problem or potential problem receiving all of the response body.
Method _bodyDataFinished_INITIAL Move to the 'DEFERRED_CLOSE' state to wait for a protocol to which to deliver the response body.
Method _bodyDataFinished_CONNECTED Disconnect the protocol and move to the 'FINISHED' state.
Method _bodyDataFinished_DEFERRED_CLOSE It is invalid to attempt to notify the Response of the end of the response body data more than once.
Method _bodyDataFinished_FINISHED It is invalid to attempt to notify the Response of the end of the response body data more than once.
_transport =
See __init__.
_bodyProtocol =
The IProtocol provider to which the body is delivered. None before one has been registered with deliverBody.
_bodyBuffer =
A list of the strings passed to bodyDataReceived before deliverBody is called. None afterwards.
_state =
Indicates what state this Response instance is in, particularly with respect to delivering bytes from the response body to an application-supplied protocol object. This may be one of 'INITIAL', 'CONNECTED', 'DEFERRED_CLOSE', or 'FINISHED', with the following meanings:
  • INITIAL: This is the state Response objects start in. No protocol has yet been provided and the underlying transport may still have bytes to deliver to it.
  • DEFERRED_CLOSE: If the underlying transport indicates all bytes have been delivered but no application-provided protocol is yet available, the Response moves to this state. Data is buffered and waiting for a protocol to be delivered to.
  • CONNECTED: If a protocol is provided when the state is INITIAL, the Response moves to this state. Any buffered data is delivered and any data which arrives from the transport subsequently is given directly to the protocol.
  • FINISHED: If a protocol is provided in the DEFERRED_CLOSE state, the Response moves to this state after delivering all buffered data to the protocol. Otherwise, if the Response is in the CONNECTED state, if the transport indicates there is no more data, the Response moves to this state. Nothing else can happen once the Response is in this state.
(type: str)
def __init__(self, version, code, phrase, headers, _transport):
ParametersversionHTTP version components protocol, major, minor. E.g. (b'HTTP', 1, 1) to mean b'HTTP/1.1'.
codeHTTP status code. (type: int)
phraseHTTP reason phrase, intended to give a short description of the HTTP status code.
headersHTTP response headers. (type: twisted.web.http_headers.Headers)
_transportThe transport which is delivering this response.
@classmethod
def _construct(cls, version, code, phrase, headers, _transport, request):

Private constructor.

ParametersversionSee __init__.
codeSee __init__.
phraseSee __init__.
headersSee __init__.
_transportSee __init__.
requestSee IResponse.request.
ReturnsResponse instance.
def setPreviousResponse(self, previousResponse):
from twisted.web.iweb.IResponse

Set the reference to the previous IResponse.

The value of the previous response can be read via IResponse.previousResponse.

def deliverBody(self, protocol):
from twisted.web.iweb.IResponse

Dispatch the given IProtocol depending of the current state of the response.

def _deliverBody_INITIAL(self, protocol):

Deliver any buffered data to protocol and prepare to deliver any future data to it. Move to the 'CONNECTED' state.

def _deliverBody_CONNECTED(self, protocol):

It is invalid to attempt to deliver data to a protocol when it is already being delivered to another protocol.

def _deliverBody_DEFERRED_CLOSE(self, protocol):

Deliver any buffered data to protocol and then disconnect the protocol. Move to the 'FINISHED' state.

def _deliverBody_FINISHED(self, protocol):

It is invalid to attempt to deliver data to a protocol after the response body has been delivered to another protocol.

def _bodyDataReceived(self, data):

Called by HTTPClientParser with chunks of data from the response body. They will be buffered or delivered to the protocol passed to deliverBody.

def _bodyDataReceived_INITIAL(self, data):

Buffer any data received for later delivery to a protocol passed to deliverBody.

Little or no data should be buffered by this method, since the transport has been paused and will not be resumed until a protocol is supplied.

def _bodyDataReceived_CONNECTED(self, data):

Deliver any data received to the protocol to which this Response is connected.

def _bodyDataReceived_DEFERRED_CLOSE(self, data):

It is invalid for data to be delivered after it has been indicated that the response body has been completely delivered.

def _bodyDataReceived_FINISHED(self, data):

It is invalid for data to be delivered after the response body has been delivered to a protocol.

def _bodyDataFinished(self, reason=None):

Called by HTTPClientParser when no more body data is available. If the optional reason is supplied, this indicates a problem or potential problem receiving all of the response body.

def _bodyDataFinished_INITIAL(self, reason=None):

Move to the 'DEFERRED_CLOSE' state to wait for a protocol to which to deliver the response body.

def _bodyDataFinished_CONNECTED(self, reason=None):

Disconnect the protocol and move to the 'FINISHED' state.

def _bodyDataFinished_DEFERRED_CLOSE(self):

It is invalid to attempt to notify the Response of the end of the response body data more than once.

def _bodyDataFinished_FINISHED(self):

It is invalid to attempt to notify the Response of the end of the response body data more than once.

API Documentation for twisted, generated by pydoctor at 2020-03-25 17:34:30.