botocore-stubs 1.34.66__py3-none-any.whl → 1.35.98__py3-none-any.whl

botocore-stubs/session.pyi

@@ -1,7 +1,12 @@
-import sys
-from collections.abc import MutableMapping
+"""
+Type annotations for botocore.session module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from collections.abc import Callable, MutableMapping
 from logging import Logger
-from typing import IO, Any, Dict, Iterator, List, Mapping, Optional, Tuple, Union
+from typing import IO, Any, Iterator, Mapping, Protocol, Sequence
 
 from botocore.client import BaseClient, Config
 from botocore.compat import HAS_CRT as HAS_CRT
@@ -33,20 +38,13 @@ from botocore.utils import EVENT_ALIASES as EVENT_ALIASES
 from botocore.utils import validate_region_name as validate_region_name
 from botocore.waiter import WaiterModel
 
-if sys.version_info >= (3, 9):
-    from typing import Protocol
-else:
-    from typing_extensions import Protocol
-
 logger: Logger = ...
 
-_EnvDict = Dict[str, Tuple[Any, Any, Any, Any]]
-
 class _EventHandler(Protocol):
     def __call__(self, **kwargs: Any) -> None: ...
 
 class Session:
-    SESSION_VARIABLES: _EnvDict
+    SESSION_VARIABLES: dict[str, tuple[Any, Any, Any, Any]]
     LOG_FORMAT: str
     user_agent_name: str
     user_agent_version: str
@@ -54,96 +52,94 @@ class Session:
     session_var_map: SessionVarDict
     def __init__(
         self,
-        session_vars: Optional[_EnvDict] = ...,
-        event_hooks: Optional[BaseEventHooks] = ...,
+        session_vars: dict[str, tuple[Any, Any, Any, Any]] | None = ...,
+        event_hooks: BaseEventHooks | None = ...,
         include_builtin_handlers: bool = ...,
-        profile: Optional[str] = ...,
+        profile: str | None = ...,
     ) -> None: ...
     @property
-    def available_profiles(self) -> List[str]: ...
+    def available_profiles(self) -> list[str]: ...
     @property
-    def profile(self) -> Optional[str]: ...
-    def get_config_variable(self, logical_name: str, methods: Optional[Any] = ...) -> Any: ...
+    def profile(self) -> str | None: ...
+    def get_config_variable(self, logical_name: str, methods: Any | None = ...) -> Any: ...
     def set_config_variable(self, logical_name: str, value: Any) -> None: ...
-    def instance_variables(self) -> Dict[str, Any]: ...
-    def get_scoped_config(self) -> Dict[str, Any]: ...
+    def instance_variables(self) -> dict[str, Any]: ...
+    def get_scoped_config(self) -> dict[str, Any]: ...
     @property
-    def full_config(self) -> Dict[str, Any]: ...
+    def full_config(self) -> dict[str, Any]: ...
     def get_default_client_config(self) -> Config: ...
     def set_default_client_config(self, client_config: Config) -> None: ...
     def set_credentials(
-        self, access_key: str, secret_key: str, token: Optional[str] = ...
+        self, access_key: str, secret_key: str, token: str | None = ...
     ) -> None: ...
     def get_credentials(self) -> Credentials: ...
     def get_auth_token(self) -> FrozenAuthToken: ...
     def user_agent(self) -> str: ...
     def get_data(self, data_path: str) -> Any: ...
     def get_service_model(
-        self, service_name: str, api_version: Optional[str] = ...
+        self, service_name: str, api_version: str | None = ...
     ) -> ServiceModel: ...
-    def get_waiter_model(
-        self, service_name: str, api_version: Optional[str] = ...
-    ) -> WaiterModel: ...
+    def get_waiter_model(self, service_name: str, api_version: str | None = ...) -> WaiterModel: ...
     def get_paginator_model(
-        self, service_name: str, api_version: Optional[str] = ...
+        self, service_name: str, api_version: str | None = ...
     ) -> PaginatorModel: ...
-    def get_service_data(self, service_name: str, api_version: Optional[str] = ...) -> Any: ...
+    def get_service_data(self, service_name: str, api_version: str | None = ...) -> Any: ...
     def get_available_services(self) -> Any: ...
     def set_debug_logger(self, logger_name: str = ...) -> None: ...
     def set_stream_logger(
         self,
         logger_name: str,
         log_level: str,
-        stream: Optional[IO[str]] = ...,
-        format_string: Optional[str] = ...,
+        stream: IO[str] | None = ...,
+        format_string: str | None = ...,
     ) -> None: ...
     def set_file_logger(self, log_level: str, path: str, logger_name: str = ...) -> None: ...
     def register(
         self,
         event_name: str,
         handler: _EventHandler,
-        unique_id: Optional[str] = ...,
+        unique_id: str | None = ...,
         unique_id_uses_count: bool = ...,
     ) -> None: ...
     def unregister(
         self,
         event_name: str,
-        handler: Optional[_EventHandler] = ...,
-        unique_id: Optional[str] = ...,
+        handler: _EventHandler | None = ...,
+        unique_id: str | None = ...,
         unique_id_uses_count: bool = ...,
     ) -> None: ...
     def emit(self, event_name: str, **kwargs: Any) -> Any: ...
-    def emit_first_non_none_response(self, event_name: Any, **kwargs: Any) -> Any: ...
-    def get_component(self, name: Any) -> Any: ...
-    def register_component(self, name: Any, component: Any) -> None: ...
-    def lazy_register_component(self, name: Any, component: Any) -> None: ...
+    def emit_first_non_none_response(self, event_name: str, **kwargs: Any) -> Any: ...
+    def get_component(self, name: str) -> Any: ...
+    def register_component(self, name: str, component: Any) -> None: ...
+    def lazy_register_component(self, name: str, component: Any) -> None: ...
     def create_client(
         self,
         service_name: str,
-        region_name: Optional[str] = ...,
-        api_version: Optional[str] = ...,
-        use_ssl: Optional[bool] = ...,
-        verify: Optional[Union[bool, str]] = ...,
-        endpoint_url: Optional[str] = ...,
-        aws_access_key_id: Optional[str] = ...,
-        aws_secret_access_key: Optional[str] = ...,
-        aws_session_token: Optional[str] = ...,
-        config: Optional[Config] = ...,
+        region_name: str | None = ...,
+        api_version: str | None = ...,
+        use_ssl: bool | None = ...,
+        verify: bool | str | None = ...,
+        endpoint_url: str | None = ...,
+        aws_access_key_id: str | None = ...,
+        aws_secret_access_key: str | None = ...,
+        aws_session_token: str | None = ...,
+        config: Config | None = ...,
     ) -> BaseClient: ...
-    def get_available_partitions(self) -> List[str]: ...
+    def get_available_partitions(self) -> list[str]: ...
     def get_partition_for_region(self, region_name: str) -> str: ...
     def get_available_regions(
         self,
         service_name: str,
         partition_name: str = ...,
         allow_non_regional: bool = ...,
-    ) -> List[str]: ...
+    ) -> list[str]: ...
 
 class ComponentLocator:
     def __init__(self) -> None: ...
     def get_component(self, name: str) -> Any: ...
     def register_component(self, name: str, component: Any) -> None: ...
-    def lazy_register_component(self, name: str, no_arg_factory: Any) -> None: ...
+    def lazy_register_component(self, name: str, no_arg_factory: Callable[[], Any]) -> None: ...
 
 class SessionVarDict(MutableMapping[str, Any]):
     def __init__(self, session: Session, session_vars: Mapping[str, Any]) -> None: ...
@@ -154,14 +150,16 @@ class SessionVarDict(MutableMapping[str, Any]):
     def __len__(self) -> int: ...
 
 class SubsetChainConfigFactory:
-    def __init__(self, session: Session, methods: Any, environ: Optional[Any] = ...) -> None: ...
+    def __init__(
+        self, session: Session, methods: Sequence[str], environ: Any | None = ...
+    ) -> None: ...
     def create_config_chain(
         self,
-        instance_name: Optional[Any] = ...,
-        env_var_names: Optional[Any] = ...,
-        config_property_name: Optional[Any] = ...,
-        default: Optional[Any] = ...,
-        conversion_func: Optional[Any] = ...,
+        instance_name: Any | None = ...,
+        env_var_names: Any | None = ...,
+        config_property_name: Any | None = ...,
+        default: Any | None = ...,
+        conversion_func: Any | None = ...,
     ) -> Any: ...
 
-def get_session(env_vars: Optional[_EnvDict] = ...) -> Session: ...
+def get_session(env_vars: dict[str, tuple[Any, Any, Any, Any]] | None = ...) -> Session: ...

botocore-stubs/signers.pyi

@@ -1,8 +1,15 @@
-from typing import Any, Mapping, Optional
+"""
+Type annotations for botocore.signers module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Mapping
 
 from botocore.awsrequest import create_request_object as create_request_object
 from botocore.awsrequest import prepare_request_dict as prepare_request_dict
 from botocore.compat import OrderedDict as OrderedDict
+from botocore.credentials import Credentials, ReadOnlyCredentials
 from botocore.exceptions import UnknownClientMethodError as UnknownClientMethodError
 from botocore.exceptions import UnknownSignatureVersionError as UnknownSignatureVersionError
 from botocore.exceptions import UnsupportedSignatureVersionError as UnsupportedSignatureVersionError
@@ -17,9 +24,9 @@ class RequestSigner:
         region_name: str,
         signing_name: str,
         signature_version: str,
-        credentials: Any,
+        credentials: Credentials | ReadOnlyCredentials,
         event_emitter: BaseEventHooks,
-        auth_token: Optional[str] = ...,
+        auth_token: str | None = ...,
     ) -> None: ...
     @property
     def region_name(self) -> str: ...
@@ -28,22 +35,23 @@ class RequestSigner:
     @property
     def signing_name(self) -> str: ...
     def handler(
-        self, operation_name: Optional[str] = ..., request: Optional[Any] = ..., **kwargs: Any
+        self, operation_name: str | None = ..., request: Any | None = ..., **kwargs: Any
     ) -> Any: ...
     def sign(
         self,
         operation_name: str,
         request: Any,
-        region_name: Optional[str] = ...,
+        region_name: str | None = ...,
         signing_type: str = ...,
-        expires_in: Optional[Any] = ...,
-        signing_name: Optional[str] = ...,
+        expires_in: Any | None = ...,
+        signing_name: str | None = ...,
     ) -> None: ...
     def get_auth_instance(
         self,
         signing_name: str,
         region_name: str,
-        signature_version: Optional[str] = ...,
+        signature_version: str | None = ...,
+        request_credentials: Credentials | ReadOnlyCredentials | None = ...,
         **kwargs: Any,
     ) -> Any: ...
     get_auth: Any = ...
@@ -52,8 +60,8 @@ class RequestSigner:
         request_dict: Mapping[str, Any],
         operation_name: str,
         expires_in: int = ...,
-        region_name: Optional[str] = ...,
-        signing_name: Optional[str] = ...,
+        region_name: str | None = ...,
+        signing_name: str | None = ...,
     ) -> Any: ...
 
 class CloudFrontSigner:
@@ -61,46 +69,55 @@ class CloudFrontSigner:
     rsa_signer: Any = ...
     def __init__(self, key_id: str, rsa_signer: Any) -> None: ...
     def generate_presigned_url(
-        self, url: str, date_less_than: Optional[Any] = ..., policy: Optional[Any] = ...
-    ) -> Any: ...
+        self, url: str, date_less_than: Any | None = ..., policy: Any | None = ...
+    ) -> str: ...
     def build_policy(
         self,
         resource: Any,
         date_less_than: Any,
-        date_greater_than: Optional[Any] = ...,
-        ip_address: Optional[Any] = ...,
-    ) -> Any: ...
+        date_greater_than: Any | None = ...,
+        ip_address: Any | None = ...,
+    ) -> str: ...
 
 def add_generate_db_auth_token(class_attributes: Any, **kwargs: Any) -> None: ...
+def add_dsql_generate_db_auth_token_methods(
+    class_attributes: dict[str, Any], **kwargs: Any
+) -> None: ...
 def generate_db_auth_token(
-    self: Any, DBHostname: Any, Port: Any, DBUsername: Any, Region: Optional[Any] = ...
+    self: Any, DBHostname: Any, Port: Any, DBUsername: Any, Region: Any | None = ...
 ) -> Any: ...
+def dsql_generate_db_connect_auth_token(
+    self: Any, Hostname: str, Region: str | None = ..., ExpiresIn: int = ...
+) -> str: ...
+def dsql_generate_db_connect_admin_auth_token(
+    self: Any, Hostname: str, Region: str | None = ..., ExpiresIn: int = ...
+) -> str: ...
 
 class S3PostPresigner:
     def __init__(self, request_signer: Any) -> None: ...
     def generate_presigned_post(
         self,
         request_dict: Mapping[str, Any],
-        fields: Optional[Any] = ...,
-        conditions: Optional[Any] = ...,
+        fields: Any | None = ...,
+        conditions: Any | None = ...,
         expires_in: int = ...,
-        region_name: Optional[str] = ...,
+        region_name: str | None = ...,
     ) -> Any: ...
 
 def add_generate_presigned_url(class_attributes: Any, **kwargs: Any) -> None: ...
 def generate_presigned_url(
     self: Any,
     ClientMethod: Any,
-    Params: Optional[Any] = ...,
+    Params: Any | None = ...,
     ExpiresIn: int = ...,
-    HttpMethod: Optional[Any] = ...,
+    HttpMethod: Any | None = ...,
 ) -> Any: ...
 def add_generate_presigned_post(class_attributes: Any, **kwargs: Any) -> None: ...
 def generate_presigned_post(
     self: Any,
     Bucket: Any,
     Key: Any,
-    Fields: Optional[Any] = ...,
-    Conditions: Optional[Any] = ...,
+    Fields: Any | None = ...,
+    Conditions: Any | None = ...,
     ExpiresIn: int = ...,
 ) -> Any: ...

botocore-stubs/stub.pyi

@@ -1,6 +1,11 @@
-import sys
+"""
+Type annotations for botocore.stub module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from types import TracebackType
-from typing import Any, Mapping, Optional, Type, TypeVar
+from typing import Any, Literal, Mapping, TypeVar
 
 from botocore.awsrequest import AWSResponse as AWSResponse
 from botocore.client import BaseClient
@@ -10,11 +15,6 @@ from botocore.exceptions import StubResponseError as StubResponseError
 from botocore.exceptions import UnStubbedResponseError as UnStubbedResponseError
 from botocore.validate import validate_parameters as validate_parameters
 
-if sys.version_info >= (3, 9):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
-
 class _ANY:
     def __eq__(self, other: object) -> Literal[True]: ...
     def __ne__(self, other: object) -> Literal[False]: ...
@@ -30,9 +30,9 @@ class Stubber:
     def __enter__(self: _R) -> _R: ...
     def __exit__(
         self,
-        exception_type: Optional[Type[BaseException]],
-        exception_value: Optional[BaseException],
-        traceback: Optional[TracebackType],
+        exception_type: type[BaseException] | None,
+        exception_value: BaseException | None,
+        traceback: TracebackType | None,
     ) -> None: ...
     def activate(self) -> None: ...
     def deactivate(self) -> None: ...
@@ -40,7 +40,7 @@ class Stubber:
         self,
         method: str,
         service_response: Mapping[str, Any],
-        expected_params: Optional[Mapping[str, Any]] = ...,
+        expected_params: Mapping[str, Any] | None = ...,
     ) -> None: ...
     def add_client_error(
         self,
@@ -48,9 +48,9 @@ class Stubber:
         service_error_code: str = ...,
         service_message: str = ...,
         http_status_code: int = ...,
-        service_error_meta: Optional[Mapping[str, Any]] = ...,
-        expected_params: Optional[Mapping[str, Any]] = ...,
-        response_meta: Optional[Mapping[str, Any]] = ...,
-        modeled_fields: Optional[Mapping[str, Any]] = ...,
+        service_error_meta: Mapping[str, Any] | None = ...,
+        expected_params: Mapping[str, Any] | None = ...,
+        response_meta: Mapping[str, Any] | None = ...,
+        modeled_fields: Mapping[str, Any] | None = ...,
     ) -> None: ...
     def assert_no_pending_responses(self) -> None: ...

botocore-stubs/tokens.pyi

@@ -1,6 +1,12 @@
+"""
+Type annotations for botocore.tokens module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import datetime
 import logging
-from typing import Any, Callable, Iterable, NamedTuple, Optional, Type
+from typing import Any, Callable, Iterable, NamedTuple
 
 from botocore.session import Session
 from botocore.utils import JSONFileCache
@@ -11,7 +17,7 @@ def create_token_resolver(session: Session) -> TokenProviderChain: ...
 
 class FrozenAuthToken(NamedTuple):
     token: str
-    expiration: Optional[datetime.datetime] = ...
+    expiration: datetime.datetime | None = ...
 
 class DeferredRefreshableToken:
     def __init__(
@@ -23,18 +29,18 @@ class DeferredRefreshableToken:
     def get_frozen_token(self) -> FrozenAuthToken: ...
 
 class TokenProviderChain:
-    def __init__(self, providers: Optional[Iterable[Any]] = ...) -> None: ...
+    def __init__(self, providers: Iterable[Any] | None = ...) -> None: ...
     def load_token(self) -> DeferredRefreshableToken: ...
 
 class SSOTokenProvider:
     METHOD: str = ...
-    DEFAULT_CACHE_CLS: Type[JSONFileCache] = ...
+    DEFAULT_CACHE_CLS: type[JSONFileCache] = ...
 
     def __init__(
         self,
         session: Session,
-        cache: Optional[JSONFileCache] = ...,
+        cache: JSONFileCache | None = ...,
         time_fetcher: Callable[[], datetime.datetime] = ...,
-        profile_name: Optional[str] = ...,
+        profile_name: str | None = ...,
     ) -> None: ...
     def load_token(self) -> DeferredRefreshableToken: ...

botocore-stubs/translate.pyi

@@ -1,11 +1,18 @@
-from typing import Any, Optional
+"""
+Type annotations for botocore.translate module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from collections.abc import Mapping
+from typing import Any
 
 from botocore.utils import merge_dicts as merge_dicts
 
 def build_retry_config(
     endpoint_prefix: str,
-    retry_model: Any,
-    definitions: Any,
-    client_retry_config: Optional[Any] = ...,
+    retry_model: Mapping[str, Any],
+    definitions: Mapping[str, Any],
+    client_retry_config: Mapping[str, Any] | None = ...,
 ) -> Any: ...
-def resolve_references(config: Any, definitions: Any) -> None: ...
+def resolve_references(config: Mapping[str, Any], definitions: Mapping[str, Any]) -> None: ...

botocore-stubs/useragent.pyi

@@ -1,4 +1,10 @@
-from typing import Any, List, NamedTuple, Optional, Type, TypeVar
+"""
+Type annotations for botocore.useragent module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, NamedTuple, TypeVar
 
 from botocore.config import Config
 
@@ -9,7 +15,7 @@ def sanitize_user_agent_string_component(raw_str: str, allow_hash: bool) -> str:
 class UserAgentComponent(NamedTuple):
     prefix: str
     name: str
-    value: Optional[str] = ...
+    value: str | None = ...
 
     def to_string(self) -> str: ...
 
@@ -17,7 +23,7 @@ class RawStringUserAgentComponent:
     def __init__(self, value: str) -> None: ...
     def to_string(self) -> str: ...
 
-def modify_components(components: List[Any]) -> List[Any]: ...
+def modify_components(components: list[Any]) -> list[Any]: ...
 
 class UserAgentString:
     def __init__(
@@ -28,10 +34,10 @@ class UserAgentString:
         python_version: str,
         python_implementation: str,
         execution_env: str,
-        crt_version: Optional[str] = ...,
+        crt_version: str | None = ...,
     ) -> None: ...
     @classmethod
-    def from_environment(cls: Type[_R]) -> _R: ...
+    def from_environment(cls: type[_R]) -> _R: ...
     def set_session_config(
         self: _R,
         session_user_agent_name: str,