U
|
ý°d# ã @ st d Z ddlmZ z ddlZW n6 ek
|
rR ddlZddlmZ e de¡ Y nX ddl Z ddl
|
m Z ddl mZmZ dd lmZmZ dd
|
lmZmZ dd lmZ dd lmZ z ddlZW n ek
|
rÔ dZY nX z dd l mZ G dd deZW n& ek
|
r e j e e j f ZY nX G dd deZ G dd de eZ G dd deZ!G dd deZ"G dd deZ#dS )a
|
This module contains provisional support for SOCKS proxies from within
|
urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
|
SOCKS5. To enable its functionality, either install PySocks or install this
|
module with the ``socks`` extra.
|
|
The SOCKS implementation supports the full range of urllib3 features. It also
|
supports the following SOCKS features:
|
|
- SOCKS4A (``proxy_url='socks4a://...``)
|
- SOCKS4 (``proxy_url='socks4://...``)
|
- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
|
- SOCKS5 with local DNS (``proxy_url='socks5://...``)
|
- Usernames and passwords for the SOCKS proxy
|
|
.. note::
|
It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
|
your ``proxy_url`` to ensure that DNS resolution is done from the remote
|
server instead of client-side when connecting to a domain name.
|
|
SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
|
supports IPv4, IPv6, and domain names.
|
|
When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
|
will be sent as the ``userid`` section of the SOCKS request:
|
|
.. code-block:: python
|
|
proxy_url="socks4a://<userid>@proxy-host"
|
|
When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
|
of the ``proxy_url`` will be sent as the username/password to authenticate
|
with the proxy:
|
|
.. code-block:: python
|
|
proxy_url="socks5h://<username>:<password>@proxy-host"
|
|
é )Ú annotationsNé )ÚDependencyWarningzÂSOCKS support in urllib3 requires the installation of optional dependencies: specifically, PySocks. For more information, see https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies)Útimeout)ÚHTTPConnectionÚHTTPSConnection)ÚHTTPConnectionPoolÚHTTPSConnectionPool)ÚConnectTimeoutErrorÚNewConnectionError)Ú PoolManager)Ú parse_url)Ú TypedDictc @ s> e Zd ZU ded< ded< ded< ded< ded< ded < d
|
S ) Ú_TYPE_SOCKS_OPTIONSÚintÚ socks_versionú
|
str | NoneÚ
|
proxy_hostÚ
|
proxy_portÚusernameÚpasswordÚboolÚrdnsN)Ú__name__Ú
|
__module__Ú __qualname__Ú__annotations__© r r úLd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\urllib3/contrib/socks.pyr M s
|
r c s: e Zd ZdZddddd fdd Zdd d
|
d Z ZS ) ÚSOCKSConnectionzG
|
A plain-text HTTP connection that connects via a SOCKS proxy.
|
r ú
|
typing.AnyÚNone)Ú_socks_optionsÚargsÚkwargsÚreturnc s || _ t j|| d S )N)r" ÚsuperÚ__init__)Úselfr" r# r$ ©Ú __class__r r r' ^ s zSOCKSConnection.__init__zsocks.socksocket)r% c
|
C st i }| j r| j |d< | jr$| j|d< zTtj| j| jff| jd | jd | jd | jd | jd | jd | jd |}W nö tk
|
r¸ } z"t | d
|
| j d | j d |W 5 d }~X Y n¸ tj
|
k
|
r: } zb|j r|j }t |trt | d
|
| j d | j d |nt | d| nt | d| |W 5 d }~X Y n6 tk
|
rn } zt | d| |W 5 d }~X Y nX |S )zA
|
Establish a new connection via the SOCKS proxy.
|
Úsource_addressÚsocket_optionsr r r r r r )Ú
|
proxy_typeZ
|
proxy_addrr Zproxy_usernameZproxy_passwordZ
|
proxy_rdnsr zConnection to z timed out. (connect timeout=ú)Nz&Failed to establish a new connection: )r+ r, ÚsocksÚcreate_connectionÚhostÚportr" r Ú SocketTimeoutr
|
Ú
|
ProxyErrorZ
|
socket_errÚ
|
isinstancer ÚOSError)r( Úextra_kwÚconnÚeÚerrorr r r Ú _new_conng sl
|
|
|
ÿø ÷
|
þý þý ÿ ÿþ ÿþzSOCKSConnection._new_conn)r r r Ú__doc__r' r; Ú __classcell__r r r) r r Y s r c @ s e Zd ZdS )ÚSOCKSHTTPSConnectionN)r r r r r r r r> ¦ s r> c @ s e Zd ZeZdS )ÚSOCKSHTTPConnectionPoolN)r r r r Ú ConnectionClsr r r r r? ª s r? c @ s e Zd ZeZdS )ÚSOCKSHTTPSConnectionPoolN)r r r r> r@ r r r r rA ® s rA c s< e Zd ZdZeedZd dddddd d
|
fd d Z ZS )ÚSOCKSProxyManagerzh
|
A version of the urllib3 ProxyManager that routes connections via the
|
defined SOCKS proxy.
|
)ÚhttpÚhttpsNé
|
Ústrr r z typing.Mapping[str, str] | Noner )Ú proxy_urlr r Ú num_poolsÚheadersÚconnection_pool_kwc sê t |}|d krB|d krB|jd k rB|j d¡}t|dkrB|\}}|jdkrXtj} d}
|
nP|jdkrntj} d}
|
n:|jdkrtj} d}
|
n$|jdkrtj} d}
|
ntd | || _ | |j
|
|j |||
|
d
|
} | |d < t j ||f| tj| _d S ) Nú:r Zsocks5FZsocks5hTZsocks4Zsocks4az'Unable to determine SOCKS version from )r r r r r r r" )r ÚauthÚsplitÚlenÚschemer/ ZPROXY_TYPE_SOCKS5ZPROXY_TYPE_SOCKS4Ú
|
ValueErrorrG r1 r2 r& r' rB Úpool_classes_by_scheme) r( rG r r rH rI rJ ÚparsedrM r r Z socks_optionsr) r r r' ½ s:
|
|
|
|
úzSOCKSProxyManager.__init__)NNrE N) r r r r< r? rA rQ r' r= r r r) r rB ² s þ úrB )$r< Ú
|
__future__r r/ Ú ImportErrorÚwarningsÚ
|
exceptionsr ÚwarnÚtypingÚsocketr r3 Ú
|
connectionr r Úconnectionpoolr r r
|
r Ú poolmanagerr Zutil.urlr Ússlr r ÚDictrF ÚAnyr r> r? rA rB r r r r Ú<module> s@ ( ú
|
M
|
