boto3-stubs-lite 1.28.70__py3-none-any.whl → 1.40.76__py3-none-any.whl

boto3-stubs/s3/inject.pyi

@@ -1,4 +1,11 @@
-from typing import IO, Any, Callable, Dict, Optional
+"""
+Type annotations for boto3.s3.inject module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+import logging
+from typing import IO, Any, Callable
 
 from boto3 import utils as utils
 from boto3.s3.transfer import ProgressCallbackInvoker as ProgressCallbackInvoker
@@ -8,10 +15,12 @@ from boto3.s3.transfer import create_transfer_manager as create_transfer_manager
 from botocore.client import BaseClient
 from botocore.exceptions import ClientError as ClientError
 
-def inject_s3_transfer_methods(class_attributes: Dict[str, Any], **kwargs: Any) -> None: ...
-def inject_bucket_methods(class_attributes: Dict[str, Any], **kwargs: Any) -> None: ...
-def inject_object_methods(class_attributes: Dict[str, Any], **kwargs: Any) -> None: ...
-def inject_object_summary_methods(class_attributes: Dict[str, Any], **kwargs: Any) -> None: ...
+logger: logging.Logger = ...
+
+def inject_s3_transfer_methods(class_attributes: dict[str, Any], **kwargs: Any) -> None: ...
+def inject_bucket_methods(class_attributes: dict[str, Any], **kwargs: Any) -> None: ...
+def inject_object_methods(class_attributes: dict[str, Any], **kwargs: Any) -> None: ...
+def inject_object_summary_methods(class_attributes: dict[str, Any], **kwargs: Any) -> None: ...
 def bucket_load(self: Any, *args: Any, **kwargs: Any) -> None: ...
 def object_summary_load(self: Any, *args: Any, **kwargs: Any) -> None: ...
 def upload_file(
@@ -19,121 +28,122 @@ def upload_file(
     Filename: str,
     Bucket: str,
     Key: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def download_file(
     self: Any,
     Bucket: str,
     Key: str,
     Filename: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def bucket_upload_file(
     self: Any,
     Filename: str,
     Key: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def bucket_download_file(
     self: Any,
     Key: str,
     Filename: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def object_upload_file(
     self: Any,
     Filename: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def object_download_file(
     self: Any,
     Filename: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def copy(
     self: Any,
-    CopySource: Dict[str, Any],
+    CopySource: dict[str, Any],
     Bucket: str,
     Key: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    SourceClient: Optional[BaseClient] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    SourceClient: BaseClient | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def bucket_copy(
     self: Any,
-    CopySource: Dict[str, Any],
+    CopySource: dict[str, Any],
     Key: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    SourceClient: Optional[BaseClient] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    SourceClient: BaseClient | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def object_copy(
     self: Any,
-    CopySource: Dict[str, Any],
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    SourceClient: Optional[BaseClient] = ...,
-    Config: Optional[TransferConfig] = ...,
+    CopySource: dict[str, Any],
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    SourceClient: BaseClient | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def upload_fileobj(
     self: Any,
     Fileobj: IO[Any],
     Bucket: str,
     Key: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def bucket_upload_fileobj(
     self: Any,
     Fileobj: IO[Any],
     Key: str,
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def object_upload_fileobj(
     self: Any,
     Fileobj: IO[Any],
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
+def disable_threading_if_append_mode(config: TransferConfig, fileobj: IO[Any]) -> None: ...
 def download_fileobj(
     self: Any,
     Bucket: str,
     Key: str,
     Fileobj: IO[Any],
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def bucket_download_fileobj(
     self: Any,
     Key: str,
     Fileobj: IO[Any],
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...
 def object_download_fileobj(
     self: Any,
     Fileobj: IO[Any],
-    ExtraArgs: Optional[Dict[str, Any]] = ...,
-    Callback: Optional[Callable[..., Any]] = ...,
-    Config: Optional[TransferConfig] = ...,
+    ExtraArgs: dict[str, Any] | None = ...,
+    Callback: Callable[..., Any] | None = ...,
+    Config: TransferConfig | None = ...,
 ) -> None: ...

boto3-stubs/s3/transfer.pyi

@@ -1,5 +1,12 @@
+"""
+Type annotations for boto3.s3.transfer module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+import logging
 from types import TracebackType
-from typing import Any, Callable, Dict, List, Mapping, Optional, Type, TypeVar
+from typing import Any, Callable, Mapping, TypeVar
 
 from botocore.client import BaseClient
 from botocore.config import Config
@@ -13,14 +20,17 @@ _R = TypeVar("_R")
 KB: int
 MB: int
 
+logger: logging.Logger = ...
+
 def create_transfer_manager(
     client: BaseClient,
     config: TransferConfig,
-    osutil: Optional[OSUtils] = ...,
+    osutil: OSUtils | None = ...,
 ) -> TransferManager: ...
+def has_minimum_crt_version(minimum_version: str) -> bool: ...
 
 class TransferConfig(S3TransferConfig):
-    ALIAS: Dict[str, str]
+    ALIAS: dict[str, str]
 
     def __init__(
         self,
@@ -31,43 +41,46 @@ class TransferConfig(S3TransferConfig):
         max_io_queue: int = ...,
         io_chunksize: int = ...,
         use_threads: bool = ...,
-        max_bandwidth: Optional[int] = ...,
+        max_bandwidth: int | None = ...,
+        preferred_transfer_client: str = ...,
     ) -> None:
         self.use_threads: bool
+
     def __setattr__(self, name: str, value: int) -> None: ...
 
 class S3Transfer:
-    ALLOWED_DOWNLOAD_ARGS: List[str]
-    ALLOWED_UPLOAD_ARGS: List[str]
+    ALLOWED_DOWNLOAD_ARGS: list[str]
+    ALLOWED_UPLOAD_ARGS: list[str]
+    ALLOWED_COPY_ARGS: list[str]
     def __init__(
         self,
-        client: Optional[BaseClient] = ...,
-        config: Optional[Config] = ...,
-        osutil: Optional[OSUtils] = ...,
-        manager: Optional[TransferManager] = ...,
+        client: BaseClient | None = ...,
+        config: Config | None = ...,
+        osutil: OSUtils | None = ...,
+        manager: TransferManager | None = ...,
     ) -> None: ...
     def upload_file(
         self,
         filename: str,
         bucket: str,
         key: str,
-        callback: Optional[Callable[[int], Any]] = ...,
-        extra_args: Optional[Mapping[str, Any]] = ...,
+        callback: Callable[[int], Any] | None = ...,
+        extra_args: Mapping[str, Any] | None = ...,
     ) -> None: ...
     def download_file(
         self,
         bucket: str,
         key: str,
         filename: str,
-        extra_args: Optional[Mapping[str, Any]] = ...,
-        callback: Optional[Callable[[int], Any]] = ...,
+        extra_args: Mapping[str, Any] | None = ...,
+        callback: Callable[[int], Any] | None = ...,
     ) -> None: ...
     def __enter__(self: _R) -> _R: ...
     def __exit__(
         self,
-        exc_type: Optional[Type[BaseException]],
-        exc_value: Optional[BaseException],
-        tb: Optional[TracebackType],
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        tb: TracebackType | None,
     ) -> None: ...
 
 class ProgressCallbackInvoker(BaseSubscriber):

boto3-stubs/session.pyi

@@ -1,4 +1,10 @@
-from typing import Any, List, Optional, Union
+"""
+Type annotations for boto3.session module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any
 
 from boto3.exceptions import ResourceNotExistsError as ResourceNotExistsError
 from boto3.exceptions import UnknownAPIVersionError as UnknownAPIVersionError
@@ -14,17 +20,18 @@ from botocore.session import Session as BotocoreSession
 class Session:
     def __init__(
         self,
-        aws_access_key_id: Optional[str] = ...,
-        aws_secret_access_key: Optional[str] = ...,
-        aws_session_token: Optional[str] = ...,
-        region_name: Optional[str] = ...,
-        botocore_session: Optional[BotocoreSession] = ...,
-        profile_name: Optional[str] = ...,
+        aws_access_key_id: str | None = ...,
+        aws_secret_access_key: str | None = ...,
+        aws_session_token: str | None = ...,
+        region_name: str | None = ...,
+        botocore_session: BotocoreSession | None = ...,
+        profile_name: str | None = ...,
+        aws_account_id: str | None = ...,
     ) -> None:
         self._session: BotocoreSession
         self.resource_factory: ResourceFactory
         self._loader: Loader
-    def __repr__(self) -> str: ...
+
     @property
     def profile_name(self) -> str: ...
     @property
@@ -32,43 +39,42 @@ class Session:
     @property
     def events(self) -> BaseEventHooks: ...
     @property
-    def available_profiles(self) -> List[str]: ...
-    def _setup_loader(self) -> None: ...
-    def get_available_services(self) -> List[str]: ...
-    def get_available_resources(self) -> List[str]: ...
-    def get_available_partitions(self) -> List[str]: ...
+    def available_profiles(self) -> list[str]: ...
+    def get_available_services(self) -> list[str]: ...
+    def get_available_resources(self) -> list[str]: ...
+    def get_available_partitions(self) -> list[str]: ...
     def get_available_regions(
         self,
         service_name: str,
-        partition_name: str = "aws",
-        allow_non_regional: bool = False,
-    ) -> List[str]: ...
-    def get_credentials(self) -> Credentials: ...
+        partition_name: str = ...,
+        allow_non_regional: bool = ...,
+    ) -> list[str]: ...
+    def get_credentials(self) -> Credentials | None: ...
     def get_partition_for_region(self, region_name: str) -> str: ...
-    def _register_default_handlers(self) -> None: ...
     def client(
         self,
         service_name: str,
-        region_name: Optional[str] = ...,
-        api_version: Optional[str] = ...,
-        use_ssl: Optional[bool] = ...,
-        verify: Union[bool, str, None] = ...,
-        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 = ...,
+        aws_account_id: str | None = ...,
     ) -> Any: ...
     def resource(
         self,
         service_name: str,
-        region_name: Optional[str] = ...,
-        api_version: Optional[str] = ...,
-        use_ssl: Optional[bool] = ...,
-        verify: Union[bool, str, None] = ...,
-        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 = ...,
     ) -> Any: ...

boto3-stubs/utils.pyi

@@ -1,21 +1,26 @@
-from typing import Any, Dict, Optional
+"""
+Type annotations for boto3.utils module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, NamedTuple
 
 from botocore.model import ServiceModel
 from botocore.session import Session
 from botocore.waiter import Waiter, WaiterModel
 
-class ServiceContext:
-    def __init__(
-        self,
-        service_name: str,
-        service_model: ServiceModel,
-        service_waiter_model: Optional[WaiterModel],
-        resource_json_definitions: Dict[str, Any],
-    ) -> None: ...
+class _ServiceContext(NamedTuple):
+    service_name: str
+    service_model: ServiceModel
+    service_waiter_model: WaiterModel | None
+    resource_json_definitions: dict[str, Any]
+
+class ServiceContext(_ServiceContext): ...
 
 def import_module(name: str) -> Any: ...
 def lazy_call(full_name: str, **kwargs: Any) -> Any: ...
-def inject_attribute(class_attributes: Dict[str, Any], name: str, value: Any) -> None: ...
+def inject_attribute(class_attributes: dict[str, Any], name: str, value: Any) -> None: ...
 
 class LazyLoadedWaiterModel:
     def __init__(self, bc_session: Session, service_name: str, api_version: str) -> None: ...