Sends a GET request. Returns :class:`Response` object. :param url: URL for the new :class:`Request` object. :param \*\*kwargs: Option

Dict-like items() that returns a list of name-value tuples from the jar. See keys() and values(). Allows client-code to call ``dict(Re

D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If key is not found, d is returned if given, otherwise KeyError

od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od

Similar to :meth:`httplib.HTTPResponse.read`, but with two additional parameters: ``decode_content`` and ``cache_content``.

Updates this jar with cookies from another CookieJar or dict-like

Determines appropriate setting for a given request, taking into account the explicit setting on that request, and the setting in the session.

Constructs a :class:`Request <Request>`, prepares it and sends it. Returns :class:`Response <Response>` object. :param method: method

Close all pooled connections and disable the pool.

Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is performed to parse incomplete urls. Fields not provided will be None.

Constructs and sends a :class:`Request <Request>`. :param method: method for the new :class:`Request` object. :param url: URL for the new :cl

Adds a (name, value) pair, doesn't overwrite the value if it already exists. >>> headers = HTTPHeaderDict(foo='bar') >>> head

Returns a CookieJar from a key/value dictionary. :param cookie_dict: Dict of key/values to insert into CookieJar. :param cookiejar: (optional

Extract the cookies from the response into a CookieJar. :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar) :param request:

Dict-like get() that also supports optional domain and path args in order to resolve naming collisions from using one cookie jar over

od.pop(k[,d]) -> v, remove specified key and return the corresponding value. If key is not found, d is returned if given, otherwise KeyError i

od.update(E, **F) -> None. Update od from dict/iterable E and F. If E is a dict instance, does: for k in E: od[k] = E[k] I

Return a copy of this RequestsCookieJar.

Take an object and test to see if it can be represented as a dictionary. If it can be, return a list of tuples, e.g., :: >>> to_key_

Given a string object, regardless of type, returns a representation of that string in the native string type, encoding and decoding where nec

Add documentation to a function.

Returns a Basic Auth string.

Empty our store of pools and direct them all to close. This will not affect in-flight connections, but they will not be re-u

Get a :class:`ConnectionPool` based on the host, port, and scheme. If ``port`` isn't given, it will be derived from the ``scheme`` u

Generic import function for any type of header-like object. Adapted version of MutableMapping.update in order to insert items with sel

Return a new Retry object with incremented retry counters. :param response: A response object, or None, if the server did not re

od.items() -> list of (key, value) pairs in od

Iterate over all header lines, including duplicate ones.

Properly register a hook.

Send a given PreparedRequest.

Establish a socket connection and set nodelay settings on it. :return: New socket connection.

Put a connection back into the pool. :param conn: Connection object for the current host and port as returned by

Check that a timeout attribute is valid. :param value: The timeout value to validate :param name: The name of the timeout attribute

Closes all adapters and as such the session

Make a cookie from underspecified parameters. By default, the pair of `name` and `value` will be set for the domain '' and sent on every requ

Backwards-compatibility for the old retries format.

Given a url with authentication components, extract them into a tuple of username,password.

Should we redirect and where to? :returns: Truthy redirect location string if we got a redirect status code and valid lo

Iterates over the response data. When stream=True is set on the request, this avoids reading the content at once into memory for larg

Prepares the given HTTP cookie data. This function eventually generates a ``Cookie`` header from the given cookies using cookielib. D

Make a request using :meth:`urlopen` with the appropriate encoding of ``fields`` based on the ``method`` used. This is a con

Re-quote the given URI. This function passes the given URI through an unquote/quote cycle to ensure that it is fully and consistently quoted.

Dict-like values() that returns a list of values of cookies from the jar. See keys() and items().

Decode the data passed in and potentially flush the decoder.

Matching according to RFC 6125, section 6.4.3 http://tools.ietf.org/html/rfc6125#section-6.4.3

Encode parameters in a piece of data. Will successfully encode parameters when passed as a dict or a list of 2-tuples. Order is retai

Both ``__get_item__`` and ``get`` call this function: it's never used elsewhere in Requests. Takes as args name and optional domain and

Get a connection. Will return a pooled connection if one is available. If no connections are available and :prop:`.block` is ``False

Helper that always returns a :class:`urllib3.util.Timeout`

Import module, returning the module after the last dot.

Set-up the _decoder attribute if necessar.

Is the error actually a timeout? Will raise a ReadTimeout or pass

Called right before a request is made, after the socket is created.

Create a copy of the timeout object Timeout properties are stored per-pool but each request needs a fresh Timeout object to ensure e

Similar to :func:`urllib3.connectionpool.connection_from_url` but doesn't pass any additional parameters to the :class:`urlli

Retrieve the current time. This function is mocked out in unit testing.

Encode a dictionary of ``fields`` using the multipart/form-data MIME format. :param fields: Dictionary of fields or list of (key, :c

Create a new Timeout from a legacy timeout value. The timeout value used by httplib.py sets the same timeout on the connect(), and r

Given an :class:`httplib.HTTPResponse` instance ``r``, return a corresponding :class:`urllib3.response.HTTPResponse` object.

Gets the time elapsed since the call to :meth:`start_connect`. :return: Elapsed time. :rtype: float :raises urllib3.exceptio

Returns encodings from given HTTP Header Dict. :param headers: dictionary to extract encoding from.

Return a dict of environment proxies.

Deprecated. Use :func:`.parse_url` instead.