twisted.web.client.Agent : API documentation

Agent is a very basic HTTP client. It supports HTTP and HTTPS scheme URIs (but performs no certificate checking by default).

Parameters	pool	A `HTTPConnectionPool` instance, or `None`, in which case a non-persistent `HTTPConnectionPool` instance will be created.
Present Since	9.0

Method	__init__	Undocumented
Method	request	Issue a request to the server indicated by the given `uri`.
Instance Variable	_contextFactory	A web context factory which will be used to create SSL context objects for any SSL connections the agent needs to make.
Instance Variable	_connectTimeout	If not `None`, the timeout passed to `connectTCP` or `connectSSL` for specifying the connection timeout.
Instance Variable	_bindAddress	If not `None`, the address passed to `connectTCP` or `connectSSL` for specifying the local address to bind to.
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	_getEndpoint	Get an endpoint for the given host and port, using a transport selected based on scheme.

Inherited from _AgentBase:

Instance Variable	_reactor	The `IReactorTime` implementation which will be used by the pool, and perhaps by subclasses as well.
Instance Variable	_pool	The `HTTPConnectionPool` used to manage HTTP connections.
Method	_computeHostValue	Compute the string to use for the value of the Host header, based on the given scheme, host name, and port number.
Method	_requestWithEndpoint	Issue a new request, given the endpoint and the path sent as part of the request.

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.

Parameters	host	A `str` giving the hostname which will be connected to in order to issue a request.
	port	An `int` giving the port number the connection will be on.
Returns	A context factory suitable to be passed to `reactor.connectSSL`.

def _getEndpoint(self, scheme, host, port): (source)

Get an endpoint for the given host and port, using a transport selected based on scheme.

Parameters	scheme	A string like `'http'` or `'https'` (the only two supported values) to use to determine how to establish the connection.
	host	A `str` giving the hostname which will be connected to in order to issue a request.
	port	An `int` giving the port number the connection will be on.
Returns	An endpoint which can be used to connect to given address.

def request(self, method, uri, headers=None, bodyProducer=None): (source)

Issue a request to the server indicated by the given uri.

An existing connection from the connection pool may be used or a new one may be created.

HTTP and HTTPS schemes are supported in uri.

See Also twisted.web.iweb.IAgent.request

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