3
nNj @ s d dl mZ d dlZd dlZd dlZd dlZd dlmZm Z
d dlZddl m Z m
Z
mZmZmZmZmZmZmZmZmZmZmZ ddlmZ ddlm Z ddl m Z dd l m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z& dd
l'm(Z( dd l)m*Z* dd l+m,Z, dd
l-m.Z. ddl/m0Z0 ddl1m2Z2 ddl3m4Z4 ddl5m6Z6 ddl7m8Z8m9Z9m:Z: ddl;mZ>ej?e@ZAeB ZCG dd deBZDejEejFhZGG dd deDe*ZHG dd deHZIdd ZJd d ZKdS ) )absolute_importN)errortimeout )
ClosedPoolError
ProtocolErrorEmptyPoolErrorHeaderParsingErrorHostChangedErrorLocationValueError
MaxRetryError
ProxyErrorReadTimeoutErrorSSLError TimeoutErrorInsecureRequestWarningNewConnectionError)CertificateError)six)queue)port_by_schemeDummyConnectionHTTPConnectionHTTPSConnectionVerifiedHTTPSConnection
HTTPException BaseSSLError)HTTPHeaderDict)RequestMethods) HTTPResponse)is_connection_dropped)set_file_position)assert_header_parsing)Retry)Timeout)get_hostUrlNORMALIZABLE_SCHEMES) LifoQueuec @ sB e Zd ZdZdZeZd
ddZdd Zdd Z d d
Z
d d Z dS )ConnectionPoolzz
Base class for all connection pools, such as
:class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
Nc C s. |s t dt|| j| _|j | _|| _d S )NzNo host specified.)r
_ipv6_hostschemehostlower _proxy_hostport)selfr, r/ r1 $/usr/lib/python3.6/connectionpool.py__init__A s
zConnectionPool.__init__c C s dt | j| j| jf S )Nz%s(host=%r, port=%r))type__name__r, r/ )r0 r1 r1 r2 __str__I s
zConnectionPool.__str__c C s | S )Nr1 )r0 r1 r1 r2 __enter__M s zConnectionPool.__enter__c C s | j dS )NF)close)r0 exc_typeZexc_valZexc_tbr1 r1 r2 __exit__P s zConnectionPool.__exit__c C s dS )zD
Close all pooled connections and disable the pool.
Nr1 )r0 r1 r1 r2 r8 U s zConnectionPool.close)N) r5
__module__ __qualname____doc__r+ r( QueueClsr3 r6 r7 r: r8 r1 r1 r1 r2 r) 8 s
r) c
@ s e Zd ZdZdZeZeZdde j
ddddddf ddZ dd Z d!d
d Z
d d
Zdd Zdd Zdd Zdd ZedfddZdd Zdd Zd d Zdddd d eddddf
d d ZdS )"HTTPConnectionPoolaN
Thread-safe connection pool for one host.
:param host:
Host used for this HTTP Connection (e.g. "localhost"), passed into
:class:`httplib.HTTPConnection`.
:param port:
Port used for this HTTP Connection (None is equivalent to 80), passed
into :class:`httplib.HTTPConnection`.
:param strict:
Causes BadStatusLine to be raised if the status line can't be parsed
as a valid HTTP/1.0 or 1.1 status line, passed into
:class:`httplib.HTTPConnection`.
.. note::
Only works in Python 2. This parameter is ignored in Python 3.
:param timeout:
Socket timeout in seconds for each individual connection. This can
be a float or integer, which sets the timeout for the HTTP request,
or an instance of :class:`urllib3.util.Timeout` which gives you more
fine-grained control over request timeouts. After the constructor has
been parsed, this is always a `urllib3.util.Timeout` object.
:param maxsize:
Number of connections to save that can be reused. More than 1 is useful
in multithreaded situations. If ``block`` is set to False, more
connections will be created but they will not be saved once they've
been used.
:param block:
If set to True, no more than ``maxsize`` connections will be used at
a time. When no free connections are available, the call will block
until a connection has been released. This is a useful side effect for
particular multithreaded situations where one does not want to use more
than maxsize connections per host to prevent flooding.
:param headers:
Headers to include with all requests, unless other headers are given
explicitly.
:param retries:
Retry configuration to use by default with requests in this pool.
:param _proxy:
Parsed proxy URL, should not be used directly, instead, see
:class:`urllib3.connectionpool.ProxyManager`"
:param _proxy_headers:
A dictionary with proxy headers, should not be used directly,
instead, see :class:`urllib3.connectionpool.ProxyManager`"
:param \**conn_kw:
Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
:class:`urllib3.connection.HTTPSConnection` instances.
httpNFr c
K s t j| || tj| | || _t|ts4tj|}|d krBtj}|| _ || _
| j || _ || _
| | _|
pli | _x t|D ]} | j jd qzW d| _d| _| | _| jr| jjdg d S )Nr Zsocket_options)r) r3 r strict
isinstancer$
from_floatr# ZDEFAULTr retriesr> poolblockproxy
proxy_headersxrangeputnum_connections num_requestsconn_kw
setdefault)
r0 r, r/ rA r maxsizerF headersrD _proxy_proxy_headersrM _r1 r1 r2 r3 s(
zHTTPConnectionPool.__init__c C sR | j d7 _ tjd| j | j| jp$d | jf | j| j| jj| jd| j }|S )z9
Return a fresh :class:`HTTPConnection`.
r z(Starting new HTTP connection (%d): %s:%sZ80)r, r/ r rA )
rK logdebugr, r/
ConnectionClsr connect_timeoutrA rM )r0 connr1 r1 r2 _new_conn s z HTTPConnectionPool._new_connc C s d}y| j j| j|d}W nB tk
r8 t| dY n& tjk
r\ | jrXt| dY nX |rt|rt j
d| j |j t
|dddkrd}|p| j S ) a
Get a connection. Will return a pooled connection if one is available.
If no connections are available and :prop:`.block` is ``False``, then a
fresh connection is returned.
:param timeout:
Seconds to wait before giving up and raising
:class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
:prop:`.block` is ``True``.
N)rF r zPool is closed.z>Pool reached maximum size and no more connections are allowed.z Resetting dropped connection: %sZ auto_openr r )rE getrF AttributeErrorr r Emptyr r rT rU r, r8 getattrrY )r0 r rX r1 r1 r2 _get_conn s z HTTPConnectionPool._get_connc C s\ y| j j|dd dS tk
r( Y n$ tjk
rJ tjd| j Y nX |rX|j dS )a
Put a connection back into the pool.
:param conn:
Connection object for the current host and port as returned by
:meth:`._new_conn` or :meth:`._get_conn`.
If the pool is already full, the connection is closed and discarded
because we exceeded maxsize. If connections are discarded frequently,
then maxsize should be increased.
If the pool is closed, then the connection will be closed and discarded.
F)rF Nz2Connection pool is full, discarding connection: %s) rE rJ r[ r ZFullrT warningr, r8 )r0 rX r1 r1 r2 _put_conn s z HTTPConnectionPool._put_connc C s dS )zU
Called right before a request is made, after the socket is created.
Nr1 )r0 rX r1 r1 r2 _validate_conn s z!HTTPConnectionPool._validate_connc C s d S )Nr1 )r0 rX r1 r1 r2 _prepare_proxy s z!HTTPConnectionPool._prepare_proxyc C s2 |t kr| jj S t|tr$|j S tj|S dS )z< Helper that always returns a :class:`urllib3.util.Timeout` N)_Defaultr ZclonerB r$ rC )r0 r r1 r1 r2 _get_timeout# s
z HTTPConnectionPool._get_timeoutc C sj t |trt| |d| t|dr>|jtkr>t| |d| dt|ksVdt|krft| |d| dS )zAIs the error actually a timeout? Will raise a ReadTimeout or passz!Read timed out. (read timeout=%s)errnoz timed outzdid not complete (read)N)rB
SocketTimeoutr hasattrre _blocking_errnosstr)r0 errurl
timeout_valuer1 r1 r2 _raise_timeout/ s
z!HTTPConnectionPool._raise_timeoutc
: K s | j d7 _ | j|}|j |j|_y| j| W n: ttfk
rp } z| j|||jd W Y dd}~X nX |r|j ||f| n|j
||f| |j } t |ddr| dkrt
| |d| | tjkr|jjtj n |jj| yjy|jdd}
W nT tk
rP y |j }
W n0 tk
rJ } ztj|d W Y dd}~X nX Y nX W n< tttfk
r } z| j||| d W Y dd}~X nX t |d d
} tjd | j | j | j ||| |
j |
j yt!|
j" W n@ t#tfk
r } z tj$d | j%|| dd
W Y dd} ~ X nX |
S )a
Perform a request on a given urllib connection object taken from our
pool.
:param conn:
a connection from one of our connection pools
:param timeout:
Socket timeout in seconds for the request. This can be a
float or integer, which will set the same timeout value for
the socket connect and the socket read, or an instance of
:class:`urllib3.util.Timeout`, which gives you more fine-grained
control over your timeouts.
r )rj rk rl Nsockr z!Read timed out. (read timeout=%s)T) bufferingZ
_http_vsn_strzHTTP/?z%s://%s:%s "%s %s %s" %s %sz$Failed to parse headers (url=%s): %s)exc_info)&rL rd Z
start_connectrW r ra rf r rm Zrequest_chunkedrequest read_timeoutr] r r$ DEFAULT_TIMEOUTrn Z
settimeoutsocketZgetdefaulttimeoutZ getresponse TypeError Exceptionr Z
raise_from SocketErrorrT rU r+ r, r/ statusZlengthr" msgr r_
_absolute_url)
r0 rX methodrk r chunkedZhttplib_request_kw timeout_objerr httplib_responseZ http_versionZhper1 r1 r2
_make_request@ sT
(
$z HTTPConnectionPool._make_requestc C s t | j| j| j|djS )N)r+ r, r/ path)r& r+ r, r/ rk )r0 r r1 r1 r2 rz s z HTTPConnectionPool._absolute_urlc C sZ | j dkrdS | j d }| _ y"x |jdd}|r |j q W W n tjk
rT Y nX dS )zD
Close all pooled connections and disable the pool.
NF)rF )rE rZ r8 r r\ )r0 Zold_poolrX r1 r1 r2 r8 s
zHTTPConnectionPool.closec C st |j drdS t|\}}}t|| j}| jr@| r@tj|}n| j rZ|tj|krZd}|||f| j| j| jfkS )zj
Check if the given ``url`` is a member of the same host as this
connection pool.
/TN)
startswithr% r* r+ r/ r rZ r, )r0 rk r+ r, r/ r1 r1 r2 is_same_host s
z HTTPConnectionPool.is_same_hostTc
. K sD |dkr| j }t|ts*tj||| jd}|
dkr>|
jdd}
|rZ| j| rZt| ||d}|
}| jdkr|j }|j
| j d}d}t || } zry| j
|}| j| d}|j|_| jdk ot|dd }|r| j| | j||||||| d }|
s|nd}||
d
< | jj|f| ||d |
}d}W n tjk
rN t| d Y n ttt t t t t fk
r } zd}t|t t frt |}n>t|t t!fr| jrt"d
|}nt|t tfrt d|}|j#|||| t$j% d d}|j& |}W Y dd}~X nX W d|s |o|j' }d}|r0| j(| X |spt)j*d||| | j+|||||||f|| |
| d|
S dd }|o|j, }|r|j-dkrd}d}t.|j/ }|j0r| j| rt|t.st.|pi }x4t1t2j3|D ]"}|j4 |j0kr|j5|d qW y|j#|||| d}W n( t6k
rP |j7rL|| |S X || |j8| t)j9d|| | j+||||f||||| |
| d|
S t:|j;d}|j<||j-|r@y|j#|||| d}W n( t6k
r |j=r|| |S X || |j&| t)j9d| | j+||||f||||| |
| d|
S |S ) a
Get a connection from the pool and perform an HTTP request. This is the
lowest level call for making a request, so you'll need to specify all
the raw details.
.. note::
More commonly, it's appropriate to use a convenience method provided
by :class:`.RequestMethods`, such as :meth:`request`.
.. note::
`release_conn` will only behave as expected if
`preload_content=False` because we want to make
`preload_content=False` the default behaviour someday soon without
breaking backwards compatibility.
:param method:
HTTP request method (such as GET, POST, PUT, etc.)
:param body:
Data to send in the request body (useful for creating
POST requests, see HTTPConnectionPool.post_url for
more convenience).
:param headers:
Dictionary of custom headers to send, such as User-Agent,
If-None-Match, etc. If None, pool headers are used. If provided,
these headers completely replace any pool-specific headers.
:param retries:
Configure the number of retries to allow before raising a
:class:`~urllib3.exceptions.MaxRetryError` exception.
Pass ``None`` to retry until you receive a response. Pass a
:class:`~urllib3.util.retry.Retry` object for fine-grained control
over different types of retries.
Pass an integer number to retry connection errors that many times,
but no other types of errors. Pass zero to never retry.
If ``False``, then retries are disabled and any exception is raised
immediately. Also, instead of raising a MaxRetryError on redirects,
the redirect response will be returned.
:type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
:param redirect:
If True, automatically handle redirects (status codes 301, 302,
303, 307, 308). Each redirect counts as a retry. Disabling retries
will disable redirect, too.
:param assert_same_host:
If ``True``, will make sure that the host of the pool requests is
consistent else will raise HostChangedError. When False, you can
use the pool on an HTTP proxy and request foreign hosts.
:param timeout:
If specified, overrides the default timeout for this one
request. It may be a float (in seconds) or an instance of
:class:`urllib3.util.Timeout`.
:param pool_timeout:
If set and the pool is set to block=True, then this method will
block for ``pool_timeout`` seconds and raise EmptyPoolError if no
connection is available within the time period.
:param release_conn:
If False, then the urlopen call will not release the connection
back into the pool once a response is received (but will release if
you read the entire contents of the response such as when
`preload_content=True`). This is useful if you're not preloading
the response's content immediately. You will need to call
``r.release_conn()`` on the response ``r`` to return the connection
back into the pool. If None, it takes the value of
``response_kw.get('preload_content', True)``.
:param chunked:
If True, urllib3 will send the body using chunked transfer
encoding. Otherwise, urllib3 will send the body using the standard
content-length form. Defaults to False.
:param int body_pos:
Position to seek to in file-like body in the event of a retry or
redirect. Typically this won't need to be set because urllib3 will
auto-populate the value when needed.
:param \**response_kw:
Additional parameters are passed to
:meth:`urllib3.response.HTTPResponse.from_httplib`
N)redirectdefaultZpreload_contentTr@ F)r rn )r bodyrP r| Zrequest_method)rE
connectionrD z"No pool connections are available.zCannot connect to proxy.zConnection aborted. )r _poolZ _stacktracez1Retrying (%r) after connection broken by '%r': %s)r pool_timeout release_connbody_posc S sF y| j | jd W n. ttttttfk
r@ } zW Y d d }~X nX d S )N)Zdecode_content)readZ_has_decoded_contentr r rw r r r )responser~ r1 r1 r2 drain_and_release_conn s
z:HTTPConnectionPool.urlopen..drain_and_release_conni/ ZGET)r r zRedirecting %s -> %s)rD r assert_same_hostr r r r z Retry-Afterz Retry: %s)>rP rB r# Zfrom_intrD rZ r r
r+ copyupdaterH r! rd r^ rW r rG r] rb r ResponseClsZ from_httplibr r\ r r r rw r r r r r r
Z incrementsysrp Zsleepr8 r` rT r_ urlopenZget_redirect_locationrx r Z_prepare_for_method_changeZremove_headers_on_redirectlistr Ziterkeysr- popr Zraise_on_redirectZsleep_for_retryrU boolZ getheaderZis_retryZraise_on_status) r0 r{ rk r rP rD r r r r r r| r Z response_kwrX Zrelease_this_connrj Z
clean_exitr} Zis_new_proxy_connr Z
response_connr r~ r Zredirect_locationheaderZhas_retry_afterr1 r1 r2 r s ^
zHTTPConnectionPool.urlopen)N)r5 r; r< r= r+ r rV r r r$ rs r3 rY r^ r` ra rb rd rm rc r rz r8 r r r1 r1 r1 r2 r? ` s. :%
& Ur? c sn e Zd ZdZdZeZddejddddddddddddddfddZ dd Z
d
d Z d d
Z fddZ
ZS )HTTPSConnectionPoola
Same as :class:`.HTTPConnectionPool`, but HTTPS.
When Python is compiled with the :mod:`ssl` module, then
:class:`.VerifiedHTTPSConnection` is used, which *can* verify certificates,
instead of :class:`.HTTPSConnection`.
:class:`.VerifiedHTTPSConnection` uses one of ``assert_fingerprint``,
``assert_hostname`` and ``host`` in this order to verify connections.
If ``assert_hostname`` is False, no verification is done.
The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
``ca_cert_dir``, and ``ssl_version`` are only used if :mod:`ssl` is
available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
the connection socket into an SSL socket.
httpsNFr c K sf t j| ||||||||| |
f | |r2|
d kr2d}
| | _| | _|
| _|| _|| _|| _|| _|| _ d S )NZ
CERT_REQUIRED)
r? r3 key_file cert_file cert_reqsca_certs ca_cert_dir ssl_versionassert_hostnameassert_fingerprint)r0 r, r/ rA r rO rF rP rD rQ rR r r r r r r r r rM r1 r1 r2 r3 s z HTTPSConnectionPool.__init__c C s< t |tr8|j| j| j| j| j| j| j| j d | j
|_
|S )z
Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
and establish the tunnel if proxy is used.
)r r r r r r r ) rB r Zset_certr r r r r r r r )r0 rX r1 r1 r2
_prepare_conn" s
z!HTTPSConnectionPool._prepare_connc C s |j | j| j| j |j dS )z
Establish tunnel connection early, because otherwise httplib
would improperly set Host: header to proxy's IP:port.
N)Z
set_tunnelr. r/ rH connect)r0 rX r1 r1 r2 rb 3 s z"HTTPSConnectionPool._prepare_proxyc C s | j d7 _ tjd| j | j| jp$d | j s:| jtkrBtd| j}| j}| jdk rh| jj}| jj}| jf ||| j j
| j d| j }| j
|S )zB
Return a fresh :class:`httplib.HTTPSConnection`.
r z)Starting new HTTPS connection (%d): %s:%sZ443zCCan't connect to HTTPS URL because the SSL module is not available.N)r, r/ r rA )rK rT rU r, r/ rV r r rG r rW rA rM r )r0 Z actual_hostZ actual_portrX r1 r1 r2 rY ; s
z HTTPSConnectionPool._new_connc s: t t| j| t|dds$|j |js6tjdt dS )zU
Called right before a request is made, after the socket is created.
rn NzUnverified HTTPS request is being made. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings) superr ra r] r Z is_verifiedwarningswarnr )r0 rX ) __class__r1 r2 ra S s z"HTTPSConnectionPool._validate_conn)r5 r; r< r= r+ r rV r$ rs r3 r rb rY ra
__classcell__r1 r1 )r r2 r s r c K sR t | \}}}|p tj|d}|dkr:t|fd|i|S t|fd|i|S dS )a
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', '/')
P r r/ N)r% r rZ r r? )rk kwr+ r, r/ r1 r1 r2 connection_from_urlf s
r c C s: | j dr&| jdr&| jddjd} |tkr6| j } | S )z'
Process IPv6 address literals
[]z%25%z[])r endswithreplacestripr' r- )r, r+ r1 r1 r2 r* s
r* )LZ
__future__r re Zloggingr r rt r rw r rf
exceptionsr r r r r
r r r
r r r r r Zpackages.ssl_match_hostnamer Zpackagesr Zpackages.six.movesr r r r r r r r r _collectionsr rq r r r Zutil.connectionr Z util.requestr! Z
util.responser" Z
util.retryr# Z util.timeoutr$ Zutil.urlr% r& r' Z
util.queuer( ZmovesrI Z getLoggerr5 rT objectrc r) ZEAGAINZ EWOULDBLOCKrh r? r r r* r1 r1 r1 r2 sF < $
% r