Registry /
type-stubs / types-aiobotocore-cloudformation
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 · 20MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.1s · import 0.000s · 20MB
18MB installed
● package 18MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CloudFormationClient
✓ from types_aiobotocore_cloudformation import CloudFormationClient
✗ from types_aiobotocore_cloudformation import CloudFormationClient
This quickstart demonstrates how to obtain a typed `CloudFormationClient` using `aiobotocore` and interact with the CloudFormation service to list stacks. The `TYPE_CHECKING` block ensures that the explicit type imports for `CloudFormationClient` and `StackSummaryTypeDef` are only used during type checking, avoiding a runtime dependency on the stub package.
import asyncio
import os
from typing import TYPE_CHECKING
import aiobotocore.session
if TYPE_CHECKING:
from types_aiobotocore_cloudformation.client import CloudFormationClient
from types_aiobotocore_cloudformation.type_defs import StackSummaryTypeDef
async def list_cloudformation_stacks():
session = aiobotocore.session.get_session()
async with session.create_client(
"cloudformation",
region_name=os.environ.get('AWS_REGION', 'us-east-1'),
aws_access_key_id=os.environ.get('AWS_ACCESS_KEY_ID', 'testing'),
aws_secret_access_key=os.environ.get('AWS_SECRET_ACCESS_KEY', 'testing')
) as client:
# The client variable is automatically type-hinted as CloudFormationClient
client: "CloudFormationClient"
response = await client.list_stacks()
for stack in response.get("StackSummaries", []):
stack_summary: "StackSummaryTypeDef" = stack
print(f"Stack Name: {stack_summary['StackName']}, Status: {stack_summary['StackStatus']}")
if __name__ == "__main__":
asyncio.run(list_cloudformation_stacks())
Debug
Known issues
breakingPython 3.8 support has been removed since `mypy-boto3-builder` version 8.12.0. Users on Python 3.8 or older will need to upgrade their Python version to use the latest `types-aiobotocore-cloudformation` stubs.fixUpgrade your Python environment to 3.9 or newer.
affects: >=3.4.0 (generated by mypy-boto3-builder 8.12.0)
breakingThe `mypy-boto3-builder` migrated to PEP 561 compliant packages in version 8.12.0. While largely transparent, this may impact specific environments or custom type-checking configurations if they relied on older package structures.fixEnsure your type checker (e.g., mypy, pyright) and environment are up-to-date. Reinstalling the package may resolve any pathing issues.
affects: >=3.4.0 (generated by mypy-boto3-builder 8.12.0)
breakingTypeDef names might have changed to shorter versions (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`) or had postfixes moved (`CreateDistributionExtraRequestTypeDef` -> `CreateDistributionRequestExtraTypeDef`) in `mypy-boto3-builder` 8.9.0. This could break direct imports or references to specific TypeDef names.fixConsult the generated documentation for the specific service to find the correct TypeDef names, or update your code to use the new shorter names.
affects: >=3.x.x (generated by mypy-boto3-builder 8.9.0)
gotchaFor full type checking capabilities, both `aiobotocore` and the corresponding `types-aiobotocore-*` stub packages must be installed. Without the stub package, type checkers will have limited or no information for `aiobotocore` calls.fixAlways install `types-aiobotocore-cloudformation` alongside `aiobotocore` in your development environment for static analysis.
affects: All versions
gotchaIn some IDEs like PyCharm, using `types-aiobotocore` can lead to slow performance or high CPU usage. Workarounds include disabling PyCharm's internal type checker, using external checkers like mypy/pyright, or installing `types-aiobotocore-lite` for a more RAM-friendly option that might require more explicit type annotations.fixIf experiencing performance issues, switch to an external type checker or consider `types-aiobotocore-lite`.
affects: All versions
Upgrade
Version history
3.9.0latest on PyPI · released Aug 2, 2026
Audit
Dependencies
aiobotocoreoptionalProvides the runtime asynchronous AWS client functionality that these stubs type-check. While not a hard runtime dependency, the stubs are useless without the core library.