adapters.pyc
1 o 2 ��Yc'S � @ s� d Z ddlZddlZddlmZmZ ddlmZ ddlm Z 3 ddlm Z m Z m Z mZ ddlmZ ddlmZmZ dd lmZ dd 4 lmZmZ dd lmZ dd lmZ dd lm Z ddl m Z ddl m!Z! ddl"m#Z#m$Z$ ddl%m&Z& ddl'm(Z(m)Z)m Z m*Z*m+Z+m,Z,mZm-Z-m.Z.mZ ddl/m0Z0 ddl1m2Z2 ddl3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z: zddl;m<Z< W n e=y� dd� Z<Y nw dZ>dZ?dZ@dZAG d d � d �ZBG d d � d eB�ZCdS ) z� 5 requests.adapters 6 ~~~~~~~~~~~~~~~~~ 7 8 This module contains the transport adapters that Requests uses to define 9 and maintain connections. 10 � N)�ClosedPoolError�ConnectTimeoutError)� HTTPError)� InvalidHeader)�LocationValueError� MaxRetryError�NewConnectionError� ProtocolError)� 11 ProxyError)�ReadTimeoutError� ResponseError)�SSLError)� PoolManager�proxy_from_url)� HTTPResponse)�Timeout)� parse_url)�Retry� )�_basic_auth_str)� 12 basestring�urlparse)�extract_cookies_to_jar) 13 �ConnectionError�ConnectTimeoutr �InvalidProxyURL� InvalidSchema� 14 InvalidURLr 15 � ReadTimeout� 16 RetryErrorr )�Response)�CaseInsensitiveDict)�DEFAULT_CA_BUNDLE_PATH�extract_zipped_paths�get_auth_from_url�get_encoding_from_headers�prepend_scheme_if_needed� select_proxy� urldefragauth)�SOCKSProxyManagerc O s t d��)Nz'Missing dependencies for SOCKS support.)r )�args�kwargs� r, ��C:\Users\Jacks.GUTTSPC\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\site-packages\requests\adapters.pyr) = s r) F� 17 c s4 e Zd ZdZ� fdd�Z d dd�Zd d 18 � Z� ZS ) � BaseAdapterzThe Base Transport Adapterc s t � �� d S �N)�super�__init__��self�� __class__r, r- r2 J s zBaseAdapter.__init__FNTc C � t �)aC Sends PreparedRequest object. Returns Response object. 19 20 :param request: The :class:`PreparedRequest <PreparedRequest>` being sent. 21 :param stream: (optional) Whether to stream the request content. 22 :param timeout: (optional) How long to wait for the server to send 23 data before giving up, as a float, or a :ref:`(connect timeout, 24 read timeout) <timeouts>` tuple. 25 :type timeout: float or tuple 26 :param verify: (optional) Either a boolean, in which case it controls whether we verify 27 the server's TLS certificate, or a string, in which case it must be a path 28 to a CA bundle to use 29 :param cert: (optional) Any user-provided SSL certificate to be trusted. 30 :param proxies: (optional) The proxies dictionary to apply to the request. 31 ��NotImplementedError)r4 �request�stream�timeout�verify�cert�proxiesr, r, r- �sendM s zBaseAdapter.sendc C r7 )z!Cleans up adapter specific items.r8 r3 r, r, r- �close` s zBaseAdapter.close�FNTNN)�__name__� 32 __module__� __qualname__�__doc__r2 r@ rA � __classcell__r, r, r5 r- r/ G s 33 �r/ c s� e Zd ZdZg d�Zeeeef� fdd� Zdd� Z dd� Z 34 efd d 35 �Z d d � Z d d� Z dd� Zd dd�Zdd� Zdd� Zdd� Zdd� Z d!d d �Z� ZS )"� HTTPAdaptera� The built-in HTTP Adapter for urllib3. 36 37 Provides a general-case interface for Requests sessions to contact HTTP and 38 HTTPS urls by implementing the Transport Adapter interface. This class will 39 usually be created by the :class:`Session <Session>` class under the 40 covers. 41 42 :param pool_connections: The number of urllib3 connection pools to cache. 43 :param pool_maxsize: The maximum number of connections to save in the pool. 44 :param max_retries: The maximum number of retries each connection 45 should attempt. Note, this applies only to failed DNS lookups, socket 46 connections and connection timeouts, never to requests where data has 47 made it to the server. By default, Requests does not retry failed 48 connections. If you need granular control over the conditions under 49 which we retry a request, import urllib3's ``Retry`` class and pass 50 that instead. 51 :param pool_block: Whether the connection pool should block for connections. 52 53 Usage:: 54 55 >>> import requests 56 >>> s = requests.Session() 57 >>> a = requests.adapters.HTTPAdapter(max_retries=3) 58 >>> s.mount('http://', a) 59 )� max_retries�config�_pool_connections� _pool_maxsize� _pool_blockc s` |t kr tddd�| _nt�|�| _i | _i | _t� �� || _|| _ || _ 60 | j |||d� d S )Nr F)�read��block) �DEFAULT_RETRIESr rI �from_intrJ � proxy_managerr1 r2 rK rL rM �init_poolmanager)r4 Zpool_connectionsZ pool_maxsizerI Z 61 pool_blockr5 r, r- r2 � s 62 zHTTPAdapter.__init__c s � fdd�� j D �S )Nc s i | ] }|t � |d ��qS r0 )�getattr)�.0�attrr3 r, r- � 63 <dictcomp>� s z,HTTPAdapter.__getstate__.<locals>.<dictcomp>)� __attrs__r3 r, r3 r- � __getstate__� s zHTTPAdapter.__getstate__c C sD i | _ i | _|�� D ] 64 \}}t| ||� q 65 | j| j| j| jd� d S )NrO )rS rJ �items�setattrrT rK rL rM )r4 �staterW �valuer, r, r- � __setstate__� s 66 �zHTTPAdapter.__setstate__c K s0 || _ || _|| _td|||dd�|��| _dS )a Initializes a urllib3 PoolManager. 67 68 This method should not be called from user code, and is only 69 exposed for use when subclassing the 70 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 71 72 :param connections: The number of urllib3 connection pools to cache. 73 :param maxsize: The maximum number of connections to save in the pool. 74 :param block: Block when no free connections are available. 75 :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager. 76 T)� num_pools�maxsizerP �strictNr, )rK rL rM r � poolmanager)r4 � connectionsra rP � pool_kwargsr, r, r- rT � s � �z HTTPAdapter.init_poolmanagerc K s� || j v r | j | }|S |�� �d�r1t|�\}}t|f||| j| j| jd�|�� }| j |< |S | �|�}t |f|| j| j| jd�|�� }| j |< |S )a� Return urllib3 ProxyManager for the given proxy. 77 78 This method should not be called from user code, and is only 79 exposed for use when subclassing the 80 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 81 82 :param proxy: The proxy to return a urllib3 ProxyManager for. 83 :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager. 84 :returns: ProxyManager 85 :rtype: urllib3.ProxyManager 86 �socks)�username�passwordr` ra rP )� proxy_headersr` ra rP ) 87 rS �lower� 88 startswithr$ r) rK rL rM ri r )r4 �proxyZ proxy_kwargs�managerrg rh ri r, r, r- �proxy_manager_for� s: 89 90 � ��� 91 ���� z HTTPAdapter.proxy_manager_forc C s |� � �d�r7|r7d}|dur|}|stt�}|r tj�|�s&td|� ���d|_tj� |�s3||_ 92 n ||_ n d|_d|_ 93 d|_ |r|t |t �sR|d |_|d |_n||_d|_|jrjtj�|j�sjtd |j� ���|jr~tj�|j�s�td 94 |j� ���dS dS dS ) aA Verify a SSL certificate. This method should not be called from user 95 code, and is only exposed for use when subclassing the 96 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 97 98 :param conn: The urllib3 connection object associated with the cert. 99 :param url: The requested URL. 100 :param verify: Either a boolean, in which case it controls whether we verify 101 the server's TLS certificate, or a string, in which case it must be a path 102 to a CA bundle to use 103 :param cert: The SSL certificate to verify. 104 �httpsNTzCCould not find a suitable TLS CA certificate bundle, invalid path: � CERT_REQUIRED� CERT_NONEr r z7Could not find the TLS certificate file, invalid path: z/Could not find the TLS key file, invalid path: )rj rk r# r" �os�path�exists�OSError� cert_reqs�isdir�ca_certs� ca_cert_dir� 105 isinstancer � cert_file�key_file)r4 �conn�urlr= r> Zcert_locr, r, r- � cert_verify� sJ �� 106 107 �� 108 �� zHTTPAdapter.cert_verifyc C s� t � }t|dd�|_tt|di ��|_t|j�|_||_|jj|_t |j 109 t �r/|j 110 � d�|_ 111 n|j 112 |_ 113 t |j||� ||_| |_|S )a� Builds a :class:`Response <requests.Response>` object from a urllib3 114 response. This should not be called from user code, and is only exposed 115 for use when subclassing the 116 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>` 117 118 :param req: The :class:`PreparedRequest <PreparedRequest>` used to generate the response. 119 :param resp: The urllib3 response object. 120 :rtype: requests.Response 121 �statusN�headers�utf-8)r rU � status_coder! r� r% �encoding�raw�reasonrz r~ �bytes�decoder �cookiesr: � 122 connection)r4 �req�resp�responser, r, r- �build_response( s 123 124 zHTTPAdapter.build_responseNc C sf t ||�}|r#t|d�}t|�}|jstd��| �|�}|�|�}|S t|�}|�� }| j �|�}|S )a� Returns a urllib3 connection for the given URL. This should not be 125 called from user code, and is only exposed for use when subclassing the 126 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 127 128 :param url: The URL to connect to. 129 :param proxies: (optional) A Requests-style dictionary of proxies used on this request. 130 :rtype: urllib3.ConnectionPool 131 �httpzFPlease check proxy URL. It is malformed and could be missing the host.) 132 r' r& r �hostr rn �connection_from_urlr �geturlrc )r4 r~ r? rl � proxy_urlrS r} �parsedr, r, r- �get_connectionM s 133 134 � 135 136 � zHTTPAdapter.get_connectionc C s& | j �� | j�� D ]}|�� q 137 dS )z�Disposes of any internal state. 138 139 Currently, this closes the PoolManager and any active ProxyManager, 140 which closes any pooled connections. 141 N)rc �clearrS �values)r4 rl r, r, r- rA j s 142 143 �zHTTPAdapter.closec C s` t |j|�}t|j�j}|o|dk}d}|r"t|�j�� }|�d�}|j}|r.|s.t|j�}|S )a? Obtain the url to use when making the final request. 144 145 If the message is being sent through a HTTP proxy, the full URL has to 146 be used. Otherwise, we should only use the path portion of the URL. 147 148 This should not be called from user code, and is only exposed for use 149 when subclassing the 150 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 151 152 :param request: The :class:`PreparedRequest <PreparedRequest>` being sent. 153 :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs. 154 :rtype: str 155 ro Frf )r' r~ r �schemerj rk �path_urlr( ) r4 r: r? rl r� Zis_proxied_http_requestZusing_socks_proxyZ proxy_schemer~ r, r, r- � request_urlt s 156 157 zHTTPAdapter.request_urlc K s dS )a" Add any headers needed by the connection. As of v2.0 this does 158 nothing by default, but is left for overriding by users that subclass 159 the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 160 161 This should not be called from user code, and is only exposed for use 162 when subclassing the 163 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 164 165 :param request: The :class:`PreparedRequest <PreparedRequest>` to add headers to. 166 :param kwargs: The keyword arguments from the call to send(). 167 Nr, )r4 r: r+ r, r, r- � add_headers� s zHTTPAdapter.add_headersc C s& i }t |�\}}|rt||�|d< |S )a Returns a dictionary of the headers to add to any request sent 168 through a proxy. This works with urllib3 magic to ensure that they are 169 correctly sent to the proxy, rather than in a tunnelled request if 170 CONNECT is being used. 171 172 This should not be called from user code, and is only exposed for use 173 when subclassing the 174 :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`. 175 176 :param proxy: The url of the proxy being used for this request. 177 :rtype: dict 178 zProxy-Authorization)r$ r )r4 rl r� rg rh r, r, r- ri � s 179 zHTTPAdapter.proxy_headersFTc C sx z | � |j|�}W n ty } zt||d��d}~ww | �||j||� | �||�} | j||||||d� |jdu p?d|jv } 180 t |t 181 �rbz |\} } t | | d�}W n t ya t d|� d���w t |t �rhnt ||d�}z�| 182 s�|j |j| |j|jdddd| j|d � 183 } nxt|d 184 �r�|j}|jtd �}z]d |jv }|j|j| d |d� |j�� D ] 185 \}}|�||� q�|�� |jD ]!}|�tt|��dd� �d�� |�d� |�|� |�d� q�|�d� |� � }t j |||ddd�} W n t y� |� � � w W n� t!t"f�y } zt#||d��d}~w t$�y` } zAt |j%t&��r/t |j%t'��s/t(||d��t |j%t)��r<t*||d��t |j%t+��rIt,||d��t |j%t-��rVt.||d��t#||d��d}~w t/�yr } zt#||d��d}~w t+�y� } zt,|��d}~w t-t0f�y� } z%t |t-��r�t.||d��t |t1��r�t2||d��t |t3��r�t4||d��� d}~ww | �5|| �S )a Sends PreparedRequest object. Returns Response object. 186 187 :param request: The :class:`PreparedRequest <PreparedRequest>` being sent. 188 :param stream: (optional) Whether to stream the request content. 189 :param timeout: (optional) How long to wait for the server to send 190 data before giving up, as a float, or a :ref:`(connect timeout, 191 read timeout) <timeouts>` tuple. 192 :type timeout: float or tuple or urllib3 Timeout object 193 :param verify: (optional) Either a boolean, in which case it controls whether 194 we verify the server's TLS certificate, or a string, in which case it 195 must be a path to a CA bundle to use 196 :param cert: (optional) Any user-provided SSL certificate to be trusted. 197 :param proxies: (optional) The proxies dictionary to apply to the request. 198 :rtype: requests.Response 199 )r: N)r; r< r= r> r? zContent-Length)�connectrN zInvalid timeout za. Pass a (connect, read) timeout tuple, or a single float to set both timeouts to the same value.F) 200 �methodr~ �bodyr� �redirect�assert_same_host�preload_content�decode_content�retriesr< � 201 proxy_pool)r< �HostT)�skip_accept_encoding� skip_host� r� s 202 s 0 203 204 )�poolr� r� r� )6r� r~ r r r r� r� r� r� rz �tuple� TimeoutSauce� 205 ValueError�urlopenr� rI �hasattrr� � _get_conn�DEFAULT_POOL_TIMEOUT� 206 putrequestr[ � putheader� 207 endheadersr@ �hex�len�encode� getresponser � from_httplib� ExceptionrA r ru r r r� r r r r r � _ProxyErrorr 208 � _SSLErrorr r � 209 _HTTPErrorr r �_InvalidHeaderr r� )r4 r: r; r< r= r> r? r} �er~ �chunkedr� rN r� Zlow_connr� �headerr^ �i�r�errr, r, r- r@ � s� �� � 210 211 �� 212 � 213 214 � 215 216 217 218 219 � �� � � �� �� zHTTPAdapter.sendr0 rB )rC rD rE rF rY �DEFAULT_POOLSIZErQ �DEFAULT_POOLBLOCKr2 rZ r_ rT rn r r� r� rA r� r� ri r@ rG r, r, r5 r- rH e s, 220 � 221 �&9 222 % 223 �rH )DrF �os.pathrr �socket�urllib3.exceptionsr r r r� r r� r r r r r 224 r� r r r r� Zurllib3.poolmanagerr r Zurllib3.responser � urllib3.utilr r� r Zurllib3.util.retryr �authr �compatr r r� r � 225 exceptionsr r r r r r r �modelsr � 226 structuresr! �utilsr" r# r$ r% r& r' r( �urllib3.contrib.socksr) � ImportErrorr� r� rQ r� r/ rH r, r, r, r- �<module> sB 0 $ 227 �