botocore-stubs 1.35.49__tar.gz → 1.42.2__tar.gz

{botocore_stubs-1.35.49/botocore_stubs.egg-info → botocore_stubs-1.42.2}/PKG-INFO

@@ -1,30 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: botocore-stubs
-Version: 1.35.49
+Version: 1.42.2
 Summary: Type annotations and code completion for botocore
 Author-email: Vlad Emelianov <vlad.emelianov.nz@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2022 Vlad Emelianov
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/youtype/botocore-stubs
 Project-URL: Documentation, https://youtype.github.io/mypy_boto3_builder/
 Project-URL: Repository, https://github.com/youtype/botocore-stubs
@@ -33,34 +12,33 @@ Project-URL: Issues, https://github.com/youtype/botocore-stubs/issues
 Keywords: botocore,type-annotations,pyright,mypy,boto3
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Typing :: Stubs Only
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: types-awscrt
-Requires-Dist: typing-extensions>=4.1.0; python_version < "3.9"
 Provides-Extra: botocore
 Requires-Dist: botocore; extra == "botocore"
+Dynamic: license-file
 
 # botocore-stubs
 
 [![PyPI - botocore-stubs](https://img.shields.io/pypi/v/botocore-stubs.svg?color=blue&label=botocore-stubs)](https://pypi.org/project/botocore-stubs)
 [![PyPI - botocore](https://img.shields.io/pypi/v/botocore.svg?color=blue&label=botocore)](https://pypi.org/project/botocore)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/botocore-stubs.svg?color=blue)](https://pypi.org/project/botocore-stubs)
-[![PyPI - Downloads](https://static.pepy.tech/badge/botocore-stubs)](https://pepy.tech/project/botocore-stubs)
+[![PyPI - Downloads](https://static.pepy.tech/badge/botocore-stubs)](https://pypistats.org/packages/botocore-stubs)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
@@ -88,7 +66,7 @@ Use [mypy](https://github.com/python/mypy) or [pyright](https://github.com/micro
 ## Versioning
 
 `botocore-stubs` version is the same as related `botocore` version and follows
-[PEP 440](https://www.python.org/dev/peps/pep-0440/) format.
+[Python Packaging version specifiers](https://packaging.python.org/en/latest/specifications/version-specifiers/).
 
 ## Support and contributing
 

{botocore_stubs-1.35.49 → botocore_stubs-1.42.2}/README.md

@@ -3,7 +3,7 @@
 [![PyPI - botocore-stubs](https://img.shields.io/pypi/v/botocore-stubs.svg?color=blue&label=botocore-stubs)](https://pypi.org/project/botocore-stubs)
 [![PyPI - botocore](https://img.shields.io/pypi/v/botocore.svg?color=blue&label=botocore)](https://pypi.org/project/botocore)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/botocore-stubs.svg?color=blue)](https://pypi.org/project/botocore-stubs)
-[![PyPI - Downloads](https://static.pepy.tech/badge/botocore-stubs)](https://pepy.tech/project/botocore-stubs)
+[![PyPI - Downloads](https://static.pepy.tech/badge/botocore-stubs)](https://pypistats.org/packages/botocore-stubs)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
@@ -31,7 +31,7 @@ Use [mypy](https://github.com/python/mypy) or [pyright](https://github.com/micro
 ## Versioning
 
 `botocore-stubs` version is the same as related `botocore` version and follows
-[PEP 440](https://www.python.org/dev/peps/pep-0440/) format.
+[Python Packaging version specifiers](https://packaging.python.org/en/latest/specifications/version-specifiers/).
 
 ## Support and contributing
 

{botocore_stubs-1.35.49 → botocore_stubs-1.42.2}/botocore-stubs/__init__.pyi

@@ -1,5 +1,12 @@
+"""
+Type annotations for botocore module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
 import logging
-from typing import Any, Callable, Mapping, Tuple
+from collections.abc import Mapping
+from typing import Any, Callable
 
 from botocore.session import Session
 
@@ -7,7 +14,7 @@ class NullHandler(logging.Handler):
     def emit(self, record: Any) -> None: ...
 
 log: logging.Logger
-ScalarTypes: Tuple[str, ...]
+ScalarTypes: tuple[str, ...]
 BOTOCORE_ROOT: str
 
 UNSIGNED: Any

{botocore_stubs-1.35.49 → botocore_stubs-1.42.2}/botocore-stubs/args.pyi

@@ -1,12 +1,20 @@
-import sys
+"""
+Type annotations for botocore.args module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from collections.abc import Mapping
 from logging import Logger
-from typing import Any, Dict, List, Mapping, Optional, Union
+from typing import Any, Literal, TypedDict, TypeVar
 
 from botocore.client import ClientEndpointBridge
 from botocore.config import Config as Config
 from botocore.configprovider import ConfigValueStore
+from botocore.credentials import Credentials
 from botocore.endpoint import Endpoint
 from botocore.endpoint import EndpointCreator as EndpointCreator
+from botocore.errorfactory import ClientExceptionsFactory
 from botocore.hooks import BaseEventHooks
 from botocore.loaders import Loader
 from botocore.model import ServiceModel
@@ -15,16 +23,17 @@ from botocore.serialize import BaseRestSerializer
 from botocore.signers import RequestSigner as RequestSigner
 from botocore.useragent import UserAgentString
 
-if sys.version_info >= (3, 9):
-    from typing import TypedDict
-else:
-    from typing_extensions import TypedDict
+_R = TypeVar("_R")
 
 logger: Logger = ...
 
-VALID_REGIONAL_ENDPOINTS_CONFIG: List[str]
-LEGACY_GLOBAL_STS_REGIONS: List[str]
-USERAGENT_APPID_MAXLEN: int
+VALID_REGIONAL_ENDPOINTS_CONFIG: list[str] = ...
+LEGACY_GLOBAL_STS_REGIONS: list[str] = ...
+USERAGENT_APPID_MAXLEN: int = ...
+VALID_REQUEST_CHECKSUM_CALCULATION_CONFIG: tuple[str, ...] = ...
+VALID_RESPONSE_CHECKSUM_VALIDATION_CONFIG: tuple[str, ...] = ...
+PRIORITY_ORDERED_SUPPORTED_PROTOCOLS: tuple[str, ...] = ...
+VALID_ACCOUNT_ID_ENDPOINT_MODE_CONFIG: tuple[str, ...] = ...
 
 class _GetClientArgsTypeDef(TypedDict):
     serializer: BaseRestSerializer
@@ -35,46 +44,46 @@ class _GetClientArgsTypeDef(TypedDict):
     service_model: ServiceModel
     loader: Loader
     client_config: Config
-    partition: Optional[str]
-    exceptions_factory: Any
+    partition: str | None
+    exceptions_factory: ClientExceptionsFactory
 
 class ClientArgsCreator:
     def __init__(
         self,
         event_emitter: BaseEventHooks,
-        user_agent: Any,
+        user_agent: str,
         response_parser_factory: ResponseParserFactory,
         loader: Loader,
-        exceptions_factory: Any,
+        exceptions_factory: ClientExceptionsFactory,
         config_store: ConfigValueStore,
-        user_agent_creator: Optional[UserAgentString] = ...,
+        user_agent_creator: UserAgentString | None = ...,
     ) -> None: ...
     def get_client_args(
         self,
         service_model: ServiceModel,
         region_name: str,
         is_secure: bool,
-        endpoint_url: Optional[str],
-        verify: Optional[Union[str, bool]],
-        credentials: Optional[Any],
-        scoped_config: Optional[Mapping[str, Any]],
-        client_config: Optional[Config],
+        endpoint_url: str | None,
+        verify: str | bool | None,
+        credentials: Any | None,
+        scoped_config: Mapping[str, Any] | None,
+        client_config: Config | None,
         endpoint_bridge: ClientEndpointBridge,
-        auth_token: Optional[str] = ...,
-        endpoints_ruleset_data: Optional[Mapping[str, Any]] = ...,
-        partition_data: Optional[Mapping[str, Any]] = ...,
+        auth_token: str | None = ...,
+        endpoints_ruleset_data: Mapping[str, Any] | None = ...,
+        partition_data: Mapping[str, Any] | None = ...,
     ) -> _GetClientArgsTypeDef: ...
     def compute_client_args(
         self,
         service_model: ServiceModel,
-        client_config: Optional[Config],
+        client_config: Config | None,
         endpoint_bridge: ClientEndpointBridge,
         region_name: str,
         endpoint_url: str,
         is_secure: bool,
-        scoped_config: Optional[Mapping[str, Any]],
+        scoped_config: Mapping[str, Any] | None,
     ) -> Any: ...
-    def compute_s3_config(self, client_config: Optional[Config]) -> Dict[str, Any]: ...
+    def compute_s3_config(self, client_config: Config | None) -> dict[str, Any]: ...
     def compute_endpoint_resolver_builtin_defaults(
         self,
         region_name: str,
@@ -83,4 +92,11 @@ class ClientArgsCreator:
         endpoint_bridge: ClientEndpointBridge,
         client_endpoint_url: str,
         legacy_endpoint_url: str,
-    ) -> Dict[str, Any]: ...
+        credentials: Credentials | None,
+        account_id_endpoint_mode: Literal["preferred", "disabled", "required"] | None,
+    ) -> dict[str, Any]: ...
+
+class ConfigObjectWrapper: ...
+
+class ClientConfigString(str, ConfigObjectWrapper):
+    def __new__(cls: type[_R], value: Any = ...) -> _R: ...

{botocore_stubs-1.35.49 → botocore_stubs-1.42.2}/botocore-stubs/auth.pyi

@@ -1,6 +1,13 @@
+"""
+Type annotations for botocore.auth module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from collections.abc import Iterable, Mapping
 from http.client import HTTPMessage
 from logging import Logger
-from typing import Any, Dict, Iterable, List, Mapping, Optional, Tuple, Type, Union
+from typing import Any
 from urllib.parse import SplitResult
 
 from botocore.awsrequest import AWSRequest
@@ -12,41 +19,41 @@ from botocore.utils import IdentityCache
 
 logger: Logger = ...
 
-_CredentialsUnion = Union[Credentials, ReadOnlyCredentials]
-
 EMPTY_SHA256_HASH: str
 PAYLOAD_BUFFER: int
 ISO8601: str
 SIGV4_TIMESTAMP: str
-SIGNED_HEADERS_BLACKLIST: List[str]
+SIGNED_HEADERS_BLACKLIST: list[str]
 UNSIGNED_PAYLOAD: str
 STREAMING_UNSIGNED_PAYLOAD_TRAILER: str
 
 class BaseSigner:
     REQUIRES_REGION: bool = ...
     REQUIRES_TOKEN: bool = ...
-    def add_auth(self, request: AWSRequest) -> Optional[AWSRequest]: ...
+    def add_auth(self, request: AWSRequest) -> AWSRequest | None: ...
 
 class TokenSigner(BaseSigner):
     def __init__(self, auth_token: str) -> None: ...
 
 class SigV2Auth(BaseSigner):
-    def __init__(self, credentials: _CredentialsUnion) -> None:
-        self.credentials: _CredentialsUnion
+    def __init__(self, credentials: Credentials | ReadOnlyCredentials) -> None:
+        self.credentials: Credentials | ReadOnlyCredentials
 
-    def calc_signature(self, request: AWSRequest, params: Mapping[str, Any]) -> Tuple[str, str]: ...
+    def calc_signature(self, request: AWSRequest, params: Mapping[str, Any]) -> tuple[str, str]: ...
     def add_auth(self, request: AWSRequest) -> AWSRequest: ...
 
 class SigV3Auth(BaseSigner):
-    def __init__(self, credentials: _CredentialsUnion) -> None:
-        self.credentials: _CredentialsUnion
+    def __init__(self, credentials: Credentials | ReadOnlyCredentials) -> None:
+        self.credentials: Credentials | ReadOnlyCredentials
 
     def add_auth(self, request: AWSRequest) -> None: ...
 
 class SigV4Auth(BaseSigner):
     REQUIRES_REGION: bool = ...
-    def __init__(self, credentials: _CredentialsUnion, service_name: str, region_name: str) -> None:
-        self.credentials: _CredentialsUnion
+    def __init__(
+        self, credentials: Credentials | ReadOnlyCredentials, service_name: str, region_name: str
+    ) -> None:
+        self.credentials: Credentials | ReadOnlyCredentials
 
     def headers_to_sign(self, request: AWSRequest) -> HTTPMessage: ...
     def canonical_query_string(self, request: AWSRequest) -> str: ...
@@ -67,7 +74,7 @@ class S3ExpressAuth(S3SigV4Auth):
 
     def __init__(
         self,
-        credentials: _CredentialsUnion,
+        credentials: Credentials | ReadOnlyCredentials,
         service_name: str,
         region_name: str,
         *,
@@ -81,7 +88,7 @@ class S3ExpressQueryAuth(S3ExpressAuth):
 
     def __init__(
         self,
-        credentials: _CredentialsUnion,
+        credentials: Credentials | ReadOnlyCredentials,
         service_name: str,
         region_name: str,
         *,
@@ -93,7 +100,7 @@ class SigV4QueryAuth(SigV4Auth):
     DEFAULT_EXPIRES: int = ...
     def __init__(
         self,
-        credentials: _CredentialsUnion,
+        credentials: Credentials | ReadOnlyCredentials,
         service_name: str,
         region_name: str,
         expires: int = ...,
@@ -106,42 +113,42 @@ class S3SigV4PostAuth(SigV4Auth):
     def add_auth(self, request: AWSRequest) -> None: ...
 
 class HmacV1Auth(BaseSigner):
-    QSAOfInterest: List[str] = ...
+    QSAOfInterest: list[str] = ...
     def __init__(
         self,
-        credentials: _CredentialsUnion,
-        service_name: Optional[str] = ...,
-        region_name: Optional[str] = ...,
+        credentials: Credentials | ReadOnlyCredentials,
+        service_name: str | None = ...,
+        region_name: str | None = ...,
     ) -> None:
-        self.credentials: _CredentialsUnion
+        self.credentials: Credentials | ReadOnlyCredentials
 
     def sign_string(self, string_to_sign: str) -> str: ...
     def canonical_standard_headers(self, headers: Mapping[str, Any]) -> str: ...
     def canonical_custom_headers(self, headers: Mapping[str, Any]) -> str: ...
-    def unquote_v(self, nv: str) -> Union[Tuple[str, str], str]: ...
-    def canonical_resource(self, split: SplitResult, auth_path: Optional[str] = ...) -> str: ...
+    def unquote_v(self, nv: str) -> tuple[str, str] | str: ...
+    def canonical_resource(self, split: SplitResult, auth_path: str | None = ...) -> str: ...
     def canonical_string(
         self,
         method: str,
         split: SplitResult,
         headers: Mapping[str, Any],
-        expires: Optional[int] = ...,
-        auth_path: Optional[str] = ...,
+        expires: int | None = ...,
+        auth_path: str | None = ...,
     ) -> Any: ...
     def get_signature(
         self,
         method: str,
         split: SplitResult,
         headers: Mapping[str, Any],
-        expires: Optional[int] = ...,
-        auth_path: Optional[str] = ...,
+        expires: int | None = ...,
+        auth_path: str | None = ...,
     ) -> Any: ...
     def add_auth(self, request: AWSRequest) -> None: ...
 
 class HmacV1QueryAuth(HmacV1Auth):
     DEFAULT_EXPIRES: int = ...
-    def __init__(self, credentials: _CredentialsUnion, expires: int = ...) -> None:
-        self.credentials: _CredentialsUnion
+    def __init__(self, credentials: Credentials | ReadOnlyCredentials, expires: int = ...) -> None:
+        self.credentials: Credentials | ReadOnlyCredentials
 
 class HmacV1PostAuth(HmacV1Auth):
     def add_auth(self, request: AWSRequest) -> None: ...
@@ -150,6 +157,10 @@ class BearerAuth(TokenSigner):
     def add_auth(self, request: AWSRequest) -> None: ...
 
 def resolve_auth_type(auth_trait: Iterable[str]) -> str: ...
+def resolve_auth_scheme_preference(
+    preference_list: Iterable[str], auth_options: Iterable[str]
+) -> str: ...
 
-AUTH_TYPE_MAPS: Dict[str, Type[BaseSigner]]
-AUTH_TYPE_TO_SIGNATURE_VERSION: Dict[str, str]
+AUTH_TYPE_MAPS: dict[str, type[BaseSigner]]
+AUTH_TYPE_TO_SIGNATURE_VERSION: dict[str, str]
+AUTH_PREF_TO_SIGNATURE_VERSION: dict[str, str]

{botocore_stubs-1.35.49 → botocore_stubs-1.42.2}/botocore-stubs/awsrequest.pyi

@@ -1,6 +1,12 @@
-from collections.abc import MutableMapping
+"""
+Type annotations for botocore.awsrequest module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from collections.abc import Iterator, Mapping, MutableMapping
 from logging import Logger
-from typing import IO, Any, Dict, Iterator, Mapping, Optional, Type, TypeVar, Union
+from typing import IO, Any, TypeVar
 
 from botocore.compat import HTTPHeaders as HTTPHeaders
 from botocore.compat import HTTPResponse as HTTPResponse
@@ -20,15 +26,15 @@ class AWSHTTPResponse(HTTPResponse):
 
 class AWSConnection:
     def __init__(self, *args: Any, **kwargs: Any) -> None:
-        self.response_class: Any
+        self.response_class: type[AWSHTTPResponse]
 
     def close(self) -> None: ...
     def request(
         self,
         method: str,
         url: str,
-        body: Any = ...,
-        headers: Optional[Mapping[str, Any]] = ...,
+        body: str | bytes | bytearray | IO[bytes] | IO[str] | None = ...,
+        headers: Mapping[str, Any] | None = ...,
         *args: Any,
         **kwargs: Any,
     ) -> HTTPConnection: ...
@@ -39,16 +45,16 @@ class AWSHTTPConnection(AWSConnection, HTTPConnection): ...  # type: ignore [mis
 class AWSHTTPSConnection(AWSConnection, VerifiedHTTPSConnection): ...  # type: ignore [misc]
 
 class AWSHTTPConnectionPool(HTTPConnectionPool):
-    ConnectionCls: Type[AWSHTTPConnection]  # type: ignore [misc,assignment]
+    ConnectionCls: type[AWSHTTPConnection]  # type: ignore [misc,assignment]
 
 class AWSHTTPSConnectionPool(HTTPSConnectionPool):
-    ConnectionCls: Type[AWSHTTPSConnection]  # type: ignore [misc,assignment]
+    ConnectionCls: type[AWSHTTPSConnection]  # type: ignore [misc,assignment]
 
 def prepare_request_dict(
     request_dict: Mapping[str, Any],
     endpoint_url: str,
-    context: Optional[Any] = ...,
-    user_agent: Optional[Any] = ...,
+    context: Mapping[str, Any] | None = ...,
+    user_agent: str | None = ...,
 ) -> None: ...
 def create_request_object(request_dict: Mapping[str, Any]) -> Any: ...
 
@@ -58,13 +64,13 @@ class AWSPreparedRequest:
         method: str,
         url: str,
         headers: HTTPHeaders,
-        body: Union[str, bytes, bytearray, IO[bytes], IO[str], None],
+        body: str | bytes | bytearray | IO[bytes] | IO[str] | None,
         stream_output: bool,
     ) -> None:
         self.method: str
         self.url: str
         self.headers: HTTPHeaders
-        self.body: Union[str, bytes, bytearray, IO[bytes], IO[str], None]
+        self.body: str | bytes | bytearray | IO[bytes] | IO[str] | None
         self.stream_output: bool
 
     def reset_stream(self) -> None: ...
@@ -72,22 +78,22 @@ class AWSPreparedRequest:
 class AWSRequest:
     def __init__(
         self,
-        method: Optional[str] = ...,
-        url: Optional[str] = ...,
-        headers: Optional[Mapping[str, Any]] = ...,
-        data: Optional[Any] = ...,
-        params: Optional[Mapping[str, Any]] = ...,
-        auth_path: Optional[str] = ...,
+        method: str | None = ...,
+        url: str | None = ...,
+        headers: Mapping[str, Any] | None = ...,
+        data: Any | None = ...,
+        params: Mapping[str, Any] | None = ...,
+        auth_path: str | None = ...,
         stream_output: bool = ...,
     ) -> None:
-        self.method: Optional[str]
-        self.url: Optional[str]
+        self.method: str | None
+        self.url: str | None
         self.headers: HTTPHeaders
-        self.data: Optional[Any]
-        self.params: Dict[str, Any]
-        self.auth_path: Optional[str]
+        self.data: Any | None
+        self.params: dict[str, Any]
+        self.auth_path: str | None
         self.stream_output: bool
-        self.context: Dict[str, Any]
+        self.context: dict[str, Any]
 
     def prepare(self) -> AWSPreparedRequest: ...
     @property
@@ -111,7 +117,7 @@ class AWSResponse:
 class _HeaderKey:
     def __init__(self, key: str) -> None: ...
     def __hash__(self) -> int: ...
-    def __eq__(self, other: Any) -> bool: ...
+    def __eq__(self, other: object) -> bool: ...
 
 class HeadersDict(MutableMapping[str, str]):
     def __init__(self, *args: Any, **kwargs: Any) -> None: ...