pip._vendor.urllib3.connectionpool Namespace Reference

Data Structures
class	ConnectionPool
class	HTTPConnectionPool
class	HTTPSConnectionPool

Functions
	connection_from_url (url, **kw)
	_normalize_host (host, scheme)
	_close_pool_connections (pool)

Variables
	weakref_finalize = weakref.finalize
	xrange = six.moves.xrange
	log = logging.getLogger(__name__)
	_Default = object()
dict	_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}

Function Documentation

_close_pool_connections()

_close_pool_connections (   pool )

protected

Drains a queue of connections and closes each one.

Definition at line 1124 of file connectionpool.py.

def _close_pool_connections(pool):
    """Drains a queue of connections and closes each one."""
    try:
        while True:
            conn = pool.get(block=False)
            if conn:
                conn.close()
    except queue.Empty:
        pass  # Done.

References i.

Referenced by HTTPConnectionPool.close().

Here is the caller graph for this function:

_normalize_host()

_normalize_host (   host,   scheme  )

protected

Normalize hosts for comparisons and use with sockets.

Definition at line 1106 of file connectionpool.py.

def _normalize_host(host, scheme):
    """
    Normalize hosts for comparisons and use with sockets.
    """
 
    host = normalize_host(host, scheme)
 
    # httplib doesn't like it when we include brackets in IPv6 addresses
    # Specifically, if we include brackets but also pass the port then
    # httplib crazily doubles up the square brackets on the Host header.
    # Instead, we need to make sure we never pass ``None`` as the port.
    # However, for backward compatibility reasons we can't actually
    # *assert* that.  See http://bugs.python.org/issue28539
    if host.startswith("[") and host.endswith("]"):
        host = host[1:-1]
    return host
 
 

References i.

connection_from_url()

connection_from_url	(		url,
		**	kw
	)

Given a url, return an :class:`.ConnectionPool` instance of its host.

This is a shortcut for not having to parse out the scheme, host, and port
of the url before creating an :class:`.ConnectionPool` instance.

:param url:
    Absolute URL string that must include the scheme. Port is optional.

:param \\**kw:
    Passes additional parameters to the constructor of the appropriate
    :class:`.ConnectionPool`. Useful for specifying things like
    timeout, maxsize, headers, etc.

Example::

    >>> conn = connection_from_url('http://google.com/')
    >>> r = conn.request('GET', '/')

Definition at line 1078 of file connectionpool.py.

def connection_from_url(url, **kw):
    """
    Given a url, return an :class:`.ConnectionPool` instance of its host.
 
    This is a shortcut for not having to parse out the scheme, host, and port
    of the url before creating an :class:`.ConnectionPool` instance.
 
    :param url:
        Absolute URL string that must include the scheme. Port is optional.
 
    :param \\**kw:
        Passes additional parameters to the constructor of the appropriate
        :class:`.ConnectionPool`. Useful for specifying things like
        timeout, maxsize, headers, etc.
 
    Example::
 
        >>> conn = connection_from_url('http://google.com/')
        >>> r = conn.request('GET', '/')
    """
    scheme, host, port = get_host(url)
    port = port or port_by_scheme.get(scheme, 80)
    if scheme == "https":
        return HTTPSConnectionPool(host, port=port, **kw)
    else:
        return HTTPConnectionPool(host, port=port, **kw)
 
 

References i.

Variable Documentation

_blocking_errnos

dict _blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}

protected

Definition at line 109 of file connectionpool.py.

_Default

_Default = object()

protected

Definition at line 64 of file connectionpool.py.

log

log = logging.getLogger(__name__)

Definition at line 62 of file connectionpool.py.

weakref_finalize

weakref_finalize = weakref.finalize

Definition at line 56 of file connectionpool.py.

xrange

xrange = six.moves.xrange

Definition at line 60 of file connectionpool.py.