twisted.web.clientView Source (View In Hierarchy)
Known subclasses: twisted.web.client.HTTPDownloader
Download a given URL.
|Instance Variable||deferred||A Deferred that will fire when the content has been retrieved. Once this is fired, the ivars `status', `version', and `message' will be set. (type: Deferred)|
|Instance Variable||status||The status of the response. (type: bytes)|
|Instance Variable||version||The version of the response. (type: bytes)|
|Instance Variable||message||The text message returned with the status. (type: bytes)|
|Instance Variable||response_headers||The headers that were specified in the response from the server. (type: dict)|
|Instance Variable||method||The HTTP method to use in the request. This should be one of OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, or CONNECT (case matters). Other values may be specified if the server being contacted supports them. (type: bytes)|
|Instance Variable||redirectLimit||The maximum number of HTTP redirects that can occur before it is assumed that the redirection is endless. (type: int)|
|Instance Variable||afterFoundGet||Deviate from the HTTP 1.1 RFC by handling redirects the same way as most
web browsers; if the request method is POST and a 302 status is
encountered, the redirect is followed with a GET method (type:
|Method||buildProtocol||Create an instance of a subclass of Protocol.|
|Method||gotHeaders||Parse the response HTTP headers.|
|Method||gotStatus||Set the status of the request on us.|
|Method||clientConnectionFailed||When a connection attempt fails, the request cannot be issued. If no result has yet been provided to the result Deferred, provide the connection failure reason as an error result.|
|Instance Variable||_redirectCount||The current number of HTTP redirects encountered. (type: int)|
|Method||_waitForDisconnect||Chain onto the _disconnectedDeferred, preserving
Inherited from ClientFactory:
|Method||startedConnecting||Called when a connection has been started.|
|Method||clientConnectionLost||Called when an established connection is lost.|
|Class Method||forProtocol||Create a factory for the given protocol.|
|Method||logPrefix||Describe this factory for log messages.|
|Method||doStart||Make sure startFactory is called.|
|Method||doStop||Make sure stopFactory is called.|
|Method||startFactory||This will be called before I begin listening on a Port or Connector.|
|Method||stopFactory||This will be called before I stop listening on all Ports/Connectors.|
Deferredwhich only fires after the last connection associated with the request (redirects may cause multiple connections to be required) has closed. The result Deferred will only fire after this Deferred, so that callers can be assured that there are no more event sources in the reactor once they get the result.
Chain onto the _disconnectedDeferred, preserving
passthrough, so that the result is only available after the
associated connection has been closed.
Create an instance of a subclass of Protocol.
The returned instance will handle input on an incoming server connection, and an attribute "factory" pointing to the creating factory.
may be returned to immediately close the new connection.
Override this method to alter how Protocol instances get created.
|Parameters||addr||an object implementing |
When a connection attempt fails, the request cannot be issued. If no result has yet been provided to the result Deferred, provide the connection failure reason as an error result.