boto3-stubs 1.34.65__py3-none-any.whl → 1.36.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. boto3-stubs/__init__.pyi +5945 -3951
  2. boto3-stubs/compat.pyi +7 -2
  3. boto3-stubs/crt.pyi +10 -6
  4. boto3-stubs/docs/__init__.pyi +6 -0
  5. boto3-stubs/docs/action.pyi +37 -0
  6. boto3-stubs/docs/attr.pyi +33 -0
  7. boto3-stubs/docs/base.pyi +19 -0
  8. boto3-stubs/docs/client.pyi +9 -0
  9. boto3-stubs/docs/collection.pyi +37 -0
  10. boto3-stubs/docs/docstring.pyi +18 -0
  11. boto3-stubs/docs/method.pyi +27 -0
  12. boto3-stubs/docs/resource.pyi +20 -0
  13. boto3-stubs/docs/service.pyi +17 -0
  14. boto3-stubs/docs/subresource.pyi +22 -0
  15. boto3-stubs/docs/utils.pyi +16 -5
  16. boto3-stubs/docs/waiter.pyi +33 -0
  17. boto3-stubs/dynamodb/conditions.pyi +31 -38
  18. boto3-stubs/dynamodb/table.pyi +15 -9
  19. boto3-stubs/dynamodb/transform.pyi +18 -12
  20. boto3-stubs/dynamodb/types.pyi +22 -33
  21. boto3-stubs/ec2/createtags.pyi +9 -3
  22. boto3-stubs/ec2/deletetags.pyi +6 -0
  23. boto3-stubs/exceptions.pyi +6 -0
  24. boto3-stubs/resources/action.pyi +12 -6
  25. boto3-stubs/resources/base.pyi +17 -13
  26. boto3-stubs/resources/collection.pyi +10 -6
  27. boto3-stubs/resources/factory.pyi +9 -3
  28. boto3-stubs/resources/model.pyi +55 -53
  29. boto3-stubs/resources/params.pyi +12 -6
  30. boto3-stubs/resources/response.pyi +20 -14
  31. boto3-stubs/s3/constants.pyi +6 -0
  32. boto3-stubs/s3/inject.pyi +62 -56
  33. boto3-stubs/s3/transfer.pyi +23 -17
  34. boto3-stubs/session.pyi +5971 -3955
  35. boto3-stubs/utils.pyi +10 -4
  36. {boto3_stubs-1.34.65.dist-info → boto3_stubs-1.36.1.dist-info}/LICENSE +1 -1
  37. {boto3_stubs-1.34.65.dist-info → boto3_stubs-1.36.1.dist-info}/METADATA +1062 -872
  38. boto3_stubs-1.36.1.dist-info/RECORD +45 -0
  39. {boto3_stubs-1.34.65.dist-info → boto3_stubs-1.36.1.dist-info}/WHEEL +1 -1
  40. boto3_stubs-1.34.65.dist-info/RECORD +0 -34
  41. {boto3_stubs-1.34.65.dist-info → boto3_stubs-1.36.1.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,12 @@
1
- from typing import Any, Dict, Iterable, List
1
+ """
2
+ Type annotations for boto3.ec2.createtags module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
7
+ from typing import Any, Iterable
2
8
 
3
9
  def inject_create_tags(
4
- event_name: str, class_attributes: Dict[str, Any], **kwargs: Any
10
+ event_name: str, class_attributes: dict[str, Any], **kwargs: Any
5
11
  ) -> None: ...
6
- def create_tags(self: Any, **kwargs: Iterable[Any]) -> List[Dict[str, Any]]: ...
12
+ def create_tags(self: Any, **kwargs: Iterable[Any]) -> list[dict[str, Any]]: ...
@@ -1,3 +1,9 @@
1
+ """
2
+ Type annotations for boto3.ec2.deletetags module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  from typing import Any
2
8
 
3
9
  from botocore.hooks import BaseEventHooks
@@ -1,3 +1,9 @@
1
+ """
2
+ Type annotations for boto3.exceptions module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  from typing import Any, Iterable
2
8
 
3
9
  import botocore.exceptions
@@ -1,5 +1,11 @@
1
+ """
2
+ Type annotations for boto3.resources.action module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  import logging
2
- from typing import Any, Callable, Dict, List, Optional, Sequence, Union
8
+ from typing import Any, Callable, Sequence
3
9
 
4
10
  from boto3.resources.base import ServiceResource
5
11
  from boto3.resources.collection import ResourceCollection
@@ -14,17 +20,17 @@ class ServiceAction:
14
20
  def __init__(
15
21
  self,
16
22
  action_model: Action,
17
- factory: Optional[ResourceFactory] = ...,
18
- service_context: Optional[ServiceContext] = ...,
23
+ factory: ResourceFactory | None = ...,
24
+ service_context: ServiceContext | None = ...,
19
25
  ) -> None: ...
20
26
  def __call__(
21
27
  self, parent: ServiceResource, *args: Any, **kwargs: Any
22
- ) -> Union[ServiceResource, List[ServiceResource], Dict[str, Any]]: ...
28
+ ) -> ServiceResource | list[ServiceResource] | dict[str, Any]: ...
23
29
 
24
30
  class BatchAction(ServiceAction):
25
31
  def __call__( # type: ignore [override]
26
32
  self, parent: ResourceCollection, *args: Any, **kwargs: Any
27
- ) -> List[Dict[str, Any]]: ...
33
+ ) -> list[dict[str, Any]]: ...
28
34
 
29
35
  class WaiterAction:
30
36
  def __init__(self, waiter_model: Waiter, waiter_resource_name: str) -> None: ...
@@ -34,7 +40,7 @@ class CustomModeledAction:
34
40
  def __init__(
35
41
  self,
36
42
  action_name: str,
37
- action_model: Dict[str, Any],
43
+ action_model: dict[str, Any],
38
44
  function: Callable[..., Any],
39
45
  event_emitter: BaseEventHooks,
40
46
  ) -> None: ...
@@ -1,5 +1,11 @@
1
+ """
2
+ Type annotations for boto3.resources.base module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  import logging
2
- from typing import Any, Dict, List, Optional, TypeVar
8
+ from typing import Any, TypeVar
3
9
 
4
10
  from boto3.resources.model import ResourceModel
5
11
  from botocore.client import BaseClient
@@ -13,24 +19,22 @@ class ResourceMeta:
13
19
  def __init__(
14
20
  self,
15
21
  service_name: str,
16
- identifiers: Optional[List[str]] = ...,
17
- client: Optional[BaseClient] = ...,
18
- data: Optional[Dict[str, Any]] = ...,
19
- resource_model: Optional[ResourceModel] = ...,
22
+ identifiers: list[str] | None = ...,
23
+ client: BaseClient | None = ...,
24
+ data: dict[str, Any] | None = ...,
25
+ resource_model: ResourceModel | None = ...,
20
26
  ) -> None:
21
27
  self.service_name: str
22
- self.identifiers: List[str]
23
- self.data: Dict[str, Any]
28
+ self.identifiers: list[str]
29
+ self.data: dict[str, Any]
24
30
  self.resource_model: ResourceModel
25
31
 
26
- def __repr__(self) -> str: ...
27
- def __eq__(self, other: Any) -> bool: ...
32
+ def __eq__(self, other: object) -> bool: ...
28
33
  def copy(self: _ResourceMeta) -> _ResourceMeta: ...
29
34
 
30
35
  class ServiceResource:
31
- meta: ResourceMeta # type: ignore
36
+ meta: ResourceMeta = ... # type: ignore
32
37
 
33
- def __init__(self, *args: Any, client: Optional[BaseClient] = ..., **kwargs: Any) -> None: ...
34
- def __repr__(self) -> str: ...
35
- def __eq__(self, other: Any) -> bool: ...
38
+ def __init__(self, *args: Any, client: BaseClient | None = ..., **kwargs: Any) -> None: ...
39
+ def __eq__(self, other: object) -> bool: ...
36
40
  def __hash__(self) -> int: ...
@@ -1,5 +1,11 @@
1
+ """
2
+ Type annotations for boto3.resources.collection module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  import logging
2
- from typing import Any, Iterator, List, TypeVar
8
+ from typing import Any, Iterator, TypeVar
3
9
 
4
10
  from boto3.resources.base import ServiceResource
5
11
  from boto3.resources.factory import ResourceFactory
@@ -10,15 +16,14 @@ from botocore.hooks import BaseEventHooks
10
16
 
11
17
  logger: logging.Logger
12
18
 
13
- _ResourceCollection = TypeVar("_ResourceCollection", bound="ResourceCollection")
19
+ _ResourceCollection = TypeVar("_ResourceCollection", bound=ResourceCollection)
14
20
 
15
21
  class ResourceCollection:
16
22
  def __init__(
17
23
  self, model: Collection, parent: ServiceResource, handler: ResourceHandler, **kwargs: Any
18
24
  ) -> None: ...
19
- def __repr__(self) -> str: ...
20
25
  def __iter__(self) -> Iterator[Any]: ...
21
- def pages(self) -> Iterator[List[Any]]: ...
26
+ def pages(self) -> Iterator[list[Any]]: ...
22
27
  def all(self: _ResourceCollection) -> _ResourceCollection: ...
23
28
  def filter(self: _ResourceCollection, **kwargs: Any) -> _ResourceCollection: ...
24
29
  def limit(self: _ResourceCollection, count: int) -> _ResourceCollection: ...
@@ -32,13 +37,12 @@ class CollectionManager:
32
37
  factory: ResourceFactory,
33
38
  service_context: ServiceContext,
34
39
  ) -> None: ...
35
- def __repr__(self) -> str: ...
36
40
  def iterator(self, **kwargs: Any) -> ResourceCollection: ...
37
41
  def all(self) -> ResourceCollection: ...
38
42
  def filter(self, **kwargs: Any) -> ResourceCollection: ...
39
43
  def limit(self, count: int) -> ResourceCollection: ...
40
44
  def page_size(self, count: InterruptedError) -> ResourceCollection: ...
41
- def pages(self) -> List[ServiceResource]: ...
45
+ def pages(self) -> list[ServiceResource]: ...
42
46
 
43
47
  class CollectionFactory:
44
48
  def load_from_definition(
@@ -1,5 +1,11 @@
1
+ """
2
+ Type annotations for boto3.resources.factory module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  import logging
2
- from typing import Any, Dict, Type
8
+ from typing import Any
3
9
 
4
10
  from boto3.resources.base import ServiceResource
5
11
  from boto3.utils import ServiceContext
@@ -12,6 +18,6 @@ class ResourceFactory:
12
18
  def load_from_definition(
13
19
  self,
14
20
  resource_name: str,
15
- single_resource_json_definition: Dict[str, Any],
21
+ single_resource_json_definition: dict[str, Any],
16
22
  service_context: ServiceContext,
17
- ) -> Type[ServiceResource]: ...
23
+ ) -> type[ServiceResource]: ...
@@ -1,69 +1,71 @@
1
+ """
2
+ Type annotations for boto3.resources.model module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  import logging
2
- import sys
3
- from typing import Any, Dict, List, Optional, Tuple, Union
8
+ from typing import Any, Literal, TypedDict
4
9
 
5
10
  from botocore.model import Shape
6
11
 
7
- if sys.version_info >= (3, 12):
8
- from typing import Literal
9
- else:
10
- from typing_extensions import Literal
11
- if sys.version_info >= (3, 12):
12
- from typing import TypedDict
13
- else:
14
- from typing_extensions import TypedDict
15
-
16
12
  logger: logging.Logger
17
13
 
18
- _ActionDefinition = TypedDict(
19
- "_ActionDefinition",
20
- {"request": Dict[str, Any], "resource": Dict[str, Any], "path": str},
21
- total=False,
22
- )
23
- _DefinitionWithParamsDefinition = TypedDict(
24
- "_DefinitionWithParamsDefinition", {"params": List[Dict[str, Any]]}, total=False
25
- )
26
- _RequestDefinition = TypedDict("_RequestDefinition", {"operation": str}, total=False)
27
- _WaiterDefinition = TypedDict("_WaiterDefinition", {"waiterName": str}, total=False)
28
- _ResponseResourceDefinition = TypedDict(
29
- "_ResponseResourceDefinition", {"type": str, "path": str}, total=False
30
- )
31
- _ResourceModelDefinition = TypedDict("_ResourceModelDefinition", {"shape": str}, total=False)
14
+ class _ActionDefinition(TypedDict, total=False):
15
+ request: dict[str, Any]
16
+ resource: dict[str, Any]
17
+ path: str
18
+
19
+ class _DefinitionWithParamsDefinition(TypedDict, total=False):
20
+ params: list[dict[str, Any]]
21
+
22
+ class _RequestDefinition(TypedDict, total=False):
23
+ operation: str
24
+
25
+ class _WaiterDefinition(TypedDict, total=False):
26
+ waiterName: str
27
+
28
+ class _ResponseResourceDefinition(TypedDict, total=False):
29
+ type: str
30
+ path: str
31
+
32
+ class _ResourceModelDefinition(TypedDict, total=False):
33
+ shape: str
32
34
 
33
35
  class Identifier:
34
- def __init__(self, name: str, member_name: Optional[str] = ...) -> None:
36
+ def __init__(self, name: str, member_name: str | None = ...) -> None:
35
37
  self.name: str
36
38
  self.member_name: str
37
39
 
38
40
  class Action:
39
41
  def __init__(
40
- self, name: str, definition: _ActionDefinition, resource_defs: Dict[str, Dict[str, Any]]
42
+ self, name: str, definition: _ActionDefinition, resource_defs: dict[str, dict[str, Any]]
41
43
  ) -> None:
42
44
  self.name: str
43
- self.request: Optional[Request]
44
- self.resource: Optional[ResponseResource]
45
- self.path: Optional[str]
45
+ self.request: Request | None
46
+ self.resource: ResponseResource | None
47
+ self.path: str | None
46
48
 
47
49
  class DefinitionWithParams:
48
50
  def __init__(self, definition: _DefinitionWithParamsDefinition) -> None: ...
49
51
  @property
50
- def params(self) -> List[Parameter]: ...
52
+ def params(self) -> list[Parameter]: ...
51
53
 
52
54
  class Parameter:
53
55
  def __init__(
54
56
  self,
55
57
  target: str,
56
58
  source: str,
57
- name: Optional[str] = ...,
58
- path: Optional[str] = ...,
59
- value: Union[str, int, float, bool, None] = ...,
59
+ name: str | None = ...,
60
+ path: str | None = ...,
61
+ value: str | float | bool | None = ...,
60
62
  **kwargs: Any,
61
63
  ) -> None:
62
64
  self.target: str
63
65
  self.source: str
64
- self.name: Optional[str]
65
- self.path: Optional[str]
66
- self.value: Union[str, int, float, bool, None]
66
+ self.name: str | None
67
+ self.path: str | None
68
+ self.value: str | int | float | bool | None
67
69
 
68
70
  class Request(DefinitionWithParams):
69
71
  def __init__(self, definition: _RequestDefinition) -> None:
@@ -77,45 +79,45 @@ class Waiter(DefinitionWithParams):
77
79
 
78
80
  class ResponseResource:
79
81
  def __init__(
80
- self, definition: _ResponseResourceDefinition, resource_defs: Dict[str, Dict[str, Any]]
82
+ self, definition: _ResponseResourceDefinition, resource_defs: dict[str, dict[str, Any]]
81
83
  ) -> None:
82
84
  self.type: str
83
85
  self.path: str
84
86
 
85
87
  @property
86
- def identifiers(self) -> List[Identifier]: ...
88
+ def identifiers(self) -> list[Identifier]: ...
87
89
  @property
88
- def model(self) -> "ResourceModel": ...
90
+ def model(self) -> ResourceModel: ...
89
91
 
90
92
  class Collection(Action):
91
93
  @property
92
- def batch_actions(self) -> List[Action]: ...
94
+ def batch_actions(self) -> list[Action]: ...
93
95
 
94
96
  class ResourceModel:
95
97
  def __init__(
96
98
  self,
97
99
  name: str,
98
100
  definition: _ResourceModelDefinition,
99
- resource_defs: Dict[str, Dict[str, Any]],
101
+ resource_defs: dict[str, dict[str, Any]],
100
102
  ) -> None:
101
103
  self.name: str
102
- self.shape: Optional[str]
104
+ self.shape: str | None
103
105
 
104
- def load_rename_map(self, shape: Optional[Shape] = ...) -> None: ...
105
- def get_attributes(self, shape: Shape) -> Dict[str, Tuple[str, Any]]: ...
106
+ def load_rename_map(self, shape: Shape | None = ...) -> None: ...
107
+ def get_attributes(self, shape: Shape) -> dict[str, tuple[str, Shape]]: ...
106
108
  @property
107
- def identifiers(self) -> List[Identifier]: ...
109
+ def identifiers(self) -> list[Identifier]: ...
108
110
  @property
109
- def load(self) -> Optional[Action]: ...
111
+ def load(self) -> Action | None: ...
110
112
  @property
111
- def actions(self) -> List[Action]: ...
113
+ def actions(self) -> list[Action]: ...
112
114
  @property
113
- def batch_actions(self) -> List[Action]: ...
115
+ def batch_actions(self) -> list[Action]: ...
114
116
  @property
115
- def subresources(self) -> List[ResponseResource]: ...
117
+ def subresources(self) -> list[ResponseResource]: ...
116
118
  @property
117
- def references(self) -> List[Action]: ...
119
+ def references(self) -> list[Action]: ...
118
120
  @property
119
- def collections(self) -> List[Collection]: ...
121
+ def collections(self) -> list[Collection]: ...
120
122
  @property
121
- def waiters(self) -> List[Waiter]: ...
123
+ def waiters(self) -> list[Waiter]: ...
@@ -1,17 +1,23 @@
1
- from typing import Any, Dict, Optional, Pattern
1
+ """
2
+ Type annotations for boto3.resources.params module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
7
+ from typing import Any, Pattern
2
8
 
3
9
  from boto3.resources.base import ServiceResource
4
10
  from boto3.resources.model import Request
5
11
 
6
12
  INDEX_RE: Pattern[str]
7
13
 
8
- def get_data_member(parent: ServiceResource, path: str) -> Optional[Dict[str, Any]]: ...
14
+ def get_data_member(parent: ServiceResource, path: str) -> dict[str, Any] | None: ...
9
15
  def create_request_parameters(
10
16
  parent: ServiceResource,
11
17
  request_model: Request,
12
- params: Optional[Dict[str, Any]] = ...,
13
- index: Optional[int] = ...,
14
- ) -> Dict[str, Any]: ...
18
+ params: dict[str, Any] | None = ...,
19
+ index: int | None = ...,
20
+ ) -> dict[str, Any]: ...
15
21
  def build_param_structure(
16
- params: Dict[str, Any], target: str, value: Any, index: Optional[int] = ...
22
+ params: dict[str, Any], target: str, value: Any, index: int | None = ...
17
23
  ) -> None: ...
@@ -1,4 +1,10 @@
1
- from typing import Any, Dict, Iterable, List, Optional, Tuple, Type, Union
1
+ """
2
+ Type annotations for boto3.resources.response module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
7
+ from typing import Any, Iterable
2
8
 
3
9
  from boto3.resources.base import ServiceResource
4
10
  from boto3.resources.factory import ResourceFactory
@@ -8,20 +14,20 @@ from botocore.model import ServiceModel
8
14
 
9
15
  def all_not_none(iterable: Iterable[Any]) -> bool: ...
10
16
  def build_identifiers(
11
- identifiers: List[Parameter],
17
+ identifiers: list[Parameter],
12
18
  parent: ServiceResource,
13
- params: Optional[Dict[str, Any]] = ...,
14
- raw_response: Optional[Dict[str, Any]] = ...,
15
- ) -> List[Tuple[str, Any]]: ...
19
+ params: dict[str, Any] | None = ...,
20
+ raw_response: dict[str, Any] | None = ...,
21
+ ) -> list[tuple[str, Any]]: ...
16
22
  def build_empty_response(
17
23
  search_path: str, operation_name: str, service_model: ServiceModel
18
- ) -> Union[Dict[str, Any], List[Any], None]: ...
24
+ ) -> dict[str, Any] | list[Any] | None: ...
19
25
 
20
26
  class RawHandler:
21
27
  def __init__(self, search_path: str) -> None: ...
22
28
  def __call__(
23
- self, parent: ServiceResource, params: Dict[str, Any], response: Dict[str, Any]
24
- ) -> Dict[str, Any]: ...
29
+ self, parent: ServiceResource, params: dict[str, Any], response: dict[str, Any]
30
+ ) -> dict[str, Any]: ...
25
31
 
26
32
  class ResourceHandler:
27
33
  def __init__(
@@ -30,15 +36,15 @@ class ResourceHandler:
30
36
  factory: ResourceFactory,
31
37
  resource_model: ResponseResource,
32
38
  service_context: ServiceContext,
33
- operation_name: Optional[str] = ...,
39
+ operation_name: str | None = ...,
34
40
  ) -> None: ...
35
41
  def __call__(
36
- self, parent: ServiceResource, params: Dict[str, Any], response: Dict[str, Any]
37
- ) -> Union[ServiceResource, List[ServiceResource]]: ...
42
+ self, parent: ServiceResource, params: dict[str, Any], response: dict[str, Any]
43
+ ) -> ServiceResource | list[ServiceResource]: ...
38
44
  def handle_response_item(
39
45
  self,
40
- resource_cls: Type[ServiceResource],
46
+ resource_cls: type[ServiceResource],
41
47
  parent: ServiceResource,
42
- identifiers: Dict[str, Any],
43
- resource_data: Optional[Dict[str, Any]],
48
+ identifiers: dict[str, Any],
49
+ resource_data: dict[str, Any] | None,
44
50
  ) -> ServiceResource: ...
@@ -1,2 +1,8 @@
1
+ """
2
+ Type annotations for boto3.s3.constants module.
3
+
4
+ Copyright 2024 Vlad Emelianov
5
+ """
6
+
1
7
  CLASSIC_TRANSFER_CLIENT: str = ...
2
8
  AUTO_RESOLVE_TRANSFER_CLIENT: str = ...