mypy-boto3-dynamodb 1.35.60__tar.gz → 1.35.93__tar.gz

{mypy_boto3_dynamodb-1.35.60 → mypy_boto3_dynamodb-1.35.93}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Vlad Emelianov
+Copyright (c) 2025 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

{mypy_boto3_dynamodb-1.35.60 → mypy_boto3_dynamodb-1.35.93}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: mypy-boto3-dynamodb
-Version: 1.35.60
-Summary: Type annotations for boto3.DynamoDB 1.35.60 service generated with mypy-boto3-builder 8.2.1
+Version: 1.35.93
+Summary: Type annotations for boto3 DynamoDB 1.35.93 service generated with mypy-boto3-builder 8.8.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
@@ -30,41 +30,41 @@ Classifier: Typing :: Stubs Only
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typing-extensions>=4.1.0; python_version < "3.12"
+Requires-Dist: typing-extensions; python_version < "3.12"
 
 <a id="mypy-boto3-dynamodb"></a>
 
 # 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.60](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.93](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/),
 [mypy](https://github.com/python/mypy),
 [pyright](https://github.com/microsoft/pyright) and other tools.
 
-Generated by
-[mypy-boto3-builder 8.2.1](https://github.com/youtype/mypy_boto3_builder).
+Generated with
+[mypy-boto3-builder 8.8.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)
+    - [Generate locally (recommended)](<#generate-locally-(recommended)>)
     - [VSCode extension](#vscode-extension)
     - [From PyPI with pip](#from-pypi-with-pip)
     - [From conda-forge](#from-conda-forge)
@@ -77,6 +77,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)
@@ -99,6 +100,21 @@ See how it helps to find and fix potential bugs:
 
 ## How to install
 
+<a id="generate-locally-(recommended)"></a>
+
+### Generate locally (recommended)
+
+You can generate type annotations for `boto3` package locally with
+`mypy_boto3_builder`. Use
+[uv](https://docs.astral.sh/uv/getting-started/installation/) for build
+isolation.
+
+1. Run mypy-boto3-builder in your package root directory:
+   `uvx --with 'boto3==1.35.93' mypy_boto3_builder`
+2. Select `boto3-stubs` AWS SDK.
+3. Add `DynamoDB` service.
+4. Use provided commands to install generated packages.
+
 <a id="vscode-extension"></a>
 
 ### VSCode extension
@@ -119,12 +135,10 @@ Install `boto3-stubs` for `DynamoDB` service.
 # install with boto3 type annotations
 python -m pip install 'boto3-stubs[dynamodb]'
 
-
 # Lite version does not provide session.client/resource overloads
 # it is more RAM-friendly, but requires explicit type annotations
 python -m pip install 'boto3-stubs-lite[dynamodb]'
 
-
 # standalone installation
 python -m pip install mypy-boto3-dynamodb
 ```
@@ -133,8 +147,7 @@ python -m pip install mypy-boto3-dynamodb
 
 ### From conda-forge
 
-Installing `mypy-boto3-dynamodb` from the `conda-forge` channel can be achieved
-by adding `conda-forge` to your channels with:
+Add `conda-forge` to your channels with:
 
 ```bash
 conda config --add channels conda-forge
@@ -148,8 +161,8 @@ installed with:
 conda install mypy-boto3-dynamodb
 ```
 
-It is possible to list all of the versions of `mypy-boto3-dynamodb` available
-on your platform with:
+List all available versions of `mypy-boto3-dynamodb` available on your platform
+with:
 
 ```bash
 conda search mypy-boto3-dynamodb --channel conda-forge
@@ -189,16 +202,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:
 
-Use `boto3-stubs` package instead for implicit type discovery.
+```bash
+python -m pip install 'boto3-stubs[dynamodb]'
+```
+
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -284,6 +312,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.60 → mypy_boto3_dynamodb-1.35.93}/README.md

@@ -2,35 +2,35 @@
 
 # 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.60](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.93](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/),
 [mypy](https://github.com/python/mypy),
 [pyright](https://github.com/microsoft/pyright) and other tools.
 
-Generated by
-[mypy-boto3-builder 8.2.1](https://github.com/youtype/mypy_boto3_builder).
+Generated with
+[mypy-boto3-builder 8.8.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)
+    - [Generate locally (recommended)](<#generate-locally-(recommended)>)
     - [VSCode extension](#vscode-extension)
     - [From PyPI with pip](#from-pypi-with-pip)
     - [From conda-forge](#from-conda-forge)
@@ -43,6 +43,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)
@@ -65,6 +66,21 @@ See how it helps to find and fix potential bugs:
 
 ## How to install
 
+<a id="generate-locally-(recommended)"></a>
+
+### Generate locally (recommended)
+
+You can generate type annotations for `boto3` package locally with
+`mypy_boto3_builder`. Use
+[uv](https://docs.astral.sh/uv/getting-started/installation/) for build
+isolation.
+
+1. Run mypy-boto3-builder in your package root directory:
+   `uvx --with 'boto3==1.35.93' mypy_boto3_builder`
+2. Select `boto3-stubs` AWS SDK.
+3. Add `DynamoDB` service.
+4. Use provided commands to install generated packages.
+
 <a id="vscode-extension"></a>
 
 ### VSCode extension
@@ -85,12 +101,10 @@ Install `boto3-stubs` for `DynamoDB` service.
 # install with boto3 type annotations
 python -m pip install 'boto3-stubs[dynamodb]'
 
-
 # Lite version does not provide session.client/resource overloads
 # it is more RAM-friendly, but requires explicit type annotations
 python -m pip install 'boto3-stubs-lite[dynamodb]'
 
-
 # standalone installation
 python -m pip install mypy-boto3-dynamodb
 ```
@@ -99,8 +113,7 @@ python -m pip install mypy-boto3-dynamodb
 
 ### From conda-forge
 
-Installing `mypy-boto3-dynamodb` from the `conda-forge` channel can be achieved
-by adding `conda-forge` to your channels with:
+Add `conda-forge` to your channels with:
 
 ```bash
 conda config --add channels conda-forge
@@ -114,8 +127,8 @@ installed with:
 conda install mypy-boto3-dynamodb
 ```
 
-It is possible to list all of the versions of `mypy-boto3-dynamodb` available
-on your platform with:
+List all available versions of `mypy-boto3-dynamodb` available on your platform
+with:
 
 ```bash
 conda search mypy-boto3-dynamodb --channel conda-forge
@@ -155,16 +168,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:
 
-Use `boto3-stubs` package instead for implicit type discovery.
+```bash
+python -m pip install 'boto3-stubs[dynamodb]'
+```
+
+Both type checking and code completion should now work.
 
 <a id="emacs"></a>
 
@@ -250,6 +278,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.60/mypy_boto3_dynamodb/__init__.pyi → mypy_boto3_dynamodb-1.35.93/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 2025 Vlad Emelianov
 """
 
 from .client import DynamoDBClient
@@ -43,13 +45,20 @@ from .paginator import (
     QueryPaginator,
     ScanPaginator,
 )
-from .service_resource import DynamoDBServiceResource
 from .waiter import TableExistsWaiter, TableNotExistsWaiter
 
+try:
+    from .service_resource import DynamoDBServiceResource
+except ImportError:
+    from builtins import object as DynamoDBServiceResource  # type: ignore[assignment]
+
+
 Client = DynamoDBClient
 
+
 ServiceResource = DynamoDBServiceResource
 
+
 __all__ = (
     "Client",
     "DynamoDBClient",

mypy_boto3_dynamodb-1.35.60/mypy_boto3_dynamodb/__init__.py → mypy_boto3_dynamodb-1.35.93/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 2025 Vlad Emelianov
 """
 
 from .client import DynamoDBClient
@@ -43,15 +45,17 @@ from .paginator import (
     QueryPaginator,
     ScanPaginator,
 )
-from .service_resource import DynamoDBServiceResource
 from .waiter import TableExistsWaiter, TableNotExistsWaiter
 
-Client = DynamoDBClient
+try:
+    from .service_resource import DynamoDBServiceResource
+except ImportError:
+    from builtins import object as DynamoDBServiceResource  # type: ignore[assignment]
 
+Client = DynamoDBClient
 
 ServiceResource = DynamoDBServiceResource
 
-
 __all__ = (
     "Client",
     "DynamoDBClient",

{mypy_boto3_dynamodb-1.35.60 → mypy_boto3_dynamodb-1.35.93}/mypy_boto3_dynamodb/__main__.py

@@ -1,5 +1,7 @@
 """
 Main CLI entrypoint.
+
+Copyright 2025 Vlad Emelianov
 """
 
 import sys
@@ -9,14 +11,14 @@ def print_info() -> None:
     """
     Print package info to stdout.
     """
-    print(
-        "Type annotations for boto3.DynamoDB 1.35.60\n"
-        "Version:         1.35.60\n"
-        "Builder version: 8.2.1\n"
+    sys.stdout.write(
+        "Type annotations for boto3 DynamoDB 1.35.93\n"
+        "Version:         1.35.93\n"
+        "Builder version: 8.8.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"
+        "Changelog:       https://github.com/youtype/mypy_boto3_builder/releases\n"
     )
 
 
@@ -24,7 +26,7 @@ def print_version() -> None:
     """
     Print package version to stdout.
     """
-    print("1.35.60")
+    sys.stdout.write("1.35.93\n")
 
 
 def main() -> None:
@@ -32,7 +34,8 @@ def main() -> None:
     Main CLI entrypoint.
     """
     if "--version" in sys.argv:
-        return print_version()
+        print_version()
+        return
     print_info()