3
Z'íc· ã @ sÞ d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlmZ d dlm
Z ddl m
Z
mZmZmZmZmZmZmZ ddlmZmZmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z" ddl#m$Z$ dd l%m&Z& dd
l'm(Z( dd l)m*Z* dd l+m,Z, dd
l-m.Z. ddl/m0Z0 ddl1m2Z2 ddl3m4Z4 ddl5m6Z6 ddl7m8Z8 ddl9m:Z: ddl;m<Z<m=Z= ddl;m>Z? ddl;m@Z@mAZA e$jBjCZCejDeEZFeG ZHG dd deGZIejJejKhZLG dd deIe(ZMG dd d eMZNd d ZOd d Z>dS )!é )Úabsolute_importN)Úerror)Útimeouté )Ú BaseSSLErrorÚBrokenPipeErrorÚDummyConnectionÚHTTPConnectionÚ
HTTPExceptionÚHTTPSConnectionÚVerifiedHTTPSConnectionÚport_by_scheme)
ÚClosedPoolErrorÚEmptyPoolErrorÚHeaderParsingErrorÚHostChangedErrorÚInsecureRequestWarningÚLocationValueErrorÚ
MaxRetryErrorÚNewConnectionErrorÚ
ProtocolErrorÚ
ProxyErrorÚReadTimeoutErrorÚSSLErrorÚ TimeoutError)Úsix)Úqueue)ÚRequestMethods)Ú HTTPResponse)Úis_connection_dropped)Ú connection_requires_http_tunnel)Ú LifoQueue)Úset_file_position)Úassert_header_parsing)ÚRetry)ÚCertificateError)ÚTimeout)ÚUrlÚ_encode_target)Ú_normalize_host)Úget_hostÚ parse_urlc @ sB e Zd ZdZdZeZd
ddZdd Zdd Z d d
Z
d d Z dS )ÚConnectionPoola;
Base class for all connection pools, such as
:class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
.. note::
ConnectionPool.urlopen() does not normalize or percent-encode target URIs
which is useful if your target server doesn't support percent-encoded
target URIs.
Nc C s0 |s t dt|| jd| _|j | _|| _d S )NzNo host specified.)Úscheme)r r) r- ÚhostÚlowerÚ _proxy_hostÚport)Úselfr. r1 © r3 ú9/tmp/pip-build-gk9425m9/urllib3/urllib3/connectionpool.pyÚ__init__K s
zConnectionPool.__init__c C s dt | j| j| jf S )Nz%s(host=%r, port=%r))ÚtypeÚ__name__r. r1 )r2 r3 r3 r4 Ú__str__S s zConnectionPool.__str__c C s | S )Nr3 )r2 r3 r3 r4 Ú __enter__V s zConnectionPool.__enter__c C s | j dS )NF)Úclose)r2 Úexc_typeÚexc_valÚexc_tbr3 r3 r4 Ú__exit__Y s zConnectionPool.__exit__c C s dS )zD
Close all pooled connections and disable the pool.
Nr3 )r2 r3 r3 r4 r: ^ s zConnectionPool.close)N) r7 Ú
__module__Ú __qualname__Ú__doc__r- r! ÚQueueClsr5 r8 r9 r> r: r3 r3 r3 r4 r, = s
r, c
@ sº e Zd ZdZdZeZeZdde j
dddddddf
ddZ dd Z d!d
d Z
d d
Zdd Zdd Zdd Zdd ZedfddZdd Zdd Zd d Zdddd d eddddf
d d ZdS )"ÚHTTPConnectionPoola:
Thread-safe connection pool for one host.
:param host:
Host used for this HTTP Connection (e.g. "localhost"), passed into
:class:`http.client.HTTPConnection`.
:param port:
Port used for this HTTP Connection (None is equivalent to 80), passed
into :class:`http.client.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:`http.client.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.ProxyManager`
:param _proxy_headers:
A dictionary with proxy headers, should not be used directly,
instead, see :class:`urllib3.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 qW d| _d| _| | _| jrÒ| jjdg | j| jd< | j| jd< d S )Nr Úsocket_optionsÚproxyÚ proxy_config)r, r5 r ÚstrictÚ
isinstancer& Ú
from_floatr$ ÚDEFAULTr ÚretriesrB ÚpoolÚblockrF Ú
proxy_headersrG ÚxrangeÚputÚnum_connectionsÚ num_requestsÚconn_kwÚ
setdefault)r2 r. r1 rH r ÚmaxsizerN ÚheadersrL Ú_proxyÚ_proxy_headersZ
_proxy_configrT Ú_r3 r3 r4 r5 © 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:%sÚ80)r. r1 r rH )
rR ÚlogÚdebugr. r1 Ú
ConnectionClsr Úconnect_timeoutrH rT )r2 Úconnr3 r3 r4 Ú _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)rN r zPool is closed.z>Pool reached maximum size and no more connections are allowed.z Resetting dropped connection: %sÚ auto_openr r )rM ÚgetrN ÚAttributeErrorr r ÚEmptyr r r\ r] r. r: Úgetattrra )r2 r r` r3 r3 r4 Ú _get_connô s" z HTTPConnectionPool._get_connc C sd y| j j|dd dS tk
r( Y n, tjk
rR tjd| j| j j Y nX |r`|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)rN NzLConnection pool is full, discarding connection: %s. Connection pool size: %s)
rM rQ rd r ÚFullr\ Úwarningr. Úqsizer: )r2 r` r3 r3 r4 Ú _put_conn s z HTTPConnectionPool._put_connc C s dS )zU
Called right before a request is made, after the socket is created.
Nr3 )r2 r` r3 r3 r4 Ú_validate_conn: s z!HTTPConnectionPool._validate_connc C s d S )Nr3 )r2 r` r3 r3 r4 Ú_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 ÚclonerI r& rJ )r2 r r3 r3 r4 Ú _get_timeoutD 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)rI Ú
SocketTimeoutr Úhasattrrq Ú_blocking_errnosÚstr)r2 ÚerrÚurlÚ
timeout_valuer3 r3 r4 Ú_raise_timeoutP s
z!HTTPConnectionPool._raise_timeoutc
H K sn | j d7 _ | j|}|j |j|_y| j| W n: ttfk
rp } z| j|||jd W Y dd}~X nX y*|r|j ||f| n|j
||f| W nL t k
r° Y n: t k
rè } z |j
t
jt
jt
jhkrØ W Y dd}~X nX |j} t|ddrB| dkrt| |d| | tjkr6|jjtj n |jj| yjy|jdd}
W nT tk
r¨ y |j }
W n0 t k
r¢ } zt j |d W Y dd}~X nX Y nX W n< ttt fk
rè } z| j||| d W Y dd}~X nX t|d d
} t j!d | j"| j#| j$||| |
j%|
j& yt'|
j( W n@ t)tfk
rh } z t j*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 )rv rw rx NÚsockr z!Read timed out. (read timeout=%s)T)Ú bufferingÚ
_http_vsn_strzHTTP/?z%s://%s:%s "%s %s %s" %s %sz$Failed to parse headers (url=%s): %s)Úexc_info),rS rp Ú
start_connectr_ r rl rr r ry Úrequest_chunkedÚrequestr ÚIOErrorrq ÚEPIPEZ ESHUTDOWNZ
EPROTOTYPEÚ read_timeoutrf r r& ÚDEFAULT_TIMEOUTrz Ú
settimeoutÚsocketÚgetdefaulttimeoutÚ getresponseÚ TypeErrorÚ
BaseExceptionr Ú
raise_fromÚ SocketErrorr\ r] r- r. r1 ÚstatusÚlengthr# Úmsgr ri Ú
_absolute_url)
r2 r` Úmethodrw r ÚchunkedÚhttplib_request_kwÚ timeout_objÚer Úhttplib_responseÚ http_versionÚhper3 r3 r4 Ú
_make_requesti sx
( z HTTPConnectionPool._make_requestc C s t | j| j| j|djS )N)r- r. r1 Úpath)r' r- r. r1 rw )r2 r r3 r3 r4 r à 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)rN )rM rc r: r re )r2 Úold_poolr` r3 r3 r4 r: ã s
zHTTPConnectionPool.closec C s| |j drdS t|\}}}|dk r0t||d}| jrH| rHtj|}n| j rb|tj|krbd}|||f| j| j| jfkS )zj
Check if the given ``url`` is a member of the same host as this
connection pool.
ú/TN)r- )Ú
startswithr* r) r1 r
rc r- r. )r2 rw r- r. r1 r3 r3 r4 Ú is_same_hostõ s
z HTTPConnectionPool.is_same_hostTc
/ K sd t |}|j}|dkr | j}t|ts8tj||| jd}|
dkrL|
jdd}
|rh| j| rht | |||j
drt j t
|}n t j |j}d}|
}t| j| j|}|s¾|j }|j| j d}d}t|| } zÊy¢| j|}| j| d}|j|_| jdk o t|dd }|r$|r$| j| | j ||||||| d }|
sF|nd}||
d
< | j j |f| ||d |
}d}W n" t k
r d}d} Y n t t!t"t#t$t%t&fk
r } zÖd}d d
}t|t$r| jr||r|jr|jjdkrt'dt%|}nXt|t$t&fr"t%|}n>t|t"t(frF| jrFt'd|}nt|t"t!fr`t#d|}|j)|||| t*j+ d d}|j, |}W Y dd}~X nX W d|s¶|o°|j- }d}|rÆ| j.| X |st/j0d||| | j1|||||||f|| |
| | d|
S |o|j2 } | r¶|j3dkr,d}y|j)|||| d}W n( t4k
rj |j5rf|j6 |S X |j6 |j7| t/j8d|| | j1|| ||f||||| |
| | d|
S t9|jjd} |j:||j3| r`y|j)|||| d}W n( t4k
r |j;r|j6 |S X |j6 |j,| t/j8d | | j1||||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 url:
The URL to perform the request on.
:param body:
Data to send in the request body, either :class:`str`, :class:`bytes`,
an iterable of :class:`str`/:class:`bytes`, or a file-like object.
: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)ÚredirectÚdefaultÚpreload_contentTr F)r rz )r ÚbodyrW r Úrequest_method)rM Ú
connectionrL c S s* dj tjdt| j }d|kp(d|kS )Nú z[^a-z]zwrong version numberzunknown protocol)ÚjoinÚreÚsplitru r/ )Z ssl_errorÚmessager3 r3 r4 Ú%_is_ssl_error_message_from_http_proxyñ s zIHTTPConnectionPool.urlopen.<locals>._is_ssl_error_message_from_http_proxyÚhttpsz¹Your proxy appears to only use HTTP and not HTTPS, try changing your proxy URL to be HTTP. See: https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html#https-proxy-error-http-proxyzCannot connect to proxy.zConnection aborted.é )r Ú_poolÚ _stacktracez1Retrying (%r) after connection broken by '%r': %s)r Ú pool_timeoutÚ release_connr Úbody_posi/ ÚGET)Úresponser zRedirecting %s -> %s)rL r Úassert_same_hostr r¯ r° r r± z Retry-Afterz Retry: %s)<r+ r- rW rI r$ Úfrom_intrL rc r r r r Z
ensure_strr( rw r rF rG ÚcopyÚupdaterO r" rp rg r_ r rf rm r Ú ResponseClsÚ from_httplibr r r
r r r r r% r r Ú incrementÚsysr} Úsleepr: rk r\ ri ÚurlopenÚget_redirect_locationr r Úraise_on_redirectZ
drain_connÚsleep_for_retryr] ÚboolÚis_retryÚraise_on_status) r2 r rw r¢ rW rL r r´ r r¯ r° r r± Ú response_kwÚ
parsed_urlZdestination_schemer` Úrelease_this_connZhttp_tunnel_requiredrv Ú
clean_exitr Úis_new_proxy_connr Ú
response_connr³ r rª Úredirect_locationÚhas_retry_afterr3 r3 r4 r½
s: m
zHTTPConnectionPool.urlopen)N)r7 r? r@ rA r- r r^ r r¸ r& r r5 ra rg rk rl rm rp ry rn r r r: r r½ r3 r3 r3 r4 rC i sF : *
' vrC c sp e Zd ZdZdZeZddejdddddddddddddddfddZ dd Z
d
d Z d d
Z fddZ
ZS )ÚHTTPSConnectionPoola
Same as :class:`.HTTPConnectionPool`, but HTTPS.
:class:`.HTTPSConnection` 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``, ``ssl_version``, ``key_password`` 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.
r« NFr c K s\ t j| ||||||||| |
f | | | _| | _|
| _|| _|| _|| _|| _|| _ || _
d S )N) rC r5 Úkey_fileÚ cert_fileÚ cert_reqsÚ key_passwordÚca_certsÚ ca_cert_dirÚ ssl_versionÚassert_hostnameÚassert_fingerprint)r2 r. r1 rH r rV rN rW rL rX rY rÍ rÎ rÏ rÐ rÑ rÓ rÔ rÕ rÒ rT r3 r3 r4 r5 s, z HTTPSConnectionPool.__init__c
C s@ t |tr<|j| 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Ô rÕ ) rI r Úset_certrÍ rÐ rÎ rÏ rÑ rÒ rÔ rÕ rÓ )r2 r` r3 r3 r4 Ú
_prepare_connà s
z!HTTPSConnectionPool._prepare_connc C s2 |j | j| j| j | jjdkr&d|_|j dS )zÏ
Establishes a tunnel connection through HTTP CONNECT.
Tunnel connection is established early because otherwise httplib would
improperly set Host: header to proxy's IP:port.
r« TN)Ú
set_tunnelr0 r1 rO rF r- Ztls_in_tls_requiredÚconnect)r2 r` r3 r3 r4 rm × 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 | j | j
| jd| j}| j|S )zF
Return a fresh :class:`http.client.HTTPSConnection`.
r z)Starting new HTTPS connection (%d): %s:%sZ443zCCan't connect to HTTPS URL because the SSL module is not available.N)r. r1 r rH rÎ rÍ rÐ )rR r\ r] r. r1 r^ r r rF r r_ rH rÎ rÍ rÐ rT r× )r2 Ú actual_hostÚ actual_portr` r3 r3 r4 ra æ s0
z HTTPSConnectionPool._new_connc s\ t t| j| t|dds$|j |js<tjd|j t t|dddkrXtjdt dS )zU
Called right before a request is made, after the socket is created.
rz Nz¸Unverified HTTPS request is being made to host '%s'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html#ssl-warningsZproxy_is_verifiedFz·Unverified HTTPS connection done to an HTTPS proxy. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html#ssl-warnings)
ÚsuperrÌ rl rf rÙ Ú is_verifiedÚwarningsÚwarnr. r )r2 r` )Ú __class__r3 r4 rl
s z"HTTPSConnectionPool._validate_conn)r7 r? r@ rA r- r r^ r& r r5 r× rm ra rl Ú
__classcell__r3 r3 )rà r4 rÌ s2 $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« r1 N)r* r
rc rÌ rC )rw Úkwr- r. r1 r3 r3 r4 Úconnection_from_url+ s
rä c C s. t | |} | jdr*| jdr*| dd
} | S )z?
Normalize hosts for comparisons and use with sockets.
ú[ú]r éÿÿÿÿ)Únormalize_hostr Úendswith)r. r- r3 r3 r4 r) G s
r) )PÚ
__future__r rq Úloggingr§ r r» rÞ r r r rr r¤ r r r r r
r r r
Ú
exceptionsr r r r r r r r r r r r r Úpackagesr Zpackages.six.movesr r r r³ r Zutil.connectionr Z
util.proxyr Z
util.queuer! Z util.requestr" Z
util.responser# Z
util.retryr$ Zutil.ssl_match_hostnamer% Z util.timeoutr& Zutil.urlr' r( r) rè r* r+ ÚmovesrP Ú getLoggerr7 r\ Úobjectrn r, ÚEAGAINÚ EWOULDBLOCKrt rC rÌ rä r3 r3 r3 r4 Ú<module> sR (
<
) +