twisted.web.client.RedirectAgent

class documentation

class RedirectAgent: (source)

Known subclasses: twisted.web.client.BrowserLikeRedirectAgent

Implements interfaces: twisted.web.iweb.IAgent

View In Hierarchy

An Agent wrapper which handles HTTP redirects.

The implementation is rather strict: 301 and 302 behaves like 307, not redirecting automatically on methods different from GET and HEAD.

See BrowserLikeRedirectAgent for a redirecting Agent that behaves more like a web browser.

Parameters
redirect​LimitThe maximum number of times the agent is allowed to follow redirects before failing with a error.InfiniteRedirection.
Present Since
11.1
Method __init__ Undocumented
Method request Send a client request following HTTP redirects.
Method _handle​Redirect Handle a redirect response, checking the number of redirects already followed, and extracting the location header fields.
Method _handle​Response Handle the response, making another request if it indicates a redirect.
Method _resolve​Location Resolve the redirect location against the request URI.
Class Variable _redirect​Responses A list of HTTP status codes to be redirected for GET and HEAD methods.
Class Variable _see​Other​Responses A list of HTTP status codes to be redirected for any method and the method altered to GET.
Instance Variable _agent Undocumented
Instance Variable _redirect​Limit Undocumented
def __init__(self, agent, redirectLimit=20): (source)

Undocumented

def request(self, method, uri, headers=None, bodyProducer=None): (source)
from twisted.web.iweb.IAgent
Send a client request following HTTP redirects.
See Also
Agent.request.
def _handleRedirect(self, response, method, uri, headers, redirectCount): (source)
Handle a redirect response, checking the number of redirects already followed, and extracting the location header fields.
def _handleResponse(self, response, method, uri, headers, redirectCount): (source)
Handle the response, making another request if it indicates a redirect.
def _resolveLocation(self, requestURI, location): (source)
Resolve the redirect location against the request URI.
Parameters
request​URI:bytesThe request URI.
location:bytesThe redirect location.
Returns
bytesFinal resolved URI.
_redirectResponses = (source)
overridden in twisted.web.client.BrowserLikeRedirectAgent
A list of HTTP status codes to be redirected for GET and HEAD methods.
_seeOtherResponses = (source)
overridden in twisted.web.client.BrowserLikeRedirectAgent
A list of HTTP status codes to be redirected for any method and the method altered to GET.
_agent = (source)

Undocumented

_redirectLimit = (source)

Undocumented