boto3-stubs 1.35.36__py3-none-any.whl → 1.35.73__py3-none-any.whl

boto3-stubs/dynamodb/conditions.pyi

@@ -1,32 +1,29 @@
-import sys
-from typing import Any, Dict, List, NamedTuple, Pattern
-
-if sys.version_info >= (3, 12):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
-if sys.version_info >= (3, 12):
-    from typing import TypedDict
-else:
-    from typing_extensions import TypedDict
+"""
+Type annotations for boto3.dynamodb.conditions module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Literal, NamedTuple, Pattern, TypedDict
 
 ATTR_NAME_REGEX: Pattern[str]
 
-_ConditionBaseExpressionType = TypedDict(
-    "_ConditionBaseExpressionType", {"format": str, "operator": str, "values": List[Any]}
-)
+class _ConditionBaseExpressionType(TypedDict):
+    format: str
+    operator: str
+    values: list[Any]
 
 class ConditionBase:
     expression_format: str
     expression_operator: str
     has_grouped_values: bool
     def __init__(self, *values: Any) -> None: ...
-    def __and__(self, other: ConditionBase) -> "And": ...
-    def __or__(self, other: ConditionBase) -> "Or": ...
-    def __invert__(self) -> "Not": ...
+    def __and__(self, other: ConditionBase) -> And: ...
+    def __or__(self, other: ConditionBase) -> Or: ...
+    def __invert__(self) -> Not: ...
     def get_expression(self) -> _ConditionBaseExpressionType: ...
-    def __eq__(self, other: Any) -> bool: ...
-    def __ne__(self, other: Any) -> bool: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
 
 class AttributeBase:
     def __init__(self, name: str) -> None:
@@ -35,20 +32,20 @@ class AttributeBase:
     def __and__(self, value: Any) -> Any: ...
     def __or__(self, value: Any) -> Any: ...
     def __invert__(self) -> Any: ...
-    def eq(self, value: Any) -> "Equals": ...
-    def lt(self, value: Any) -> "LessThan": ...
-    def lte(self, value: Any) -> "LessThanEquals": ...
-    def gt(self, value: Any) -> "GreaterThan": ...
-    def gte(self, value: Any) -> "GreaterThanEquals": ...
-    def begins_with(self, value: Any) -> "BeginsWith": ...
-    def between(self, low_value: Any, high_value: Any) -> "Between": ...
-    def __eq__(self, other: Any) -> bool: ...
-    def __ne__(self, other: Any) -> bool: ...
+    def eq(self, value: Any) -> Equals: ...
+    def lt(self, value: Any) -> LessThan: ...
+    def lte(self, value: Any) -> LessThanEquals: ...
+    def gt(self, value: Any) -> GreaterThan: ...
+    def gte(self, value: Any) -> GreaterThanEquals: ...
+    def begins_with(self, value: Any) -> BeginsWith: ...
+    def between(self, low_value: Any, high_value: Any) -> Between: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
 
 class ConditionAttributeBase(ConditionBase, AttributeBase):
     def __init__(self, *values: Any) -> None: ...
-    def __eq__(self, other: Any) -> bool: ...
-    def __ne__(self, other: Any) -> bool: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
 
 class ComparisonCondition(ConditionBase):
     expression_format: Literal["{0} {operator} {1}"]  # type: ignore [override]
@@ -126,14 +123,10 @@ class Attr(AttributeBase):
     def size(self) -> Size: ...
     def attribute_type(self, value: Any) -> AttributeType: ...
 
-BuiltConditionExpression = NamedTuple(
-    "BuiltConditionExpression",
-    [
-        ("condition_expression", str),
-        ("attribute_name_placeholders", Dict[str, str]),
-        ("attribute_value_placeholders", Dict[str, Any]),
-    ],
-)
+class BuiltConditionExpression(NamedTuple):
+    condition_expression: str
+    attribute_name_placeholders: dict[str, str]
+    attribute_value_placeholders: dict[str, Any]
 
 class ConditionExpressionBuilder:
     def __init__(self) -> None: ...

boto3-stubs/dynamodb/table.pyi

@@ -1,16 +1,22 @@
+"""
+Type annotations for boto3.dynamodb.table module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import logging
 from types import TracebackType
-from typing import Any, Dict, List, Optional, Type, TypeVar
+from typing import Any, TypeVar
 
 from botocore.client import BaseClient
 
 logger: logging.Logger
 
-def register_table_methods(base_classes: List[Any], **kwargs: Any) -> None: ...
+def register_table_methods(base_classes: list[Any], **kwargs: Any) -> None: ...
 
 class TableResource:
     def __init__(self, *args: Any, **kwargs: Any) -> None: ...
-    def batch_writer(self, overwrite_by_pkeys: Optional[List[str]] = ...) -> "BatchWriter": ...
+    def batch_writer(self, overwrite_by_pkeys: list[str] | None = ...) -> BatchWriter: ...
 
 _R = TypeVar("_R")
 
@@ -20,14 +26,14 @@ class BatchWriter:
         table_name: str,
         client: BaseClient,
         flush_amount: int = ...,
-        overwrite_by_pkeys: Optional[List[str]] = ...,
+        overwrite_by_pkeys: list[str] | None = ...,
     ) -> None: ...
-    def put_item(self, Item: Dict[str, Any]) -> None: ...
-    def delete_item(self, Key: Dict[str, Any]) -> None: ...
+    def put_item(self, Item: dict[str, Any]) -> None: ...
+    def delete_item(self, Key: dict[str, Any]) -> None: ...
     def __enter__(self: _R) -> _R: ...
     def __exit__(
         self,
-        exc_type: Optional[Type[Exception]],
-        exc_value: Optional[Exception],
-        tb: Optional[TracebackType],
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        tb: TracebackType | None,
     ) -> None: ...

boto3-stubs/dynamodb/transform.pyi

@@ -1,11 +1,17 @@
-from typing import Any, Callable, Dict, List, Optional
+"""
+Type annotations for boto3.dynamodb.transform module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Callable
 
 from boto3.dynamodb.conditions import ConditionExpressionBuilder
 from boto3.dynamodb.types import TypeDeserializer, TypeSerializer
 from boto3.resources.model import ResourceModel
 from botocore.model import Shape
 
-def register_high_level_interface(base_classes: List[Any], **kwargs: Any) -> None: ...
+def register_high_level_interface(base_classes: list[Any], **kwargs: Any) -> None: ...
 def copy_dynamodb_params(params: Any, **kwargs: Any) -> Any: ...
 
 class DynamoDBHighLevelResource:
@@ -14,27 +20,27 @@ class DynamoDBHighLevelResource:
 class TransformationInjector:
     def __init__(
         self,
-        transformer: Optional[ParameterTransformer] = ...,
-        condition_builder: Optional[ConditionExpressionBuilder] = ...,
-        serializer: Optional[TypeSerializer] = ...,
-        deserializer: Optional[TypeDeserializer] = ...,
+        transformer: ParameterTransformer | None = ...,
+        condition_builder: ConditionExpressionBuilder | None = ...,
+        serializer: TypeSerializer | None = ...,
+        deserializer: TypeDeserializer | None = ...,
     ) -> None: ...
     def inject_condition_expressions(
-        self, params: Dict[str, Any], model: ResourceModel
+        self, params: dict[str, Any], model: ResourceModel
     ) -> None: ...
     def inject_attribute_value_input(
-        self, params: Dict[str, Any], model: ResourceModel
+        self, params: dict[str, Any], model: ResourceModel
     ) -> None: ...
     def inject_attribute_value_output(
-        self, parsed: Dict[str, Any], model: ResourceModel
+        self, parsed: dict[str, Any], model: ResourceModel
     ) -> None: ...
 
 class ConditionExpressionTransformation:
     def __init__(
         self,
         condition_builder: ConditionExpressionBuilder,
-        placeholder_names: List[str],
-        placeholder_values: List[str],
+        placeholder_names: list[str],
+        placeholder_values: list[str],
         is_key_condition: bool = ...,
     ) -> None: ...
     def __call__(self, value: Any) -> Any: ...
@@ -42,7 +48,7 @@ class ConditionExpressionTransformation:
 class ParameterTransformer:
     def transform(
         self,
-        params: Dict[str, Any],
+        params: dict[str, Any],
         model: Shape,
         transformation: Callable[[Any], Any],
         target_shape: str,

boto3-stubs/dynamodb/types.pyi

@@ -1,32 +1,23 @@
-import sys
+"""
+Type annotations for boto3.dynamodb.types module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from decimal import Context
-from typing import Any, Mapping, Sequence, Tuple
-
-if sys.version_info >= (3, 12):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
-if sys.version_info >= (3, 12):
-    from typing import TypedDict
-else:
-    from typing_extensions import TypedDict
-
-_AttributeValueTypeDef = TypedDict(
-    "_AttributeValueTypeDef",
-    {
-        "S": str,
-        "N": str,
-        "B": bytes,
-        "SS": Sequence[str],
-        "NS": Sequence[str],
-        "BS": Sequence[bytes],
-        "M": Mapping[str, Any],
-        "L": Sequence[Any],
-        "NULL": bool,
-        "BOOL": bool,
-    },
-    total=False,
-)
+from typing import Any, Literal, Mapping, Sequence, TypedDict
+
+class _AttributeValueTypeDef(TypedDict, total=False):
+    S: str
+    N: str
+    B: bytes
+    SS: Sequence[str]
+    NS: Sequence[str]
+    BS: Sequence[bytes]
+    M: Mapping[str, Any]
+    L: Sequence[Any]
+    NULL: bool
+    BOOL: bool
 
 STRING: Literal["S"]
 NUMBER: Literal["N"]
@@ -41,14 +32,12 @@ LIST: Literal["L"]
 
 DYNAMODB_CONTEXT: Context
 
-BINARY_TYPES: Tuple[Any, ...]
+BINARY_TYPES: tuple[Any, ...]
 
 class Binary:
     def __init__(self, value: Any) -> None: ...
-    def __eq__(self, other: Any) -> bool: ...
-    def __ne__(self, other: Any) -> bool: ...
-    def __repr__(self) -> str: ...
-    def __str__(self) -> str: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
     def __bytes__(self) -> str: ...
     def __hash__(self) -> int: ...
 

boto3-stubs/ec2/createtags.pyi

@@ -1,6 +1,12 @@
-from typing import Any, Dict, Iterable, List
+"""
+Type annotations for boto3.ec2.createtags module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from typing import Any, Iterable
 
 def inject_create_tags(
-    event_name: str, class_attributes: Dict[str, Any], **kwargs: Any
+    event_name: str, class_attributes: dict[str, Any], **kwargs: Any
 ) -> None: ...
-def create_tags(self: Any, **kwargs: Iterable[Any]) -> List[Dict[str, Any]]: ...
+def create_tags(self: Any, **kwargs: Iterable[Any]) -> list[dict[str, Any]]: ...

boto3-stubs/ec2/deletetags.pyi

@@ -1,3 +1,9 @@
+"""
+Type annotations for boto3.ec2.deletetags module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from typing import Any
 
 from botocore.hooks import BaseEventHooks

boto3-stubs/exceptions.pyi

@@ -1,3 +1,9 @@
+"""
+Type annotations for boto3.exceptions module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 from typing import Any, Iterable
 
 import botocore.exceptions

boto3-stubs/resources/action.pyi

@@ -1,5 +1,11 @@
+"""
+Type annotations for boto3.resources.action module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import logging
-from typing import Any, Callable, Dict, List, Optional, Sequence, Union
+from typing import Any, Callable, Sequence
 
 from boto3.resources.base import ServiceResource
 from boto3.resources.collection import ResourceCollection
@@ -14,17 +20,17 @@ class ServiceAction:
     def __init__(
         self,
         action_model: Action,
-        factory: Optional[ResourceFactory] = ...,
-        service_context: Optional[ServiceContext] = ...,
+        factory: ResourceFactory | None = ...,
+        service_context: ServiceContext | None = ...,
     ) -> None: ...
     def __call__(
         self, parent: ServiceResource, *args: Any, **kwargs: Any
-    ) -> Union[ServiceResource, List[ServiceResource], Dict[str, Any]]: ...
+    ) -> ServiceResource | list[ServiceResource] | dict[str, Any]: ...
 
 class BatchAction(ServiceAction):
     def __call__(  # type: ignore [override]
         self, parent: ResourceCollection, *args: Any, **kwargs: Any
-    ) -> List[Dict[str, Any]]: ...
+    ) -> list[dict[str, Any]]: ...
 
 class WaiterAction:
     def __init__(self, waiter_model: Waiter, waiter_resource_name: str) -> None: ...
@@ -34,7 +40,7 @@ class CustomModeledAction:
     def __init__(
         self,
         action_name: str,
-        action_model: Dict[str, Any],
+        action_model: dict[str, Any],
         function: Callable[..., Any],
         event_emitter: BaseEventHooks,
     ) -> None: ...

boto3-stubs/resources/base.pyi

@@ -1,5 +1,11 @@
+"""
+Type annotations for boto3.resources.base module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import logging
-from typing import Any, Dict, List, Optional, TypeVar
+from typing import Any, TypeVar
 
 from boto3.resources.model import ResourceModel
 from botocore.client import BaseClient
@@ -13,24 +19,22 @@ class ResourceMeta:
     def __init__(
         self,
         service_name: str,
-        identifiers: Optional[List[str]] = ...,
-        client: Optional[BaseClient] = ...,
-        data: Optional[Dict[str, Any]] = ...,
-        resource_model: Optional[ResourceModel] = ...,
+        identifiers: list[str] | None = ...,
+        client: BaseClient | None = ...,
+        data: dict[str, Any] | None = ...,
+        resource_model: ResourceModel | None = ...,
     ) -> None:
         self.service_name: str
-        self.identifiers: List[str]
-        self.data: Dict[str, Any]
+        self.identifiers: list[str]
+        self.data: dict[str, Any]
         self.resource_model: ResourceModel
 
-    def __repr__(self) -> str: ...
-    def __eq__(self, other: Any) -> bool: ...
+    def __eq__(self, other: object) -> bool: ...
     def copy(self: _ResourceMeta) -> _ResourceMeta: ...
 
 class ServiceResource:
     meta: ResourceMeta = ...  # type: ignore
 
-    def __init__(self, *args: Any, client: Optional[BaseClient] = ..., **kwargs: Any) -> None: ...
-    def __repr__(self) -> str: ...
-    def __eq__(self, other: Any) -> bool: ...
+    def __init__(self, *args: Any, client: BaseClient | None = ..., **kwargs: Any) -> None: ...
+    def __eq__(self, other: object) -> bool: ...
     def __hash__(self) -> int: ...

boto3-stubs/resources/collection.pyi

@@ -1,5 +1,11 @@
+"""
+Type annotations for boto3.resources.collection module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import logging
-from typing import Any, Iterator, List, TypeVar
+from typing import Any, Iterator, TypeVar
 
 from boto3.resources.base import ServiceResource
 from boto3.resources.factory import ResourceFactory
@@ -10,15 +16,14 @@ from botocore.hooks import BaseEventHooks
 
 logger: logging.Logger
 
-_ResourceCollection = TypeVar("_ResourceCollection", bound="ResourceCollection")
+_ResourceCollection = TypeVar("_ResourceCollection", bound=ResourceCollection)
 
 class ResourceCollection:
     def __init__(
         self, model: Collection, parent: ServiceResource, handler: ResourceHandler, **kwargs: Any
     ) -> None: ...
-    def __repr__(self) -> str: ...
     def __iter__(self) -> Iterator[Any]: ...
-    def pages(self) -> Iterator[List[Any]]: ...
+    def pages(self) -> Iterator[list[Any]]: ...
     def all(self: _ResourceCollection) -> _ResourceCollection: ...
     def filter(self: _ResourceCollection, **kwargs: Any) -> _ResourceCollection: ...
     def limit(self: _ResourceCollection, count: int) -> _ResourceCollection: ...
@@ -32,13 +37,12 @@ class CollectionManager:
         factory: ResourceFactory,
         service_context: ServiceContext,
     ) -> None: ...
-    def __repr__(self) -> str: ...
     def iterator(self, **kwargs: Any) -> ResourceCollection: ...
     def all(self) -> ResourceCollection: ...
     def filter(self, **kwargs: Any) -> ResourceCollection: ...
     def limit(self, count: int) -> ResourceCollection: ...
     def page_size(self, count: InterruptedError) -> ResourceCollection: ...
-    def pages(self) -> List[ServiceResource]: ...
+    def pages(self) -> list[ServiceResource]: ...
 
 class CollectionFactory:
     def load_from_definition(

boto3-stubs/resources/factory.pyi

@@ -1,5 +1,11 @@
+"""
+Type annotations for boto3.resources.factory module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import logging
-from typing import Any, Dict, Type
+from typing import Any
 
 from boto3.resources.base import ServiceResource
 from boto3.utils import ServiceContext
@@ -12,6 +18,6 @@ class ResourceFactory:
     def load_from_definition(
         self,
         resource_name: str,
-        single_resource_json_definition: Dict[str, Any],
+        single_resource_json_definition: dict[str, Any],
         service_context: ServiceContext,
-    ) -> Type[ServiceResource]: ...
+    ) -> type[ServiceResource]: ...

boto3-stubs/resources/model.pyi

@@ -1,69 +1,71 @@
+"""
+Type annotations for boto3.resources.model module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
 import logging
-import sys
-from typing import Any, Dict, List, Optional, Tuple, Union
+from typing import Any, Literal, TypedDict
 
 from botocore.model import Shape
 
-if sys.version_info >= (3, 12):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
-if sys.version_info >= (3, 12):
-    from typing import TypedDict
-else:
-    from typing_extensions import TypedDict
-
 logger: logging.Logger
 
-_ActionDefinition = TypedDict(
-    "_ActionDefinition",
-    {"request": Dict[str, Any], "resource": Dict[str, Any], "path": str},
-    total=False,
-)
-_DefinitionWithParamsDefinition = TypedDict(
-    "_DefinitionWithParamsDefinition", {"params": List[Dict[str, Any]]}, total=False
-)
-_RequestDefinition = TypedDict("_RequestDefinition", {"operation": str}, total=False)
-_WaiterDefinition = TypedDict("_WaiterDefinition", {"waiterName": str}, total=False)
-_ResponseResourceDefinition = TypedDict(
-    "_ResponseResourceDefinition", {"type": str, "path": str}, total=False
-)
-_ResourceModelDefinition = TypedDict("_ResourceModelDefinition", {"shape": str}, total=False)
+class _ActionDefinition(TypedDict, total=False):
+    request: dict[str, Any]
+    resource: dict[str, Any]
+    path: str
+
+class _DefinitionWithParamsDefinition(TypedDict, total=False):
+    params: list[dict[str, Any]]
+
+class _RequestDefinition(TypedDict, total=False):
+    operation: str
+
+class _WaiterDefinition(TypedDict, total=False):
+    waiterName: str
+
+class _ResponseResourceDefinition(TypedDict, total=False):
+    type: str
+    path: str
+
+class _ResourceModelDefinition(TypedDict, total=False):
+    shape: str
 
 class Identifier:
-    def __init__(self, name: str, member_name: Optional[str] = ...) -> None:
+    def __init__(self, name: str, member_name: str | None = ...) -> None:
         self.name: str
         self.member_name: str
 
 class Action:
     def __init__(
-        self, name: str, definition: _ActionDefinition, resource_defs: Dict[str, Dict[str, Any]]
+        self, name: str, definition: _ActionDefinition, resource_defs: dict[str, dict[str, Any]]
     ) -> None:
         self.name: str
-        self.request: Optional[Request]
-        self.resource: Optional[ResponseResource]
-        self.path: Optional[str]
+        self.request: Request | None
+        self.resource: ResponseResource | None
+        self.path: str | None
 
 class DefinitionWithParams:
     def __init__(self, definition: _DefinitionWithParamsDefinition) -> None: ...
     @property
-    def params(self) -> List[Parameter]: ...
+    def params(self) -> list[Parameter]: ...
 
 class Parameter:
     def __init__(
         self,
         target: str,
         source: str,
-        name: Optional[str] = ...,
-        path: Optional[str] = ...,
-        value: Union[str, int, float, bool, None] = ...,
+        name: str | None = ...,
+        path: str | None = ...,
+        value: str | float | bool | None = ...,
         **kwargs: Any,
     ) -> None:
         self.target: str
         self.source: str
-        self.name: Optional[str]
-        self.path: Optional[str]
-        self.value: Union[str, int, float, bool, None]
+        self.name: str | None
+        self.path: str | None
+        self.value: str | int | float | bool | None
 
 class Request(DefinitionWithParams):
     def __init__(self, definition: _RequestDefinition) -> None:
@@ -77,45 +79,45 @@ class Waiter(DefinitionWithParams):
 
 class ResponseResource:
     def __init__(
-        self, definition: _ResponseResourceDefinition, resource_defs: Dict[str, Dict[str, Any]]
+        self, definition: _ResponseResourceDefinition, resource_defs: dict[str, dict[str, Any]]
     ) -> None:
         self.type: str
         self.path: str
 
     @property
-    def identifiers(self) -> List[Identifier]: ...
+    def identifiers(self) -> list[Identifier]: ...
     @property
-    def model(self) -> "ResourceModel": ...
+    def model(self) -> ResourceModel: ...
 
 class Collection(Action):
     @property
-    def batch_actions(self) -> List[Action]: ...
+    def batch_actions(self) -> list[Action]: ...
 
 class ResourceModel:
     def __init__(
         self,
         name: str,
         definition: _ResourceModelDefinition,
-        resource_defs: Dict[str, Dict[str, Any]],
+        resource_defs: dict[str, dict[str, Any]],
     ) -> None:
         self.name: str
-        self.shape: Optional[str]
+        self.shape: str | None
 
-    def load_rename_map(self, shape: Optional[Shape] = ...) -> None: ...
-    def get_attributes(self, shape: Shape) -> Dict[str, Tuple[str, Shape]]: ...
+    def load_rename_map(self, shape: Shape | None = ...) -> None: ...
+    def get_attributes(self, shape: Shape) -> dict[str, tuple[str, Shape]]: ...
     @property
-    def identifiers(self) -> List[Identifier]: ...
+    def identifiers(self) -> list[Identifier]: ...
     @property
-    def load(self) -> Optional[Action]: ...
+    def load(self) -> Action | None: ...
     @property
-    def actions(self) -> List[Action]: ...
+    def actions(self) -> list[Action]: ...
     @property
-    def batch_actions(self) -> List[Action]: ...
+    def batch_actions(self) -> list[Action]: ...
     @property
-    def subresources(self) -> List[ResponseResource]: ...
+    def subresources(self) -> list[ResponseResource]: ...
     @property
-    def references(self) -> List[Action]: ...
+    def references(self) -> list[Action]: ...
     @property
-    def collections(self) -> List[Collection]: ...
+    def collections(self) -> list[Collection]: ...
     @property
-    def waiters(self) -> List[Waiter]: ...
+    def waiters(self) -> list[Waiter]: ...