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).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. |
None
, the timeout passed to connectTCP
or
connectSSL
for specifying the connection timeout.
None
, the address passed to connectTCP
or
connectSSL
for specifying the local address to bind to.
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 . |
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. |
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 |