Add urllib3.contrib.socks; improve urllib3.connectionpool

stubs/urllib3/urllib3/contrib/socks.pyi

@@ -0,0 +1,40 @@
+from typing_extensions import TypedDict
+from typing import Any, ClassVar, Mapping
+
+from ..connection import HTTPConnection, HTTPSConnection
+from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool
+from ..poolmanager import PoolManager
+
+class _SockOptions(TypedDict):
+    socks_version: int
+    proxy_host: str | None
+    proxy_port: str | None
+    username: str | None
+    password: str | None
+    rdns: bool
+
+class SOCKSConnection(HTTPConnection):
+    def __init__(self, _socks_options: _SockOptions, *args: Any, **kwargs: Any) -> None: ...
+    def _new_conn(self) -> Any: ...  # "socks.socksocket":
+
+class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection): ...
+class SOCKSHTTPConnectionPool(HTTPConnectionPool): ...
+class SOCKSHTTPSConnectionPool(HTTPSConnectionPool): ...
+
+class _ConnectionPoolClasses(TypedDict):
+    http: type[SOCKSHTTPSConnectionPool]
+    https: type[SOCKSHTTPSConnectionPool]
+
+class SOCKSProxyManager(PoolManager):
+    pool_classes_by_scheme: ClassVar[_ConnectionPoolClasses]
+    proxy_url: str
+
+    def __init__(
+        self,
+        proxy_url: str,
+        username: str | None = ...,
+        password: str | None = ...,
+        num_pools: int = ...,
+        headers: Mapping[str, str] | None = ...,
+        **connection_pool_kw: Any,
+    ) -> None: ...