etlplus 0.16.4__tar.gz → 0.16.6__tar.gz

{etlplus-0.16.4/etlplus.egg-info → etlplus-0.16.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etlplus
-Version: 0.16.4
+Version: 0.16.6
 Summary: A Swiss Army knife for simple ETL operations
 Home-page: https://github.com/Dagitali/ETLPlus
 Author: ETLPlus Team

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/__init__.py

@@ -79,21 +79,21 @@ from .config import ApiProfileConfig
 from .config import EndpointConfig
 from .endpoint_client import EndpointClient
 from .enums import HttpMethod
-from .pagination import CursorPaginationConfigMap
-from .pagination import PagePaginationConfigMap
+from .pagination import CursorPaginationConfigDict
+from .pagination import PagePaginationConfigDict
 from .pagination import PaginationClient
 from .pagination import PaginationConfig
-from .pagination import PaginationConfigMap
+from .pagination import PaginationConfigDict
 from .pagination import PaginationType
 from .pagination import Paginator
 from .rate_limiting import RateLimitConfig
-from .rate_limiting import RateLimitConfigMap
+from .rate_limiting import RateLimitConfigDict
 from .rate_limiting import RateLimiter
 from .retry_manager import RetryManager
-from .retry_manager import RetryPolicy
+from .retry_manager import RetryPolicyDict
 from .retry_manager import RetryStrategy
-from .transport import HTTPAdapterMountConfig
-from .transport import HTTPAdapterRetryConfig
+from .transport import HTTPAdapterMountConfigDict
+from .transport import HTTPAdapterRetryConfigDict
 from .transport import build_http_adapter
 from .types import Headers
 from .types import Params
@@ -133,14 +133,14 @@ __all__ = [
     'paginate_with_client',
     'resolve_request',
     # Type Aliases
-    'CursorPaginationConfigMap',
+    'CursorPaginationConfigDict',
     'Headers',
-    'HTTPAdapterMountConfig',
-    'HTTPAdapterRetryConfig',
-    'PagePaginationConfigMap',
-    'PaginationConfigMap',
+    'HTTPAdapterMountConfigDict',
+    'HTTPAdapterRetryConfigDict',
+    'PagePaginationConfigDict',
+    'PaginationConfigDict',
     'Params',
-    'RateLimitConfigMap',
-    'RetryPolicy',
+    'RateLimitConfigDict',
+    'RetryPolicyDict',
     'Url',
 ]

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/auth.py

@@ -76,13 +76,16 @@ FORM_HEADERS = MappingProxyType(
 # SECTION: TYPED DICTS ====================================================== #
 
 
-class _TokenResponse(TypedDict):
+class _TokenResponseDict(TypedDict):
     """Minimal shape of an OAuth token response body."""
 
     access_token: str
     expires_in: int | float
 
 
+# SECTION: PROTOCOLS ======================================================== #
+
+
 class _TokenHttpClient(Protocol):
     """Protocol for objects that expose a ``post`` helper like ``requests``."""
 
@@ -284,7 +287,7 @@ class EndpointCredentialsBearer(AuthBase):
     def _parse_token_response(
         self,
         resp: Response,
-    ) -> _TokenResponse:
+    ) -> _TokenResponseDict:
         """
         Validate the JSON token response and return a typed mapping.
 
@@ -295,7 +298,7 @@ class EndpointCredentialsBearer(AuthBase):
 
         Returns
         -------
-        _TokenResponse
+        _TokenResponseDict
             Parsed token response mapping.
 
         Raises
@@ -335,15 +338,15 @@ class EndpointCredentialsBearer(AuthBase):
         except (TypeError, ValueError):
             ttl = float(DEFAULT_TOKEN_TTL)
 
-        return _TokenResponse(access_token=token, expires_in=ttl)
+        return _TokenResponseDict(access_token=token, expires_in=ttl)
 
-    def _request_token(self) -> _TokenResponse:
+    def _request_token(self) -> _TokenResponseDict:
         """
         Execute the OAuth2 token request and parse the response.
 
         Returns
         -------
-        _TokenResponse
+        _TokenResponseDict
             Parsed token response mapping.
 
         Raises

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/config.py

@@ -36,9 +36,9 @@ from .pagination import PaginationConfig
 from .rate_limiting import RateLimitConfig
 
 if TYPE_CHECKING:
-    from .types import ApiConfigMap
-    from .types import ApiProfileConfigMap
-    from .types import EndpointMap
+    from .types import ApiConfigDict
+    from .types import ApiProfileConfigDict
+    from .types import EndpointConfigDict
 
 
 # SECTION: EXPORTS ========================================================== #
@@ -264,7 +264,7 @@ class ApiProfileConfig:
     @overload
     def from_obj(
         cls,
-        obj: ApiProfileConfigMap,
+        obj: ApiProfileConfigDict,
     ) -> Self: ...
 
     @classmethod
@@ -460,7 +460,7 @@ class ApiConfig:
     @overload
     def from_obj(
         cls,
-        obj: ApiConfigMap,
+        obj: ApiConfigDict,
     ) -> Self: ...
 
     @classmethod
@@ -577,7 +577,7 @@ class EndpointConfig:
     @overload
     def from_obj(
         cls,
-        obj: EndpointMap,
+        obj: EndpointConfigDict,
     ) -> Self: ...
 
     @classmethod

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/endpoint_client.py

@@ -11,8 +11,8 @@ Notes
 -----
 - Retry-related types live in :mod:`etlplus.api.retry_manager`.
 - Pagination requires a ``PaginationConfig``; see
-    :class:`PagePaginationConfigMap` and :class:`CursorPaginationConfigMap` for
-    the accepted shapes.
+    :class:`PagePaginationConfigDict` and :class:`CursorPaginationConfigDict`
+    for the accepted shapes.
 
 Examples
 --------
@@ -65,14 +65,14 @@ from .errors import PaginationError
 from .pagination import PaginationClient
 from .pagination import PaginationInput
 from .pagination import Paginator
-from .rate_limiting import RateLimitConfigMap
+from .rate_limiting import RateLimitConfigDict
 from .rate_limiting import RateLimiter
 from .rate_limiting import RateLimitOverrides
 from .request_manager import RequestManager
 from .retry_manager import RetryManager
-from .retry_manager import RetryPolicy
+from .retry_manager import RetryPolicyDict
 from .retry_manager import RetryStrategy
-from .transport import HTTPAdapterMountConfig
+from .transport import HTTPAdapterMountConfigDict
 from .types import RequestOptions
 from .types import Url
 
@@ -101,13 +101,13 @@ class EndpointClient:
     base_path : str | None, optional
         Optional base path prefix (``/v2``) prepended to all endpoint
         paths when building URLs.
-    retry : RetryPolicy | None, optional
+    retry : RetryPolicyDict | None, optional
         Optional retry policy. When provided, failed requests matching
         ``retry_on`` statuses are retried with full jitter.
     retry_network_errors : bool, optional
         When ``True``, also retry on network errors (timeouts, connection
         resets). Defaults to ``False``.
-    rate_limit : RateLimitConfigMap | None, optional
+    rate_limit : RateLimitConfigDict | None, optional
         Optional client-wide rate limit used to derive an inter-request
         delay when an explicit ``sleep_seconds`` isn't supplied.
     session : requests.Session | None, optional
@@ -115,7 +115,7 @@ class EndpointClient:
     session_factory : Callable[[], requests.Session] | None, optional
         Factory used to lazily create a session. Ignored if ``session`` is
         provided.
-    session_adapters : Sequence[HTTPAdapterMountConfig] | None, optional
+    session_adapters : Sequence[HTTPAdapterMountConfigDict] | None, optional
         Adapter mount configuration(s) used to build a session lazily when
         neither ``session`` nor ``session_factory`` is supplied.
 
@@ -128,17 +128,17 @@ class EndpointClient:
         (``MappingProxyType``).
     base_path : str | None
         Optional base path prefix appended after ``base_url``.
-    retry : RetryPolicy | None
+    retry : RetryPolicyDict | None
         Retry policy reference (may be ``None``).
     retry_network_errors : bool
         Whether network errors are retried in addition to HTTP statuses.
-    rate_limit : RateLimitConfigMap | None
+    rate_limit : RateLimitConfigDict | None
         Client-wide rate limit configuration (may be ``None``).
     session : requests.Session | None
         Explicit HTTP session used for requests when provided.
     session_factory : Callable[[], requests.Session] | None
         Lazily invoked factory producing a session when needed.
-    session_adapters : Sequence[HTTPAdapterMountConfig] | None
+    session_adapters : Sequence[HTTPAdapterMountConfigDict] | None
         Adapter mount configuration(s) for connection pooling / retries.
     DEFAULT_PAGE_PARAM : ClassVar[str]
         Default page parameter name.
@@ -212,10 +212,10 @@ class EndpointClient:
     base_path: str | None = None
 
     # Optional retry configuration (constructor parameter; object is frozen)
-    retry: RetryPolicy | None = None
+    retry: RetryPolicyDict | None = None
     retry_network_errors: bool = False
     # Optional client-wide rate limit configuration
-    rate_limit: RateLimitConfigMap | None = None
+    rate_limit: RateLimitConfigDict | None = None
 
     # Optional HTTP session or factory
     session: requests.Session | None = None
@@ -225,7 +225,7 @@ class EndpointClient:
     # and connection pooling. If provided and neither `session` nor
     # `session_factory` is supplied, a factory is synthesized to create a
     # Session and mount the configured adapters lazily.
-    session_adapters: Sequence[HTTPAdapterMountConfig] | None = None
+    session_adapters: Sequence[HTTPAdapterMountConfigDict] | None = None
 
     # Internal: context-managed session and ownership flag.
     _request_manager: RequestManager = field(
@@ -857,7 +857,7 @@ class EndpointClient:
     @staticmethod
     def _resolve_sleep_seconds(
         explicit: float,
-        rate_limit: RateLimitConfigMap | None,
+        rate_limit: RateLimitConfigDict | None,
         overrides: RateLimitOverrides = None,
     ) -> float:
         """
@@ -867,7 +867,7 @@ class EndpointClient:
         ----------
         explicit : float
             Explicit sleep seconds provided by the caller.
-        rate_limit : RateLimitConfigMap | None
+        rate_limit : RateLimitConfigDict | None
             Client-wide rate limit configuration.
         overrides : RateLimitOverrides, optional
             Per-call overrides that take precedence over *rate_limit*.

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/errors.py

@@ -30,7 +30,7 @@ from typing import Any
 import requests  # type: ignore[import]
 
 if TYPE_CHECKING:  # pragma: no cover - typing only
-    from .retry_manager import RetryPolicy
+    from .retry_manager import RetryPolicyDict
 
 
 # SECTION: EXPORTS ========================================================== #
@@ -57,7 +57,7 @@ class ApiRequestError(requests.RequestException):
         Number of attempts performed (defaults to ``1``).
     retried : bool, optional
         Whether any retry attempts were made.
-    retry_policy : RetryPolicy | None, optional
+    retry_policy : RetryPolicyDict | None, optional
         The retry policy in effect, if any.
     cause : Exception | None, optional
         Original underlying exception.
@@ -72,7 +72,7 @@ class ApiRequestError(requests.RequestException):
         Number of attempts performed.
     retried : bool
         Whether any retry attempts were made.
-    retry_policy : RetryPolicy | None
+    retry_policy : RetryPolicyDict | None
         The retry policy in effect, if any.
     cause : Exception | None
         Original underlying exception.
@@ -97,7 +97,7 @@ class ApiRequestError(requests.RequestException):
     status: int | None = None
     attempts: int = 1
     retried: bool = False
-    retry_policy: RetryPolicy | None = None
+    retry_policy: RetryPolicyDict | None = None
     cause: Exception | None = None
 
     # -- Magic Methods (Object Representation) -- #

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/pagination/__init__.py

@@ -20,10 +20,10 @@ Notes
 from __future__ import annotations
 
 from .client import PaginationClient
-from .config import CursorPaginationConfigMap
-from .config import PagePaginationConfigMap
+from .config import CursorPaginationConfigDict
+from .config import PagePaginationConfigDict
 from .config import PaginationConfig
-from .config import PaginationConfigMap
+from .config import PaginationConfigDict
 from .config import PaginationInput
 from .config import PaginationType
 from .paginator import Paginator
@@ -40,8 +40,8 @@ __all__ = [
     # Enums
     'PaginationType',
     # Type Aliases
-    'CursorPaginationConfigMap',
-    'PagePaginationConfigMap',
+    'CursorPaginationConfigDict',
+    'PagePaginationConfigDict',
     'PaginationInput',
-    'PaginationConfigMap',
+    'PaginationConfigDict',
 ]

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/pagination/config.py

@@ -8,7 +8,7 @@ by :mod:`etlplus.api.pagination`. It exposes:
 
 - :class:`PaginationType` – enumeration of supported pagination modes.
 - :class:`PaginationConfig` – normalized configuration container.
-- ``*PaginationConfigMap`` TypedDicts – loose, user-facing config mappings.
+- ``*PaginationConfigDict`` TypedDicts – loose, user-facing config mappings.
 
 Notes
 -----
@@ -44,11 +44,11 @@ __all__ = [
     # Enums
     'PaginationType',
     # Type Aliases
-    'PaginationConfigMap',
+    'PaginationConfigDict',
     'PaginationInput',
     # Typed Dicts
-    'CursorPaginationConfigMap',
-    'PagePaginationConfigMap',
+    'CursorPaginationConfigDict',
+    'PagePaginationConfigDict',
 ]
 
 
@@ -74,7 +74,7 @@ class PaginationType(CoercibleStrEnum):
 # SECTION: TYPED DICTS ====================================================== #
 
 
-class CursorPaginationConfigMap(TypedDict, total=False):
+class CursorPaginationConfigDict(TypedDict, total=False):
     """
     Configuration mapping for cursor-based REST API response pagination.
 
@@ -131,7 +131,7 @@ class CursorPaginationConfigMap(TypedDict, total=False):
     limit_param: str
 
 
-class PagePaginationConfigMap(TypedDict, total=False):
+class PagePaginationConfigDict(TypedDict, total=False):
     """
     Configuration mapping for page-based and offset-based REST API response
     pagination.
@@ -379,7 +379,7 @@ class PaginationConfig(BoundsWarningsMixin):
     @overload
     def from_obj(
         cls,
-        obj: PaginationConfigMap,
+        obj: PaginationConfigDict,
     ) -> Self: ...
 
     @classmethod
@@ -429,12 +429,14 @@ class PaginationConfig(BoundsWarningsMixin):
 # SECTION: TYPE ALIASES ===================================================== #
 
 
-type PaginationConfigMap = PagePaginationConfigMap | CursorPaginationConfigMap
+type PaginationConfigDict = (
+    PagePaginationConfigDict | CursorPaginationConfigDict
+)
 
 # External callers may pass either a raw mapping-shaped config or an already
 # constructed PaginationConfig instance, or omit pagination entirely. Accept a
 # loose mapping here to reflect the runtime behavior while still providing
 # stronger TypedDict hints for common shapes.
 type PaginationInput = (
-    PaginationConfigMap | PaginationConfig | StrAnyMap | None
+    PaginationConfigDict | PaginationConfig | StrAnyMap | None
 )

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/rate_limiting/__init__.py

@@ -19,7 +19,7 @@ Notes
 from __future__ import annotations
 
 from .config import RateLimitConfig
-from .config import RateLimitConfigMap
+from .config import RateLimitConfigDict
 from .config import RateLimitOverrides
 from .rate_limiter import RateLimiter
 
@@ -34,5 +34,5 @@ __all__ = [
     # Type Aliases
     'RateLimitOverrides',
     # Type Dicts
-    'RateLimitConfigMap',
+    'RateLimitConfigDict',
 ]

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/rate_limiting/config.py

@@ -41,7 +41,7 @@ __all__ = [
     # Type Aliases
     'RateLimitOverrides',
     # Typed Dicts
-    'RateLimitConfigMap',
+    'RateLimitConfigDict',
 ]
 
 
@@ -50,9 +50,9 @@ __all__ = [
 
 def _coerce_rate_limit_map(
     rate_limit: StrAnyMap | RateLimitConfig | None,
-) -> RateLimitConfigMap | None:
+) -> RateLimitConfigDict | None:
     """
-    Normalize user inputs into a :class:`RateLimitConfigMap`.
+    Normalize user inputs into a :class:`RateLimitConfigDict`.
 
     This helper is the single entry point for converting loosely-typed
     configuration into the canonical mapping consumed by downstream
@@ -65,7 +65,7 @@ def _coerce_rate_limit_map(
 
     Returns
     -------
-    RateLimitConfigMap | None
+    RateLimitConfigDict | None
         Normalized mapping, or ``None`` if input couldn't be parsed.
     """
     if rate_limit is None:
@@ -133,7 +133,7 @@ def _normalized_rate_values(
 # SECTION: TYPED DICTS ====================================================== #
 
 
-class RateLimitConfigMap(TypedDict, total=False):
+class RateLimitConfigDict(TypedDict, total=False):
     """
     Configuration mapping for HTTP request rate limits.
 
@@ -149,7 +149,7 @@ class RateLimitConfigMap(TypedDict, total=False):
 
     Examples
     --------
-    >>> rl: RateLimitConfigMap = {'max_per_sec': 4}
+    >>> rl: RateLimitConfigDict = {'max_per_sec': 4}
     ... # sleep ~= 0.25s between calls
     """
 
@@ -197,9 +197,9 @@ class RateLimitConfig(BoundsWarningsMixin):
 
     # -- Instance Methods -- #
 
-    def as_mapping(self) -> RateLimitConfigMap:
+    def as_mapping(self) -> RateLimitConfigDict:
         """Return a normalized mapping consumable by rate-limit helpers."""
-        cfg: RateLimitConfigMap = {}
+        cfg: RateLimitConfigDict = {}
         if (sleep := to_float(self.sleep_seconds)) is not None:
             cfg['sleep_seconds'] = sleep
         if (rate := to_float(self.max_per_sec)) is not None:
@@ -309,7 +309,7 @@ class RateLimitConfig(BoundsWarningsMixin):
     @overload
     def from_obj(
         cls,
-        obj: RateLimitConfigMap,
+        obj: RateLimitConfigDict,
     ) -> Self: ...
 
     @classmethod
@@ -352,4 +352,4 @@ class RateLimitConfig(BoundsWarningsMixin):
 type RateLimitInput = StrAnyMap | RateLimitConfig | None
 
 # Optional mapping of rate-limit fields to override values.
-type RateLimitOverrides = RateLimitConfigMap | None
+type RateLimitOverrides = RateLimitConfigDict | None

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/rate_limiting/rate_limiter.py

@@ -25,7 +25,7 @@ from typing import Self
 from ...utils import to_float
 from ...utils import to_positive_float
 from .config import RateLimitConfig
-from .config import RateLimitConfigMap
+from .config import RateLimitConfigDict
 from .config import RateLimitInput
 from .config import RateLimitOverrides
 
@@ -38,7 +38,7 @@ __all__ = [
     # Data Classes
     'RateLimitConfig',
     # Typed Dicts
-    'RateLimitConfigMap',
+    'RateLimitConfigDict',
 ]
 
 

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/request_manager.py

@@ -28,7 +28,7 @@ from .errors import ApiAuthError
 from .errors import ApiRequestError
 from .retry_manager import RetryInput
 from .retry_manager import RetryManager
-from .transport import HTTPAdapterMountConfig
+from .transport import HTTPAdapterMountConfigDict
 from .transport import build_session_with_adapters
 
 # SECTION: TYPE ALIASES ==================================================== #
@@ -68,7 +68,7 @@ class RequestManager:
         ``None``.
     retry_cap : float, optional
         Maximum backoff cap in seconds. Default is 30.0.
-    session_adapters : Sequence[HTTPAdapterMountConfig] | None, optional
+    session_adapters : Sequence[HTTPAdapterMountConfigDict] | None, optional
         Adapter mount configurations used when lazily building a session via
         :func:`etlplus.api.transport.build_session_with_adapters`.
 
@@ -86,7 +86,7 @@ class RequestManager:
         Optional factory for creating sessions.
     retry_cap : float
         Maximum backoff cap in seconds for :class:`RetryManager` sleeps.
-    session_adapters : Sequence[HTTPAdapterMountConfig] | None
+    session_adapters : Sequence[HTTPAdapterMountConfigDict] | None
         Adapter mount configurations used when lazily building a session.
     """
 
@@ -98,7 +98,7 @@ class RequestManager:
     session: requests.Session | None = None
     session_factory: Callable[[], requests.Session] | None = None
     retry_cap: float = 30.0
-    session_adapters: Sequence[HTTPAdapterMountConfig] | None = None
+    session_adapters: Sequence[HTTPAdapterMountConfigDict] | None = None
 
     def __post_init__(self) -> None:
         if self.session_adapters:

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/retry_manager.py

@@ -47,7 +47,7 @@ __all__ = [
     'RetryStrategy',
     'RetryManager',
     # Typed Dicts
-    'RetryPolicy',
+    'RetryPolicyDict',
     # Type Aliases
     'RetryInput',
 ]
@@ -69,7 +69,7 @@ DEFAULT_RETRY_STATUS_CODES: Final[frozenset[int]] = frozenset(
 # SECTION: TYPED DICTS ====================================================== #
 
 
-class RetryPolicy(TypedDict, total=False):
+class RetryPolicyDict(TypedDict, total=False):
     """
     Optional retry policy for HTTP requests.
 
@@ -100,7 +100,7 @@ class RetryPolicy(TypedDict, total=False):
 # SECTION: TYPE ALIASES ===================================================== #
 
 
-type RetryInput = RetryPolicy | None
+type RetryInput = RetryPolicyDict | None
 
 
 # SECTION: DATA CLASSES ===================================================== #
@@ -108,7 +108,7 @@ type RetryInput = RetryPolicy | None
 
 @dataclass(frozen=True, slots=True)
 class RetryStrategy:
-    """Normalized retry settings derived from a :class:`RetryPolicy`."""
+    """Normalized retry settings derived from a :class:`RetryPolicyDict`."""
 
     # -- Attributes -- #
 
@@ -171,7 +171,7 @@ class RetryManager:
         Default HTTP status codes considered retryable.
     DEFAULT_CAP : ClassVar[float]
         Default maximum sleep seconds for jittered backoff.
-    policy : RetryPolicy
+    policy : RetryPolicyDict
         Retry policy configuration.
     retry_network_errors : bool
         Whether to retry on network errors (timeouts, connection errors).
@@ -191,7 +191,7 @@ class RetryManager:
 
     # -- Instance Attributes-- #
 
-    policy: RetryPolicy
+    policy: RetryPolicyDict
     retry_network_errors: bool = False
     cap: float = DEFAULT_CAP
     sleeper: Sleeper = time.sleep

{etlplus-0.16.4 → etlplus-0.16.6}/etlplus/api/transport.py

@@ -41,8 +41,8 @@ from ..utils import to_positive_int
 
 __all__ = [
     # Classes
-    'HTTPAdapterMountConfig',
-    'HTTPAdapterRetryConfig',
+    'HTTPAdapterMountConfigDict',
+    'HTTPAdapterRetryConfigDict',
     # Functions
     'build_http_adapter',
     'build_session_with_adapters',
@@ -52,7 +52,7 @@ __all__ = [
 # SECTION: TYPED DICTS ====================================================== #
 
 
-class HTTPAdapterRetryConfig(TypedDict, total=False):
+class HTTPAdapterRetryConfigDict(TypedDict, total=False):
     """
     Retry configuration for urllib3 ``Retry``.
 
@@ -89,7 +89,7 @@ class HTTPAdapterRetryConfig(TypedDict, total=False):
 
     Examples
     --------
-    >>> retry_cfg: HTTPAdapterRetryConfig = {
+    >>> retry_cfg: HTTPAdapterRetryConfigDict = {
     ...     'total': 5,
     ...     'backoff_factor': 0.5,
     ...     'status_forcelist': [429, 503],
@@ -111,7 +111,7 @@ class HTTPAdapterRetryConfig(TypedDict, total=False):
     respect_retry_after_header: bool
 
 
-class HTTPAdapterMountConfig(TypedDict, total=False):
+class HTTPAdapterMountConfigDict(TypedDict, total=False):
     """
     Configuration mapping for mounting an ``HTTPAdapter`` on a ``Session``.
 
@@ -132,13 +132,13 @@ class HTTPAdapterMountConfig(TypedDict, total=False):
     pool_block : bool
         Whether the pool should block for connections instead of creating new
         ones.
-    max_retries : int | HTTPAdapterRetryConfig
+    max_retries : int | HTTPAdapterRetryConfigDict
         Retry configuration passed to ``HTTPAdapter`` (int) or converted to
         ``Retry``.
 
     Examples
     --------
-    >>> adapter_cfg: HTTPAdapterMountConfig = {
+    >>> adapter_cfg: HTTPAdapterMountConfigDict = {
     ...     'prefix': 'https://',
     ...     'pool_connections': 10,
     ...     'pool_maxsize': 10,
@@ -156,7 +156,7 @@ class HTTPAdapterMountConfig(TypedDict, total=False):
     pool_connections: int
     pool_maxsize: int
     pool_block: bool
-    max_retries: int | HTTPAdapterRetryConfig
+    max_retries: int | HTTPAdapterRetryConfigDict
 
 
 # SECTION: INTERNAL FUNCTIONS ============================================== #
@@ -306,7 +306,7 @@ def build_http_adapter(
 
 
 def build_session_with_adapters(
-    adapters_cfg: Sequence[HTTPAdapterMountConfig],
+    adapters_cfg: Sequence[HTTPAdapterMountConfigDict],
 ) -> requests.Session:
     """
     Mount adapters described by *adapters_cfg* onto a new session.
@@ -316,7 +316,7 @@ def build_session_with_adapters(
 
     Parameters
     ----------
-    adapters_cfg : Sequence[HTTPAdapterMountConfig]
+    adapters_cfg : Sequence[HTTPAdapterMountConfigDict]
         Configuration mappings describing the adapter prefix, pooling
         values, and retry policy for each mounted adapter.