Registry /
type-stubs / types-aiobotocore-dynamodb
Install & Compatibility
Where this runs
tested against v3.9.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 19.7MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.2s · import 0.000s · 20MB
18MB installed
● package 18MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
DynamoDBClient
✓ from types_aiobotocore_dynamodb import DynamoDBClient
✗ from types_aiobotocore_dynamodb import DynamoDBClient
This quickstart demonstrates how to use `types-aiobotocore-dynamodb` to get type hints for an `aiobotocore` DynamoDB client, then list tables in your AWS account. It leverages `aiobotocore`'s automatic credential discovery.
import asyncio
import os
from aiobotocore.session import get_session
from types_aiobotocore_dynamodb.client import DynamoDBClient
async def list_dynamodb_tables():
# aiobotocore automatically picks up credentials from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION)
# or ~/.aws/credentials and ~/.aws/config
session = get_session()
async with session.create_client("dynamodb", region_name=os.environ.get('AWS_REGION', 'us-east-1')) as client:
client: DynamoDBClient # Explicit type hint for static analysis
print(f"Listing DynamoDB tables in {client.meta.region_name}...")
response = await client.list_tables()
tables = response.get("TableNames", [])
if tables:
print("Found tables:", ", ".join(tables))
else:
print("No tables found.")
if __name__ == "__main__":
# Ensure AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION are set in your environment
# For a runnable example, you might need valid AWS credentials configured.
# Example placeholder: os.environ['AWS_REGION'] = 'us-east-1'
asyncio.run(list_dynamodb_tables())
Debug
Known issues
breakingPython 3.8 support has been removed in `mypy-boto3-builder` version 8.12.0, which generates these type stubs. Users on Python 3.8 or older will need to upgrade to Python 3.9+ to use the latest versions of these stubs.fixUpgrade your Python environment to 3.9 or newer.
affects: >=8.12.0 (mypy-boto3-builder)
breakingThe underlying `mypy-boto3-builder` (version 8.12.0) migrated to PEP 561 compliant packages. This change might affect how type checkers or development environments discover and resolve type stubs, particularly in complex project setups.fixEnsure your type checker (e.g., MyPy, Pyright) and IDE are updated and correctly configured to recognize PEP 561 stub packages.
affects: >=8.12.0 (mypy-boto3-builder)
breakingStarting with `mypy-boto3-builder` 8.9.0, some TypeDef names may have been shortened or altered (e.g., `CreateDistributionRequestRequestTypeDef` to `CreateDistributionRequestTypeDef`) or conflicting postfixes moved for consistency. This could break explicit references to these TypedDicts in your code.fixReview and update explicit TypeDef imports and references in your codebase according to the latest documentation or builder output.
affects: >=8.9.0 (mypy-boto3-builder)
gotchaThe `types-aiobotocore` ecosystem generates separate packages for each AWS service (e.g., `types-aiobotocore-dynamodb`). Installing only `types-aiobotocore` (without service extras or the `full` extra) will not provide type hints for individual services like DynamoDB.fixInstall the specific service package (e.g., `pip install types-aiobotocore-dynamodb`) or use `pip install 'types-aiobotocore[dynamodb]'` or `pip install 'types-aiobotocore[full]'` to ensure all necessary type stubs are available.
affects: All versions
gotchaWhile many IDEs and static analyzers can infer types implicitly, for `types-aiobotocore-lite` or standalone service packages, explicit type annotations (e.g., `client: DynamoDBClient`) might be required or provide clearer hints for optimal type checking and autocompletion.fixAdd explicit type annotations when type inference is insufficient or for improved code clarity.
affects: All versions
gotchaPyCharm users might experience slow performance with `Literal` overloads provided by these stubs (due to PyCharm issue PY-40997). The documentation recommends using `types-aiobotocore-lite` or disabling PyCharm's internal type checker in favor of external tools like MyPy or Pyright.fixConsider `pip install types-aiobotocore-lite` for better performance or configure PyCharm to use an external type checker.
affects: All versions (PyCharm specific)
Upgrade
Version history
3.9.0latest on PyPI · released Aug 2, 2026
Audit
Dependencies
aiobotocorerequiredProvides the asynchronous AWS client library for which these type stubs are generated.