t.w.c.Agent(object) : class documentation

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

Agent is a very basic HTTP client. It supports HTTP and HTTPS scheme URIs (but performs no certificate checking by default). It does not support persistent connections.
Instance Variables_reactorThe IReactorTCP and IReactorSSL implementation which will be used to set up connections over which to issue requests.
_contextFactoryA web context factory which will be used to create SSL context objects for any SSL connections the agent needs to make.
Present Since9.0
Method __init__ Undocumented
Method request Issue a new request.
Method _wrapContextFactory Create and return a normal context factory wrapped around self._contextFactory in such a way that self._contextFactory will have the host and port information passed to it.
Method _connect Connect to the given host and port, using a transport selected based on scheme.
Method _computeHostValue Compute the string to use for the value of the Host header, based on the given scheme, host name, and port number.
def __init__(self, reactor, contextFactory=WebClientContextFactory()): (source)
Undocumented
def _wrapContextFactory(self, host, port): (source)
Create and return a normal context factory wrapped around self._contextFactory in such a way that self._contextFactory will have the host and port information passed to it.
ParametershostA str giving the hostname which will be connected to in order to issue a request.
portAn int giving the port number the connection will be on.
ReturnsA context factory suitable to be passed to reactor.connectSSL.
def _connect(self, scheme, host, port): (source)
Connect to the given host and port, using a transport selected based on scheme.
ParametersschemeA string like 'http' or 'https' (the only two supported values) to use to determine how to establish the connection.
hostA str giving the hostname which will be connected to in order to issue a request.
portAn int giving the port number the connection will be on.
ReturnsA Deferred which fires with a connected instance of self._protocol.
def request(self, method, uri, headers=None, bodyProducer=None): (source)
Issue a new request.
ParametersmethodThe request method to send. (type: str )
uriThe request URI send. (type: str )
headersThe request headers to send. If no Host header is included, one will be added based on the request URI. (type: Headers )
bodyProducerAn object which will produce the request body or, if the request body is to be empty, None. (type: IBodyProducer provider )
ReturnsA Deferred which fires with the result of the request (a Response instance), or fails if there is a problem setting up a connection over which to issue the request. It may also fail with SchemeNotSupported if the scheme of the given URI is not supported. (type: Deferred )
def _computeHostValue(self, scheme, host, port): (source)
Compute the string to use for the value of the Host header, based on the given scheme, host name, and port number.
API Documentation for Twisted, generated by pydoctor at 2011-10-27 16:17:34.