python-socks 2.6.0__py3-none-any.whl → 2.7.0__py3-none-any.whl

python_socks/_errors.py

@@ -4,7 +4,7 @@ class ProxyError(Exception):
         self.error_code = error_code
 
 
-class ProxyTimeoutError(Exception):
+class ProxyTimeoutError(TimeoutError):
     pass
 
 

python_socks/_version.py

@@ -1,2 +1,2 @@
 __title__ = 'python-socks'
-__version__ = '2.6.0'
+__version__ = '2.7.0'

python_socks/async_/_proxy_chain.py

@@ -1,8 +1,14 @@
 from typing import Iterable
+import warnings
 
 
 class ProxyChain:
     def __init__(self, proxies: Iterable):
+        warnings.warn(
+            'This implementation of ProxyChain is deprecated and will be removed in the future',
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._proxies = proxies
 
     async def connect(self, dest_host, dest_port, timeout=None):
@@ -15,14 +21,14 @@ class ProxyChain:
                 dest_host=proxies[i + 1].proxy_host,
                 dest_port=proxies[i + 1].proxy_port,
                 timeout=timeout,
-                _socket=curr_socket
+                _socket=curr_socket,
             )
 
         curr_socket = await proxies[length].connect(
             dest_host=dest_host,
             dest_port=dest_port,
             timeout=timeout,
-            _socket=curr_socket
+            _socket=curr_socket,
         )
 
         return curr_socket

python_socks/async_/anyio/_chain.py

@@ -1,9 +1,15 @@
 from typing import Iterable
+import warnings
 from ._proxy import AnyioProxy
 
 
 class ProxyChain:
     def __init__(self, proxies: Iterable[AnyioProxy]):
+        warnings.warn(
+            'This implementation of ProxyChain is deprecated and will be removed in the future',
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._proxies = proxies
 
     async def connect(

python_socks/async_/anyio/_connect.py

@@ -1,3 +1,4 @@
+from typing import Optional
 import anyio
 import anyio.abc
 
@@ -5,7 +6,7 @@ import anyio.abc
 async def connect_tcp(
     host: str,
     port: int,
-    local_host: str = None,
+    local_host: Optional[str] = None,
 ) -> anyio.abc.SocketStream:
 
     return await anyio.connect_tcp(

python_socks/async_/anyio/_proxy.py

@@ -1,5 +1,6 @@
 import ssl
 from typing import Any, Optional
+import warnings
 
 import anyio
 
@@ -52,7 +53,14 @@ class AnyioProxy:
             timeout = DEFAULT_TIMEOUT
 
         _stream = kwargs.get('_stream')
-
+        if _stream is not None:
+            warnings.warn(
+                "The '_stream' argument is deprecated and will be removed in the future",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        local_host = kwargs.get('local_host')
         try:
             with anyio.fail_after(timeout):
                 if _stream is None:
@@ -61,6 +69,7 @@ class AnyioProxy:
                             await connect_tcp(
                                 host=self._proxy_host,
                                 port=self._proxy_port,
+                                local_host=local_host,
                             )
                         )
                     except OSError as e:
@@ -123,6 +132,6 @@ class AnyioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'AnyioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/async_/anyio/v2/_chain.py

@@ -1,9 +1,15 @@
 from typing import Sequence
+import warnings
 from ._proxy import AnyioProxy
 
 
 class ProxyChain:
     def __init__(self, proxies: Sequence[AnyioProxy]):
+        warnings.warn(
+            'This implementation of ProxyChain is deprecated and will be removed in the future',
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._proxies = proxies
 
     async def connect(

python_socks/async_/anyio/v2/_connect.py

@@ -1,3 +1,4 @@
+from typing import Optional
 import anyio
 import anyio.abc
 from ._stream import AnyioSocketStream
@@ -6,7 +7,7 @@ from ._stream import AnyioSocketStream
 async def connect_tcp(
     host: str,
     port: int,
-    local_host: str = None,
+    local_host: Optional[str] = None,
 ) -> AnyioSocketStream:
     s = await anyio.connect_tcp(
         remote_host=host,

python_socks/async_/anyio/v2/_proxy.py

@@ -1,5 +1,5 @@
 import ssl
-from typing import Optional
+from typing import Any, Optional
 
 import anyio
 
@@ -47,33 +47,36 @@ class AnyioProxy:
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
         timeout: Optional[float] = None,
+        **kwargs: Any,
     ) -> AnyioSocketStream:
         if timeout is None:
             timeout = DEFAULT_TIMEOUT
 
+        local_host = kwargs.get('local_host')
         try:
             with anyio.fail_after(timeout):
                 return await self._connect(
                     dest_host=dest_host,
                     dest_port=dest_port,
                     dest_ssl=dest_ssl,
+                    local_host=local_host,
                 )
         except TimeoutError as e:
-            raise ProxyTimeoutError(
-                'Proxy connection timed out: {}'.format(timeout)
-            ) from e
+            raise ProxyTimeoutError('Proxy connection timed out: {}'.format(timeout)) from e
 
     async def _connect(
         self,
         dest_host: str,
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
+        local_host: Optional[str] = None,
     ) -> AnyioSocketStream:
         if self._forward is None:
             try:
                 stream = await connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
+                    local_host=local_host,
                 )
             except OSError as e:
                 raise ProxyConnectionError(
@@ -127,6 +130,6 @@ class AnyioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'AnyioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/async_/asyncio/_connect.py

@@ -23,7 +23,7 @@ async def connect_tcp(
     if is_ipv6_address(host):
         address = (host, port, 0, 0)  # to fix OSError: [WinError 10022]
     else:
-        address = (host, port)
+        address = (host, port)  # type: ignore[assignment]
 
     await loop.sock_connect(sock=sock, address=address)
     return sock

python_socks/async_/asyncio/_proxy.py

@@ -2,6 +2,7 @@ import asyncio
 import socket
 import sys
 from typing import Any, Optional
+import warnings
 
 from ..._types import ProxyType
 from ..._helpers import parse_proxy_url
@@ -58,23 +59,39 @@ class AsyncioProxy:
             timeout = DEFAULT_TIMEOUT
 
         _socket = kwargs.get('_socket')
+        if _socket is not None:
+            warnings.warn(
+                "The '_socket' argument is deprecated and will be removed in the future",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        local_addr = kwargs.get('local_addr')
         try:
             async with async_timeout.timeout(timeout):
                 return await self._connect(
                     dest_host=dest_host,
                     dest_port=dest_port,
                     _socket=_socket,
+                    local_addr=local_addr,
                 )
         except asyncio.TimeoutError as e:
             raise ProxyTimeoutError(f'Proxy connection timed out: {timeout}') from e
 
-    async def _connect(self, dest_host, dest_port, _socket=None) -> socket.socket:
+    async def _connect(
+        self,
+        dest_host,
+        dest_port,
+        _socket=None,
+        local_addr=None,
+    ) -> socket.socket:
         if _socket is None:
             try:
                 _socket = await connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
                     loop=self._loop,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 msg = 'Could not connect to proxy {}:{} [{}]'.format(
@@ -101,42 +118,13 @@ class AsyncioProxy:
             )
 
             return _socket
-        except asyncio.CancelledError:  # pragma: no cover
-            # https://bugs.python.org/issue30064
-            # https://bugs.python.org/issue34795
-            if self._can_be_closed_safely():
-                await stream.close()
-            raise
         except ReplyError as e:
             await stream.close()
             raise ProxyError(e, error_code=e.error_code)
-        except Exception:  # pragma: no cover
+        except (asyncio.CancelledError, Exception):  # pragma: no cover
             await stream.close()
             raise
 
-    def _can_be_closed_safely(self):  # pragma: no cover
-        def is_proactor_event_loop():
-            try:
-                # pylint:disable-next=import-outside-toplevel
-                from asyncio import ProactorEventLoop
-            except ImportError:
-                return False
-            return isinstance(self._loop, ProactorEventLoop)
-
-        def is_uvloop_event_loop():
-            try:
-                # pylint:disable-next=import-outside-toplevel
-                from uvloop import Loop  # type:ignore[import-not-found]
-            except ImportError:
-                return False
-            return isinstance(self._loop, Loop)
-
-        return (
-            sys.version_info[:2] >= (3, 8)
-            or is_proactor_event_loop()
-            or is_uvloop_event_loop()
-        )
-
     @property
     def proxy_host(self):
         return self._proxy_host
@@ -150,6 +138,6 @@ class AsyncioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'AsyncioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/async_/asyncio/v2/_chain.py

@@ -1,9 +1,15 @@
 from typing import Sequence
+import warnings
 from ._proxy import AsyncioProxy
 
 
 class ProxyChain:
     def __init__(self, proxies: Sequence[AsyncioProxy]):
+        warnings.warn(
+            'This implementation of ProxyChain is deprecated and will be removed in the future',
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._proxies = proxies
 
     async def connect(

python_socks/async_/asyncio/v2/_connect.py

@@ -16,7 +16,7 @@ async def connect_tcp(
     reader, writer = await asyncio.open_connection(
         host=host,
         port=port,
-        **kwargs,
+        **kwargs,  # type: ignore
     )
 
     return AsyncioSocketStream(

python_socks/async_/asyncio/v2/_proxy.py

@@ -1,6 +1,6 @@
 import asyncio
 import ssl
-from typing import Optional
+from typing import Any, Optional, Tuple
 import warnings
 import sys
 
@@ -68,27 +68,29 @@ class AsyncioProxy:
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
         timeout: Optional[float] = None,
+        **kwargs: Any,
     ) -> AsyncioSocketStream:
         if timeout is None:
             timeout = DEFAULT_TIMEOUT
 
+        local_addr = kwargs.get('local_addr')
         try:
             async with async_timeout.timeout(timeout):
                 return await self._connect(
                     dest_host=dest_host,
                     dest_port=dest_port,
                     dest_ssl=dest_ssl,
+                    local_addr=local_addr,
                 )
         except asyncio.TimeoutError as e:
-            raise ProxyTimeoutError(
-                'Proxy connection timed out: {}'.format(timeout)
-            ) from e
+            raise ProxyTimeoutError('Proxy connection timed out: {}'.format(timeout)) from e
 
     async def _connect(
         self,
         dest_host: str,
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
+        local_addr: Optional[Tuple[str, int]] = None,
     ) -> AsyncioSocketStream:
         if self._forward is None:
             try:
@@ -96,6 +98,7 @@ class AsyncioProxy:
                     host=self._proxy_host,
                     port=self._proxy_port,
                     loop=self._loop,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 raise ProxyConnectionError(
@@ -149,6 +152,6 @@ class AsyncioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'AsyncioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/async_/asyncio/v2/_stream.py

@@ -6,48 +6,10 @@ from .... import _abc as abc
 DEFAULT_RECEIVE_SIZE = 65536
 
 
-# noinspection PyUnusedLocal
-async def backport_start_tls(
-    transport,
-    protocol,
-    ssl_context,
-    *,
-    server_side=False,
-    server_hostname=None,
-    ssl_handshake_timeout=None,
-):  # pragma: no cover
-    """
-    Python 3.6 asyncio doesn't have a start_tls() method on the loop,
-    so we use this function in place of the loop's start_tls() method.
-    Adapted from this comment:
-    https://github.com/urllib3/urllib3/issues/1323#issuecomment-362494839
-    """
-    import asyncio.sslproto
-
-    loop = asyncio.get_event_loop()
-    waiter = loop.create_future()
-    ssl_protocol = asyncio.sslproto.SSLProtocol(
-        loop,
-        protocol,
-        ssl_context,
-        waiter,
-        server_side=False,
-        server_hostname=server_hostname,
-        call_connection_made=False,
-    )
-
-    transport.set_protocol(ssl_protocol)
-    loop.call_soon(ssl_protocol.connection_made, transport)
-    loop.call_soon(transport.resume_reading)  # type: ignore
-
-    await waiter
-    return ssl_protocol._app_transport  # noqa
-
-
 class AsyncioSocketStream(abc.AsyncSocketStream):
-    _loop: asyncio.AbstractEventLoop = None
-    _reader: asyncio.StreamReader = None
-    _writer: asyncio.StreamWriter = None
+    _loop: asyncio.AbstractEventLoop
+    _reader: asyncio.StreamReader
+    _writer: asyncio.StreamWriter
 
     def __init__(
         self,
@@ -86,9 +48,7 @@ class AsyncioSocketStream(abc.AsyncSocketStream):
         reader = asyncio.StreamReader()
         protocol = asyncio.StreamReaderProtocol(reader)
 
-        loop_start_tls = getattr(self._loop, 'start_tls', backport_start_tls)
-
-        transport = await loop_start_tls(
+        transport: asyncio.Transport = await self._loop.start_tls(
             self._writer.transport,  # type: ignore
             protocol,
             ssl_context,
@@ -115,7 +75,7 @@ class AsyncioSocketStream(abc.AsyncSocketStream):
         # When we return a new SocketStream with new StreamReader/StreamWriter instances
         # we need to keep references to the old StreamReader/StreamWriter so that they
         # are not garbage collected and closed while we're still using them.
-        stream._inner = self  # type: ignore
+        stream._inner = self  # type: ignore # pylint:disable=W0212,W0201
         return stream
 
     async def close(self):

python_socks/async_/curio/_proxy.py

@@ -1,4 +1,5 @@
 from typing import Any, Optional
+import warnings
 import curio
 import curio.io
 
@@ -47,7 +48,14 @@ class CurioProxy:
             timeout = DEFAULT_TIMEOUT
 
         _socket = kwargs.get('_socket')
+        if _socket is not None:
+            warnings.warn(
+                "The '_socket' argument is deprecated and will be removed in the future",
+                DeprecationWarning,
+                stacklevel=2,
+            )
 
+        local_addr = kwargs.get('local_addr')
         try:
             return await curio.timeout_after(
                 timeout,
@@ -55,6 +63,7 @@ class CurioProxy:
                 dest_host,
                 dest_port,
                 _socket,
+                local_addr,
             )
         except curio.TaskTimeout as e:
             raise ProxyTimeoutError(f'Proxy connection timed out: {timeout}') from e
@@ -64,12 +73,14 @@ class CurioProxy:
         dest_host: str,
         dest_port: int,
         _socket=None,
+        local_addr=None,
     ):
         if _socket is None:
             try:
                 _socket = await connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 msg = 'Could not connect to proxy {}:{} [{}]'.format(
@@ -116,6 +127,6 @@ class CurioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'CurioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/async_/trio/_proxy.py

@@ -1,4 +1,5 @@
 from typing import Any, Optional
+import warnings
 import trio
 
 from ..._types import ProxyType
@@ -46,30 +47,38 @@ class TrioProxy:
             timeout = DEFAULT_TIMEOUT
 
         _socket = kwargs.get('_socket')
+        if _socket is not None:
+            warnings.warn(
+                "The '_socket' argument is deprecated and will be removed in the future",
+                DeprecationWarning,
+                stacklevel=2,
+            )
 
+        local_addr = kwargs.get('local_addr')
         try:
             with trio.fail_after(timeout):
                 return await self._connect(
                     dest_host=dest_host,
                     dest_port=dest_port,
                     _socket=_socket,
+                    local_addr=local_addr,
                 )
         except trio.TooSlowError as e:
-            raise ProxyTimeoutError(
-                'Proxy connection timed out: {}'.format(timeout)
-            ) from e
+            raise ProxyTimeoutError('Proxy connection timed out: {}'.format(timeout)) from e
 
     async def _connect(
         self,
         dest_host: str,
         dest_port: int,
         _socket=None,
+        local_addr=None,
     ) -> trio.socket.SocketType:
         if _socket is None:
             try:
                 _socket = await connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 msg = 'Could not connect to proxy {}:{} [{}]'.format(
@@ -117,6 +126,6 @@ class TrioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'TrioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/async_/trio/v2/_chain.py

@@ -1,9 +1,15 @@
 from typing import Sequence
+import warnings
 from ._proxy import TrioProxy
 
 
 class ProxyChain:
     def __init__(self, proxies: Sequence[TrioProxy]):
+        warnings.warn(
+            'This implementation of ProxyChain is deprecated and will be removed in the future',
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._proxies = proxies
 
     async def connect(

python_socks/async_/trio/v2/_connect.py

@@ -1,4 +1,4 @@
-from typing import Optional, Tuple
+from typing import Optional
 
 import trio
 from ._stream import TrioSocketStream
@@ -7,7 +7,7 @@ from ._stream import TrioSocketStream
 async def connect_tcp(
     host: str,
     port: int,
-    local_addr: Optional[Tuple[str, int]] = None,
+    local_addr: Optional[str] = None,
 ) -> TrioSocketStream:
     trio_stream = await trio.open_tcp_stream(
         host=host,

python_socks/async_/trio/v2/_proxy.py

@@ -1,5 +1,5 @@
 import ssl
-from typing import Optional
+from typing import Any, Optional
 
 import trio
 
@@ -47,16 +47,19 @@ class TrioProxy:
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
         timeout: Optional[float] = None,
+        **kwargs: Any,
     ) -> TrioSocketStream:
         if timeout is None:
             timeout = DEFAULT_TIMEOUT
 
+        local_addr = kwargs.get('local_addr')
         try:
             with trio.fail_after(timeout):
                 return await self._connect(
                     dest_host=dest_host,
                     dest_port=dest_port,
                     dest_ssl=dest_ssl,
+                    local_addr=local_addr,
                 )
         except trio.TooSlowError as e:
             raise ProxyTimeoutError(f'Proxy connection timed out: {timeout}') from e
@@ -66,12 +69,14 @@ class TrioProxy:
         dest_host: str,
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
+        local_addr: Optional[str] = None,
     ) -> TrioSocketStream:
         if self._forward is None:
             try:
                 stream = await connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 raise ProxyConnectionError(
@@ -125,6 +130,6 @@ class TrioProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'TrioProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/sync/_chain.py

@@ -1,9 +1,15 @@
 from typing import Iterable
+import warnings
 from ._proxy import SyncProxy
 
 
 class ProxyChain:
     def __init__(self, proxies: Iterable[SyncProxy]):
+        warnings.warn(
+            'This implementation of ProxyChain is deprecated and will be removed in the future',
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._proxies = proxies
 
     def connect(self, dest_host, dest_port, timeout=None):
@@ -16,14 +22,11 @@ class ProxyChain:
                 dest_host=proxies[i + 1].proxy_host,
                 dest_port=proxies[i + 1].proxy_port,
                 timeout=timeout,
-                _socket=curr_socket
+                _socket=curr_socket,
             )
 
         curr_socket = proxies[length].connect(
-            dest_host=dest_host,
-            dest_port=dest_port,
-            timeout=timeout,
-            _socket=curr_socket
+            dest_host=dest_host, dest_port=dest_port, timeout=timeout, _socket=curr_socket
         )
 
         return curr_socket

python_socks/sync/_connect.py

@@ -5,7 +5,7 @@ from typing import Optional, Tuple
 def connect_tcp(
     host: str,
     port: int,
-    timeout: float = None,
+    timeout: Optional[float] = None,
     local_addr: Optional[Tuple[str, int]] = None,
 ) -> socket.socket:
     address = (host, port)

python_socks/sync/_proxy.py

@@ -1,5 +1,6 @@
 import socket
 from typing import Optional, Any
+import warnings
 
 from .._errors import ProxyConnectionError, ProxyTimeoutError, ProxyError
 
@@ -46,13 +47,21 @@ class SyncProxy:
             timeout = DEFAULT_TIMEOUT
 
         _socket = kwargs.get('_socket')
+        if _socket is not None:
+            warnings.warn(
+                "The '_socket' argument is deprecated and will be removed in the future",
+                DeprecationWarning,
+                stacklevel=2,
+            )
 
         if _socket is None:
+            local_addr = kwargs.get('local_addr')
             try:
                 _socket = connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
                     timeout=timeout,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 msg = 'Could not connect to proxy {}:{} [{}]'.format(
@@ -81,9 +90,7 @@ class SyncProxy:
             return _socket
         except socket.timeout as e:
             stream.close()
-            raise ProxyTimeoutError(
-                'Proxy connection timed out: {}'.format(timeout)
-            ) from e
+            raise ProxyTimeoutError('Proxy connection timed out: {}'.format(timeout)) from e
         except ReplyError as e:
             stream.close()
             raise ProxyError(e, error_code=e.error_code)
@@ -104,6 +111,6 @@ class SyncProxy:
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'SyncProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

python_socks/sync/v2/_connect.py

@@ -6,7 +6,7 @@ from ._stream import SyncSocketStream
 def connect_tcp(
     host: str,
     port: int,
-    timeout: float = None,
+    timeout: Optional[float] = None,
     local_addr: Optional[Tuple[str, int]] = None,
 ) -> SyncSocketStream:
     address = (host, port)

python_socks/sync/v2/_proxy.py

@@ -1,6 +1,6 @@
 import socket
 import ssl
-from typing import Optional
+from typing import Any, Optional
 
 from ._connect import connect_tcp
 from ._stream import SyncSocketStream
@@ -45,16 +45,19 @@ class SyncProxy:
         dest_port: int,
         dest_ssl: Optional[ssl.SSLContext] = None,
         timeout: Optional[float] = None,
+        **kwargs: Any,
     ) -> SyncSocketStream:
         if timeout is None:
             timeout = DEFAULT_TIMEOUT
 
         if self._forward is None:
+            local_addr = kwargs.get('local_addr')
             try:
                 stream = connect_tcp(
                     host=self._proxy_host,
                     port=self._proxy_port,
                     timeout=timeout,
+                    local_addr=local_addr,
                 )
             except OSError as e:
                 msg = 'Could not connect to proxy {}:{} [{}]'.format(
@@ -109,10 +112,10 @@ class SyncProxy:
             raise
 
     @classmethod
-    def create(cls, *args, **kwargs): # for backward compatibility
+    def create(cls, *args, **kwargs):  # for backward compatibility
         return cls(*args, **kwargs)
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> 'SyncProxy':
         url_args = parse_proxy_url(url)
         return cls(*url_args, **kwargs)

{python_socks-2.6.0.dist-info → python_socks-2.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: python-socks
-Version: 2.6.0
+Version: 2.7.0
 Summary: Proxy (SOCKS4, SOCKS5, HTTP CONNECT) client for Python
 Author-email: Roman Snegirev <snegiryev@gmail.com>
 License: Apache-2.0

{python_socks-2.6.0.dist-info → python_socks-2.7.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
 python_socks/__init__.py,sha256=gKywvwx_x4_0hWJEa2eif1dPzP9YeFXJdrNlHuvFmC8,367
 python_socks/_abc.py,sha256=_juTZE0iqoTChE53IHjBKEYFO-fxYZfPhdUc6EgFlwE,909
-python_socks/_errors.py,sha256=l2j03Zna_EJhNqF3yApTYuQ147BcY0k74pkT4HAlRp4,245
+python_socks/_errors.py,sha256=UwMkTn-31DGdjQaL7Ba5ht3m1DUX0eqvC8MN-BXu4nE,248
 python_socks/_helpers.py,sha256=UacO07M9i8G8CfqzBYWnehgCTFbZTlwJWAsFoXR3mVk,2708
 python_socks/_types.py,sha256=dgQifNf2mIwdKoX7YmI91H_lUsW9-Y0ZkZGlIV6_NNw,90
-python_socks/_version.py,sha256=VDGUdSXYIOZqFTKm-y-mF5-8Rkwpzs--GH_DWxzC6pY,49
+python_socks/_version.py,sha256=v_xFnDqx2HbR5X4wOkhcjLVGOzc8LujUaPTxoI9n5Aw,49
 python_socks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_socks/_connectors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_socks/_connectors/abc.py,sha256=1fgjPiv64UAMiJDsJXYr-GofPGhuHTwTzaodQfrzf7Q,397
@@ -21,57 +21,57 @@ python_socks/_protocols/http.py,sha256=QhLHqBgc6DfsvC8AIhylN1tjfk7QzxgwemrK1LuL3
 python_socks/_protocols/socks4.py,sha256=j1Psqi3PDiKAF19g_Mh3sf_RwXu7o-8X7BqWOaoTbKE,3061
 python_socks/_protocols/socks5.py,sha256=1PEr1s4JxmpST9OYEeVgbidnV_d4Vb85JZHmWqK-r9c,9713
 python_socks/async_/__init__.py,sha256=TeBn5oirLy6aPoWcTc3OW9OxXh5Uv5LADwF_Y7f7HjY,64
-python_socks/async_/_proxy_chain.py,sha256=YZR5aNqqG358ynVe1F14k32hjK3yb19v_hh2On0gZ_I,781
+python_socks/async_/_proxy_chain.py,sha256=TiG1Uu45anONWi2ZFj11w4-LrNbja8SbG27bWCX9Et4,987
 python_socks/async_/anyio/__init__.py,sha256=pZnrND4Qd-pIGg7KI1ML41kZNkWHmkd3vrvwZZIJyk4,106
-python_socks/async_/anyio/_chain.py,sha256=EOXAd2w7OYEKsfugkvQpGKETej_80VeyjmZfH1_ZYZE,895
-python_socks/async_/anyio/_connect.py,sha256=6Qr_gh3FkPlGm1GrQq0DC1QupvPdXnWKd-Fniu0Kn9c,268
-python_socks/async_/anyio/_proxy.py,sha256=VSKRUIGmZE3hZC0PU6eyhidMA1Q9UrWSYLGQJsXr320,3960
+python_socks/async_/anyio/_chain.py,sha256=-d4sR-JM8Agh73rB8nK7DBcB9oqDgtx2GOTAx-SMslU,1099
+python_socks/async_/anyio/_connect.py,sha256=dYx-X2rDDTe-mtLm6DTpV-gFB7Vt_OYS1Xs_4Ea9JZ4,306
+python_socks/async_/anyio/_proxy.py,sha256=nWHzIFPYPXatmuVITdDWN6uoQe_P2Xm6NomgfgYm5UA,4322
 python_socks/async_/anyio/_resolver.py,sha256=LPRLmEzgKPGCqAbEMmLSMVtFkNVKha_2u08MhrZZ-CY,590
 python_socks/async_/anyio/_stream.py,sha256=OcCl4YkccA0-5hZh90CP4YmsBDLPwHpS3B0wCLytnAY,1614
 python_socks/async_/anyio/v2/__init__.py,sha256=4xgyAJHDGpRANYVNfpUdn3Zo8Ib_gREWH8bH4APycK4,117
-python_socks/async_/anyio/v2/_chain.py,sha256=baTCXD68hceOMWYITrUUSKv-B745RT4TdpQPDkSz68Y,593
-python_socks/async_/anyio/v2/_connect.py,sha256=wOOuUxURCjIWOH1pd8H6gr3XZ3VnvRtmsAh97M_ULEA,330
-python_socks/async_/anyio/v2/_proxy.py,sha256=lTIPQHTfGm8hV4N6gpbvC7QxxDBxrfi0EHuXqu-nWoA,3897
+python_socks/async_/anyio/v2/_chain.py,sha256=NZ_9dA1AQrG3pBOnYBszbtD-Kse85bQ_dT33VtmGx3o,797
+python_socks/async_/anyio/v2/_connect.py,sha256=_LF1f_cYJbfdSqkq-xEK4nF4l-bP5I1VWRFFyX1RH3Y,368
+python_socks/async_/anyio/v2/_proxy.py,sha256=7F-Y_xhVcqGnKjUDVnjYNkyz5VEFJjzZhkl0Xklyj9U,4085
 python_socks/async_/anyio/v2/_stream.py,sha256=40D3Pmb0rryk9gaQlmjpAMdiJi5H5O0xbBseblGG1FY,1616
 python_socks/async_/asyncio/__init__.py,sha256=0WAM07vy0YvI8IhKGmaUA0GaNLHaG3l-4mnJVbfoqHE,65
-python_socks/async_/asyncio/_connect.py,sha256=niNKiz2o1kfeIPVR3kXW7YHZ2sTK_Uehgq9tmFwbp7w,1014
-python_socks/async_/asyncio/_proxy.py,sha256=dHBoSOZuxFux5pClhPy_4yGoi5VvkNI9gJsMUJy29Ac,4689
+python_socks/async_/asyncio/_connect.py,sha256=gd2gzsp-RmbpMAPvEbG_bKyh1PRWemMajvBDg02G1hg,1042
+python_socks/async_/asyncio/_proxy.py,sha256=HS1NfXZCYOZ2b4qUee01CwH4NF1OcXPzqYxEJXYJeT8,4120
 python_socks/async_/asyncio/_resolver.py,sha256=ROqOncuIub87J9_nMdvRTG_5zYOh8uafk265z0s2ORQ,681
 python_socks/async_/asyncio/_stream.py,sha256=RP7BIP9iFFy5nLRf9kHH7s1h_zPfo0yoEVKNpExqFcI,1021
 python_socks/async_/asyncio/v2/__init__.py,sha256=v9eJQeZ2yGJHeBQ0FYqNmIMCRrB547QqoAANHVBitxY,108
-python_socks/async_/asyncio/v2/_chain.py,sha256=Yle3F3TKEpCo9Snd-T5hRnmfn9iWj2VNLb3UHz6yNiU,607
-python_socks/async_/asyncio/v2/_connect.py,sha256=b3kQBR7L6wp-yvWVwtcdb4JUdQV04JW-DXF1g1P3gxI,587
-python_socks/async_/asyncio/v2/_proxy.py,sha256=hgm276siuUn4nO5gK2iEaS12arvmVex1-Tz4NWNW_TM,4505
-python_socks/async_/asyncio/v2/_stream.py,sha256=dOvZPMLd0lHeZwlJIL-bK-PQN9sjM6urA5AyFXxdaas,3834
+python_socks/async_/asyncio/v2/_chain.py,sha256=KCtmKg0halaCIEqBY6JB-KGVNNiaa4APBb5l5z8kVPk,811
+python_socks/async_/asyncio/v2/_connect.py,sha256=3yPmPCNmMKlCCZZCnNvydER3ilnfE5gTevzBN7IoGEE,603
+python_socks/async_/asyncio/v2/_proxy.py,sha256=QPMx2nFeHCKObBkDqzONkgf2VLXdhuP-aMsBWAgdf-I,4714
+python_socks/async_/asyncio/v2/_stream.py,sha256=YdpJap_Ax-7tJnA-AJ7nayZmD5lpem2UIPbUepnzqxM,2753
 python_socks/async_/curio/__init__.py,sha256=1OyhLhvLJ23iDROgyxGqQACice66SrIYCMqmwjw_dqY,63
 python_socks/async_/curio/_connect.py,sha256=u1HRJ8n3OZbux-wETO9HuqZv9By2LGhhSsM78gnxr_0,328
-python_socks/async_/curio/_proxy.py,sha256=2JRxx8SQvGPAHKGgf9OImH_X2Gfhxxzb5brNkmq7KhM,3241
+python_socks/async_/curio/_proxy.py,sha256=_Qgodw62VPvt-5j1T34l7P52R5Bk4Crq97QJ0f1Qf10,3644
 python_socks/async_/curio/_resolver.py,sha256=_jDZq_lzTl_QihxH2HNEY_7_ELo-qmzG6IO5PNNEOek,722
 python_socks/async_/curio/_stream.py,sha256=sIAbwkPuiFF4c8cEs7exVdGb7cfFgoggKTV4LYqDcm0,855
 python_socks/async_/trio/__init__.py,sha256=Y68xwGqkXGKXHcwM6nvev6n2ChbFpBUFW0RzBrsIrug,61
 python_socks/async_/trio/_connect.py,sha256=uN_qwxLWdvy2zclPw5Z8R5TPqgT6jjzzTcSHd-xGFas,783
-python_socks/async_/trio/_proxy.py,sha256=F2jMJ_41__3YgNXrOWafgcZY0aW0g6c7rdJuIb7GbGk,3399
+python_socks/async_/trio/_proxy.py,sha256=yp3NJOTAaw2ReXlPt4fBRY51Xqc1C3tf16H3v0XvlCg,3786
 python_socks/async_/trio/_resolver.py,sha256=uqBoTkbYpwwESoph2SmXRUUHM_DsT7dALQDmKqp-sco,591
 python_socks/async_/trio/_stream.py,sha256=xunx_XUiwH1pBLQjWbkqq3P92SeXaRypPMPRYwHOsPg,1003
 python_socks/async_/trio/v2/__init__.py,sha256=cd8Sc6NLmrUZewkqeDvnxmQqGZBKNuwYEEb4NMW2qo0,116
-python_socks/async_/trio/v2/_chain.py,sha256=sf32gS-flmzVe60b83LtwOhbzvlm1s7gPlgIpAbW1hM,591
-python_socks/async_/trio/v2/_connect.py,sha256=9B7cpLC9HqrXdW-61jA8hGRspHuIgaLTniZyCqpSiPE,379
-python_socks/async_/trio/v2/_proxy.py,sha256=8BmeQRJkxM1bMJFvWdQqeSs_MDRp3DIPsLBAtb6X_FU,3877
+python_socks/async_/trio/v2/_chain.py,sha256=g9atl9HcWYrCHLCI8GtLR9GZC67sKiXEjcvGwZVGhDw,795
+python_socks/async_/trio/v2/_connect.py,sha256=Nk0ipvuFFnzH-NPfXkX57I74-sbT6ks--ZgbfN3r42o,360
+python_socks/async_/trio/v2/_proxy.py,sha256=9118wyv9SthZNVlvECfb3OfhrPMOFyyJSHhl7lG0TbI,4094
 python_socks/async_/trio/v2/_stream.py,sha256=wGB7sDjRO1ywVNjF_DFgdF2orjD3zrh8dPSmW9aBEV0,1475
 python_socks/sync/__init__.py,sha256=Dslh61MLGktjBK50UVGYjAQ-iGl8tjoLR93_-cvddWM,106
-python_socks/sync/_chain.py,sha256=TJeIQmvCw5Z0slBQOD0V9mibC5jbM9pDD_xjlyYgHFs,804
-python_socks/sync/_connect.py,sha256=5i834THkhSTOwgIvzWNihHYGwxNv7JIr3aCnaXU1SLY,334
-python_socks/sync/_proxy.py,sha256=A4FKY9a28zrTsNEJfy3tUjfGQvQcFKpq77Xce8OKBfw,2964
+python_socks/sync/_chain.py,sha256=do_WtGenqKAG7B50nNZdltFqEQV8t-mSlGnMACNIwgE,973
+python_socks/sync/_connect.py,sha256=N1Y-uQXkOiJ_dxkwWHw1fBliIQlTL47ydql7IvaSqm8,344
+python_socks/sync/_proxy.py,sha256=Ny2QA8GI2aCUm0JL8IfY2j2IaXKzAZNp6bZeF7OmwYA,3287
 python_socks/sync/_resolver.py,sha256=2rf9-NdjRktYrab1Oyv9ZJLKByP95ysFmRE3TgjRCSA,547
 python_socks/sync/_stream.py,sha256=x01ovajA0DAjHkBCxpMeFaWYjns9BljgBQ-GGyBqrw4,818
 python_socks/sync/v2/__init__.py,sha256=eVZc6zh0pLhNMf_uSPZiH_1vNGEvedwzX5gObUSkRT8,116
 python_socks/sync/v2/_chain.py,sha256=IRVMioTVWwxylZ8maD5Gqxhhgw4VyrG5vo_hAOuEn8Q,579
-python_socks/sync/v2/_connect.py,sha256=eqMKsH2wVnGZhV24_t9QfsNhjbnKtnipj7wzSNctM3Q,410
-python_socks/sync/v2/_proxy.py,sha256=kklPAuHxhqJ9uwFgT-KLhPZxqOmonJcF6evpELvqCQU,3484
+python_socks/sync/v2/_connect.py,sha256=QrZ1CZimYCUMUuaD8JdUblwlqlzIbqFrbsPwMzoxGkM,420
+python_socks/sync/v2/_proxy.py,sha256=7FuO6wML0DkEonoGAprhTlVd8fazOgNeNrJyxABmP1Q,3621
 python_socks/sync/v2/_ssl_transport.py,sha256=MURwzvKu-S2-MI7o8KaZTvvBFOiiKIu5R0ERVIMvERE,6088
 python_socks/sync/v2/_stream.py,sha256=Jq89x1xmIX3L_v-WyS1nRTItjTnYTcDcfDblsANxfJI,1544
-python_socks-2.6.0.dist-info/LICENSE.txt,sha256=tAkwu8-AdEyGxGoSvJ2gVmQdcicWw3j1ZZueVV74M-E,11357
-python_socks-2.6.0.dist-info/METADATA,sha256=pTdgOXsEuObKYZAQkOOxpM1-2vAtF-klRPZtrqhSugQ,7964
-python_socks-2.6.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-python_socks-2.6.0.dist-info/top_level.txt,sha256=7qyDAVwjTZ0sIYG1iatFbE-SLpWhONjaoMQ0Ib2DX0Q,13
-python_socks-2.6.0.dist-info/RECORD,,
+python_socks-2.7.0.dist-info/LICENSE.txt,sha256=tAkwu8-AdEyGxGoSvJ2gVmQdcicWw3j1ZZueVV74M-E,11357
+python_socks-2.7.0.dist-info/METADATA,sha256=9oFucZVJgmHybD1FBfPNxM3fEbheWmQpJkll1smw1mI,7964
+python_socks-2.7.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+python_socks-2.7.0.dist-info/top_level.txt,sha256=7qyDAVwjTZ0sIYG1iatFbE-SLpWhONjaoMQ0Ib2DX0Q,13
+python_socks-2.7.0.dist-info/RECORD,,

{python_socks-2.6.0.dist-info → python_socks-2.7.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any