mypy-boto3-dynamodb 1.35.54__tar.gz → 1.35.74__tar.gz

{mypy_boto3_dynamodb-1.35.54 → mypy_boto3_dynamodb-1.35.74}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: mypy-boto3-dynamodb
-Version: 1.35.54
-Summary: Type annotations for boto3.DynamoDB 1.35.54 service generated with mypy-boto3-builder 8.2.0
+Version: 1.35.74
+Summary: Type annotations for boto3 DynamoDB 1.35.74 service generated with mypy-boto3-builder 8.5.0
 Home-page: https://github.com/youtype/mypy_boto3_builder
 Author: Vlad Emelianov
 Author-email: vlad.emelianov.nz@gmail.com
@@ -9,7 +9,7 @@ License: MIT License
 Project-URL: Documentation, https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/
 Project-URL: Source, https://github.com/youtype/mypy_boto3_builder
 Project-URL: Tracker, https://github.com/youtype/mypy_boto3_builder/issues
-Keywords: boto3 dynamodb type-annotations botocore mypy typeshed autocomplete
+Keywords: boto3 dynamodb boto3-stubs type-annotations mypy typeshed autocomplete
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Environment :: Console
@@ -36,16 +36,15 @@ Requires-Dist: typing-extensions>=4.1.0; python_version < "3.12"
 
 # mypy-boto3-dynamodb
 
-[![PyPI - mypy-boto3-dynamodb](https://img.shields.io/pypi/v/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb)
-[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/)
-[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-dynamodb)](https://pepy.tech/project/mypy-boto3-dynamodb)
+[![PyPI - mypy-boto3-dynamodb](https://img.shields.io/pypi/v/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb/)
+[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/)
+[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-dynamodb)](https://pypistats.org/packages/mypy-boto3-dynamodb)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
-Type annotations for
-[boto3.DynamoDB 1.35.54](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB)
-service compatible with [VSCode](https://code.visualstudio.com/),
+Type annotations for [boto3 DynamoDB 1.35.74](https://pypi.org/project/boto3/)
+compatible with [VSCode](https://code.visualstudio.com/),
 [PyCharm](https://www.jetbrains.com/pycharm/),
 [Emacs](https://www.gnu.org/software/emacs/),
 [Sublime Text](https://www.sublimetext.com/),
@@ -53,15 +52,15 @@ service compatible with [VSCode](https://code.visualstudio.com/),
 [pyright](https://github.com/microsoft/pyright) and other tools.
 
 Generated by
-[mypy-boto3-builder 8.2.0](https://github.com/youtype/mypy_boto3_builder).
+[mypy-boto3-builder 8.5.0](https://github.com/youtype/mypy_boto3_builder).
 
 More information can be found on
 [boto3-stubs](https://pypi.org/project/boto3-stubs/) page and in
 [mypy-boto3-dynamodb docs](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/).
 
-See how it helps to find and fix potential bugs:
+See how it helps you find and fix potential bugs:
 
-![boto3-stubs demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
+![types-boto3 demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
 
 - [mypy-boto3-dynamodb](#mypy-boto3-dynamodb)
   - [How to install](#how-to-install)
@@ -77,6 +76,7 @@ See how it helps to find and fix potential bugs:
     - [Other IDEs](#other-ides)
     - [mypy](#mypy)
     - [pyright](#pyright)
+    - [Pylint compatibility](#pylint-compatibility)
   - [Explicit type annotations](#explicit-type-annotations)
     - [Client annotations](#client-annotations)
     - [Paginators annotations](#paginators-annotations)
@@ -189,16 +189,31 @@ annotations required, write your `boto3` code as usual.
 
 ### PyCharm
 
-Install `boto3-stubs-lite[dynamodb]` in your environment:
+> ⚠️ Due to slow PyCharm performance on `Literal` overloads (issue
+> [PY-40997](https://youtrack.jetbrains.com/issue/PY-40997)), it is recommended
+> to use [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/) until
+> the issue is resolved.
+
+> ⚠️ If you experience slow performance and high CPU usage, try to disable
+> `PyCharm` type checker and use [mypy](https://github.com/python/mypy) or
+> [pyright](https://github.com/microsoft/pyright) instead.
+
+> ⚠️ To continue using `PyCharm` type checker, you can try to replace
+> `boto3-stubs` with
+> [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/):
 
 ```bash
-python -m pip install 'boto3-stubs-lite[dynamodb]'
+pip uninstall boto3-stubs
+pip install boto3-stubs-lite
 ```
 
-Both type checking and code completion should now work. Explicit type
-annotations **are required**.
+Install `boto3-stubs[dynamodb]` in your environment:
+
+```bash
+python -m pip install 'boto3-stubs[dynamodb]'
+```
 
-Use `boto3-stubs` package instead for implicit type discovery.
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -284,6 +299,31 @@ Optionally, you can install `boto3-stubs` to `typings` directory.
 Type checking should now work. No explicit type annotations required, write
 your `boto3` code as usual.
 
+<a id="pylint-compatibility"></a>
+
+### Pylint compatibility
+
+It is totally safe to use `TYPE_CHECKING` flag in order to avoid
+`mypy-boto3-dynamodb` dependency in production. However, there is an issue in
+`pylint` that it complains about undefined variables. To fix it, set all types
+to `object` in non-`TYPE_CHECKING` mode.
+
+```python
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from mypy_boto3_ec2 import EC2Client, EC2ServiceResource
+    from mypy_boto3_ec2.waiters import BundleTaskCompleteWaiter
+    from mypy_boto3_ec2.paginators import DescribeVolumesPaginator
+else:
+    EC2Client = object
+    EC2ServiceResource = object
+    BundleTaskCompleteWaiter = object
+    DescribeVolumesPaginator = object
+
+...
+```
+
 <a id="explicit-type-annotations"></a>
 
 ## Explicit type annotations

{mypy_boto3_dynamodb-1.35.54 → mypy_boto3_dynamodb-1.35.74}/README.md

@@ -2,16 +2,15 @@
 
 # mypy-boto3-dynamodb
 
-[![PyPI - mypy-boto3-dynamodb](https://img.shields.io/pypi/v/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb)
-[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/)
-[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-dynamodb)](https://pepy.tech/project/mypy-boto3-dynamodb)
+[![PyPI - mypy-boto3-dynamodb](https://img.shields.io/pypi/v/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mypy-boto3-dynamodb.svg?color=blue)](https://pypi.org/project/mypy-boto3-dynamodb/)
+[![Docs](https://img.shields.io/readthedocs/boto3-stubs.svg?color=blue)](https://youtype.github.io/boto3_stubs_docs/)
+[![PyPI - Downloads](https://static.pepy.tech/badge/mypy-boto3-dynamodb)](https://pypistats.org/packages/mypy-boto3-dynamodb)
 
 ![boto3.typed](https://github.com/youtype/mypy_boto3_builder/raw/main/logo.png)
 
-Type annotations for
-[boto3.DynamoDB 1.35.54](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB)
-service compatible with [VSCode](https://code.visualstudio.com/),
+Type annotations for [boto3 DynamoDB 1.35.74](https://pypi.org/project/boto3/)
+compatible with [VSCode](https://code.visualstudio.com/),
 [PyCharm](https://www.jetbrains.com/pycharm/),
 [Emacs](https://www.gnu.org/software/emacs/),
 [Sublime Text](https://www.sublimetext.com/),
@@ -19,15 +18,15 @@ service compatible with [VSCode](https://code.visualstudio.com/),
 [pyright](https://github.com/microsoft/pyright) and other tools.
 
 Generated by
-[mypy-boto3-builder 8.2.0](https://github.com/youtype/mypy_boto3_builder).
+[mypy-boto3-builder 8.5.0](https://github.com/youtype/mypy_boto3_builder).
 
 More information can be found on
 [boto3-stubs](https://pypi.org/project/boto3-stubs/) page and in
 [mypy-boto3-dynamodb docs](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb/).
 
-See how it helps to find and fix potential bugs:
+See how it helps you find and fix potential bugs:
 
-![boto3-stubs demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
+![types-boto3 demo](https://github.com/youtype/mypy_boto3_builder/raw/main/demo.gif)
 
 - [mypy-boto3-dynamodb](#mypy-boto3-dynamodb)
   - [How to install](#how-to-install)
@@ -43,6 +42,7 @@ See how it helps to find and fix potential bugs:
     - [Other IDEs](#other-ides)
     - [mypy](#mypy)
     - [pyright](#pyright)
+    - [Pylint compatibility](#pylint-compatibility)
   - [Explicit type annotations](#explicit-type-annotations)
     - [Client annotations](#client-annotations)
     - [Paginators annotations](#paginators-annotations)
@@ -155,16 +155,31 @@ annotations required, write your `boto3` code as usual.
 
 ### PyCharm
 
-Install `boto3-stubs-lite[dynamodb]` in your environment:
+> ⚠️ Due to slow PyCharm performance on `Literal` overloads (issue
+> [PY-40997](https://youtrack.jetbrains.com/issue/PY-40997)), it is recommended
+> to use [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/) until
+> the issue is resolved.
+
+> ⚠️ If you experience slow performance and high CPU usage, try to disable
+> `PyCharm` type checker and use [mypy](https://github.com/python/mypy) or
+> [pyright](https://github.com/microsoft/pyright) instead.
+
+> ⚠️ To continue using `PyCharm` type checker, you can try to replace
+> `boto3-stubs` with
+> [boto3-stubs-lite](https://pypi.org/project/boto3-stubs-lite/):
 
 ```bash
-python -m pip install 'boto3-stubs-lite[dynamodb]'
+pip uninstall boto3-stubs
+pip install boto3-stubs-lite
 ```
 
-Both type checking and code completion should now work. Explicit type
-annotations **are required**.
+Install `boto3-stubs[dynamodb]` in your environment:
+
+```bash
+python -m pip install 'boto3-stubs[dynamodb]'
+```
 
-Use `boto3-stubs` package instead for implicit type discovery.
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -250,6 +265,31 @@ Optionally, you can install `boto3-stubs` to `typings` directory.
 Type checking should now work. No explicit type annotations required, write
 your `boto3` code as usual.
 
+<a id="pylint-compatibility"></a>
+
+### Pylint compatibility
+
+It is totally safe to use `TYPE_CHECKING` flag in order to avoid
+`mypy-boto3-dynamodb` dependency in production. However, there is an issue in
+`pylint` that it complains about undefined variables. To fix it, set all types
+to `object` in non-`TYPE_CHECKING` mode.
+
+```python
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from mypy_boto3_ec2 import EC2Client, EC2ServiceResource
+    from mypy_boto3_ec2.waiters import BundleTaskCompleteWaiter
+    from mypy_boto3_ec2.paginators import DescribeVolumesPaginator
+else:
+    EC2Client = object
+    EC2ServiceResource = object
+    BundleTaskCompleteWaiter = object
+    DescribeVolumesPaginator = object
+
+...
+```
+
 <a id="explicit-type-annotations"></a>
 
 ## Explicit type annotations

mypy_boto3_dynamodb-1.35.54/mypy_boto3_dynamodb/__init__.pyi → mypy_boto3_dynamodb-1.35.74/mypy_boto3_dynamodb/__init__.py

@@ -33,6 +33,8 @@ Usage::
     query_paginator: QueryPaginator = client.get_paginator("query")
     scan_paginator: ScanPaginator = client.get_paginator("scan")
     ```
+
+Copyright 2024 Vlad Emelianov
 """
 
 from .client import DynamoDBClient
@@ -48,8 +50,10 @@ from .waiter import TableExistsWaiter, TableNotExistsWaiter
 
 Client = DynamoDBClient
 
+
 ServiceResource = DynamoDBServiceResource
 
+
 __all__ = (
     "Client",
     "DynamoDBClient",

mypy_boto3_dynamodb-1.35.54/mypy_boto3_dynamodb/__init__.py → mypy_boto3_dynamodb-1.35.74/mypy_boto3_dynamodb/__init__.pyi

@@ -33,6 +33,8 @@ Usage::
     query_paginator: QueryPaginator = client.get_paginator("query")
     scan_paginator: ScanPaginator = client.get_paginator("scan")
     ```
+
+Copyright 2024 Vlad Emelianov
 """
 
 from .client import DynamoDBClient
@@ -48,10 +50,8 @@ from .waiter import TableExistsWaiter, TableNotExistsWaiter
 
 Client = DynamoDBClient
 
-
 ServiceResource = DynamoDBServiceResource
 
-
 __all__ = (
     "Client",
     "DynamoDBClient",

{mypy_boto3_dynamodb-1.35.54 → mypy_boto3_dynamodb-1.35.74}/mypy_boto3_dynamodb/__main__.py

@@ -1,5 +1,7 @@
 """
 Main CLI entrypoint.
+
+Copyright 2024 Vlad Emelianov
 """
 
 import sys
@@ -10,11 +12,11 @@ def print_info() -> None:
     Print package info to stdout.
     """
     print(
-        "Type annotations for boto3.DynamoDB 1.35.54\n"
-        "Version:         1.35.54\n"
-        "Builder version: 8.2.0\n"
+        "Type annotations for boto3 DynamoDB 1.35.74\n"
+        "Version:         1.35.74\n"
+        "Builder version: 8.5.0\n"
         "Docs:            https://youtype.github.io/boto3_stubs_docs/mypy_boto3_dynamodb//\n"
-        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#DynamoDB\n"
+        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#dynamodb\n"
         "Other services:  https://pypi.org/project/boto3-stubs/\n"
         "Changelog:       https://github.com/youtype/mypy_boto3_builder/releases"
     )
@@ -24,7 +26,7 @@ def print_version() -> None:
     """
     Print package version to stdout.
     """
-    print("1.35.54")
+    print("1.35.74")
 
 
 def main() -> None: