refactor(python-sdk): own the ProxyTypes alias

`ProxyTypes` — the public type of the `proxy` option — came from httpx's
private `_types` module, imported at runtime in eleven modules. It is defined
there as `Union["URL", str, "Proxy"]`, exactly the three forms the SDK's two
narrowers accept, so spell it out once in `e2b.connection_config` and import
it from there instead. Same public name, same type to a type checker, no
private-module dependency, and a place for a pyqwest proxy type to land as the
transports move off httpx.

`e2b.envd.client_shared.proxy_to_url` took a bare `object` while
`e2b.api.proxy_to_config` took `Optional[ProxyTypes]`; both now say the same
thing. Keeping `isinstance` narrowing rather than duck-typing `.url`/`.auth`
is deliberate: httpx is a required dependency here (the generated REST client
is an httpx client and envd file transfers use httpx directly), so probing
attributes would trade a clear `InvalidArgumentException` on a mistyped
argument for no dependency savings.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: mishushakov

packages/python-sdk/e2b/api/__init__.py

@@ -8,13 +8,12 @@
 
 import httpx
 from httpx import AsyncBaseTransport, BaseTransport, Limits, Timeout
-from httpx._types import ProxyTypes
 from pyqwest import Proxy
 
 from e2b.api.client.client import AuthenticatedClient
 from e2b.api.client.types import Response
 from e2b.api.metadata import default_headers
-from e2b.connection_config import ConnectionConfig
+from e2b.connection_config import ConnectionConfig, ProxyTypes
 from e2b.exceptions import (
     AuthenticationException,
     InvalidArgumentException,

packages/python-sdk/e2b/api/client_async/__init__.py

@@ -5,7 +5,6 @@
 
 import httpx
 
-from httpx._types import ProxyTypes
 from pyqwest import HTTPTransport, Request, Response
 from pyqwest.httpx import AsyncPyqwestTransport
 from pyqwest.middleware.retry import RetryTransport
@@ -19,7 +18,7 @@
     pool_max_idle_per_host,
     proxy_to_config,
 )
-from e2b.connection_config import ConnectionConfig
+from e2b.connection_config import ConnectionConfig, ProxyTypes
 
 TransportKey = Tuple[bool, Optional[ProxyTypes]]
 

packages/python-sdk/e2b/api/client_sync/__init__.py

@@ -3,7 +3,6 @@
 import httpx
 import threading
 
-from httpx._types import ProxyTypes
 from pyqwest import SyncHTTPTransport, SyncRequest, SyncResponse
 from pyqwest.httpx import PyqwestTransport
 from pyqwest.middleware.retry import SyncRetryTransport
@@ -17,7 +16,7 @@
     pool_max_idle_per_host,
     proxy_to_config,
 )
-from e2b.connection_config import ConnectionConfig
+from e2b.connection_config import ConnectionConfig, ProxyTypes
 
 TransportKey = Tuple[bool, Optional[ProxyTypes]]
 

packages/python-sdk/e2b/connection_config.py

@@ -1,14 +1,24 @@
 import logging
 import os
 
-from typing import cast, Optional, Dict, TypedDict
+from typing import cast, Optional, Dict, TypedDict, Union
 
-from httpx._types import ProxyTypes
+import httpx
 from typing_extensions import Unpack
 
 from e2b.api.metadata import package_version
 from e2b.sandbox_domains import is_supported_sandbox_domain
 
+ProxyTypes = Union[str, httpx.URL, httpx.Proxy]
+"""The forms the ``proxy`` option accepts: a URL string, an ``httpx.URL``, or
+an ``httpx.Proxy``.
+
+Identical to ``httpx._types.ProxyTypes``, spelled out here so the SDK doesn't
+import httpx's private module at runtime — and so the union can grow a pyqwest
+proxy type as the transports move off httpx. The functions that narrow it are
+:func:`e2b.api.proxy_to_config` and :func:`e2b.envd.client_shared.proxy_to_url`.
+"""
+
 REQUEST_TIMEOUT: float = 60.0  # 60 seconds
 
 KEEPALIVE_PING_INTERVAL_SEC = 50  # 50 seconds

packages/python-sdk/e2b/envd/client_shared.py

@@ -23,6 +23,7 @@
 from connectrpc.errors import ConnectError
 from protobuf import Message
 
+from e2b.connection_config import ProxyTypes
 from e2b.exceptions import InvalidArgumentException
 
 # Mirror the httpx pool tuning in `e2b.api.limits` with pyqwest's equivalents.
@@ -170,7 +171,7 @@ class _RPCCompression(TypedDict):
 }
 
 
-def proxy_to_url(proxy: object) -> Optional[str]:
+def proxy_to_url(proxy: Optional[ProxyTypes]) -> Optional[str]:
     """Narrow the ``proxy`` connection option to the proxy URL string pyqwest
     transports take (scheme http, https, socks5, or socks5h, credentials in
     the URL userinfo). ``httpx.URL`` and ``httpx.Proxy`` — which the REST

packages/python-sdk/e2b/volume/client_async/__init__.py

@@ -5,10 +5,10 @@
 
 import httpx
 from httpx import Limits
-from httpx._types import ProxyTypes
 
 from e2b.api import connection_retries, make_async_logging_event_hooks
 from e2b.api.metadata import default_headers
+from e2b.connection_config import ProxyTypes
 from e2b.exceptions import AuthenticationException
 from e2b.volume.client.client import AuthenticatedClient as AsyncVolumeApiClient
 from e2b.volume.connection_config import VolumeConnectionConfig

packages/python-sdk/e2b/volume/client_sync/__init__.py

@@ -4,10 +4,10 @@
 
 import httpx
 from httpx import Limits
-from httpx._types import ProxyTypes
 
 from e2b.api import connection_retries, make_logging_event_hooks
 from e2b.api.metadata import default_headers
+from e2b.connection_config import ProxyTypes
 from e2b.exceptions import AuthenticationException
 from e2b.volume.client.client import AuthenticatedClient as VolumeApiClient
 from e2b.volume.connection_config import VolumeConnectionConfig

packages/python-sdk/e2b/volume/connection_config.py

@@ -3,10 +3,10 @@
 
 from typing import Dict, Optional, TypedDict
 
-from httpx._types import ProxyTypes
 from typing_extensions import Unpack
 
 from e2b.api.metadata import package_version
+from e2b.connection_config import ProxyTypes
 
 REQUEST_TIMEOUT: float = 60.0  # 60 seconds
 

packages/python-sdk/e2b/volume/volume_async.py

@@ -3,7 +3,6 @@
 
 import httpx
 
-from httpx._types import ProxyTypes
 from typing_extensions import Unpack
 
 from e2b.api import handle_api_exception
@@ -19,7 +18,7 @@
 )
 from e2b.api.client.types import Response
 from e2b.api.client_async import get_api_client as get_core_api_client
-from e2b.connection_config import ApiParams, ConnectionConfig
+from e2b.connection_config import ApiParams, ConnectionConfig, ProxyTypes
 from e2b.exceptions import NotFoundException, VolumeException
 from e2b.volume.client.api.volumes import (
     get_volumecontent_volume_id_path as get_path,

packages/python-sdk/e2b/volume/volume_sync.py

@@ -4,7 +4,6 @@
 
 import httpx
 
-from httpx._types import ProxyTypes
 from typing_extensions import Unpack
 
 from e2b.api import handle_api_exception
@@ -20,7 +19,7 @@
 )
 from e2b.api.client.types import Response
 from e2b.api.client_sync import get_api_client as get_core_api_client
-from e2b.connection_config import ApiParams, ConnectionConfig
+from e2b.connection_config import ApiParams, ConnectionConfig, ProxyTypes
 from e2b.exceptions import NotFoundException, VolumeException
 from e2b.volume.client.api.volumes import (
     get_volumecontent_volume_id_path as get_path,