Registry /
type-stubs / mypy-boto3-clouddirectory
Install & Compatibility
Where this runs
tested against v1.43.69 · 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.95 runs
installs and imports cleanly · install 0.0s · import 0.650s · 52.2MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.9s · import 0.624s · 53MB
51MB installed
● package 51MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CloudDirectoryClient
✓ from mypy_boto3_clouddirectory.client import CloudDirectoryClient
ListDirectoriesResponseTypeDef
✓ from mypy_boto3_clouddirectory.type_defs import ListDirectoriesResponseTypeDef
This quickstart demonstrates how to instantiate a boto3 CloudDirectory client with explicit type annotations using `mypy-boto3-clouddirectory`. It then calls `list_directories` and accesses the type-hinted response data, showing how the stub types improve code completion and static analysis.
import boto3
from mypy_boto3_clouddirectory.client import CloudDirectoryClient
from mypy_boto3_clouddirectory.type_defs import ListDirectoriesResponseTypeDef
def list_clouddirectory_stuff() -> ListDirectoriesResponseTypeDef:
# Initialize a CloudDirectory client with type hints
client: CloudDirectoryClient = boto3.client("clouddirectory")
# Call an API operation; mypy will check arguments and return types
response: ListDirectoriesResponseTypeDef = client.list_directories(
MaxResults=5
)
print(f"Found {len(response.get('Directories', []))} directories.")
# Example of accessing type-hinted data
for directory in response.get('Directories', []):
print(f" - Directory ARN: {directory['DirectoryArn']}")
return response
if __name__ == "__main__":
# This code requires AWS credentials configured (e.g., via AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY env vars)
# or a configured AWS CLI profile.
# If no credentials are found, boto3 will raise a ClientError.
try:
list_clouddirectory_stuff()
except Exception as e:
print(f"An error occurred: {e}")
print("Please ensure AWS credentials are configured (e.g., ~/.aws/credentials or environment variables).")
Debug
Known issues
breakingSupport for Python 3.8 has been removed in `mypy-boto3-builder` version 8.12.0 and later. Projects using this library must use Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or higher.
affects: mypy-boto3-builder >=8.12.0
breakingThe `mypy-boto3-builder` migrated to PEP 561 compliant packages in version 8.12.0. This might affect how packages are discovered or handled by some tools, especially in complex project setups.fixEnsure your build and type-checking environments are updated to correctly resolve PEP 561 packages. Most modern tools should handle this automatically.
affects: mypy-boto3-builder >=8.12.0
breakingTypeDef naming conventions changed in `mypy-boto3-builder` version 8.9.0. Specifically, redundant `Request` postfixes were removed (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`), and `Extra` postfixes moved to the end of names. This could break existing explicit type annotations in your code.fixReview and update explicit `TypeDef` annotations in your codebase to match the new naming conventions, or rely on implicit type inference where possible.
affects: mypy-boto3-builder >=8.9.0
deprecatedThe `sms-voice` service was removed from `mypy-boto3-builder` in version 8.11.0. If your project uses type annotations for this service, you should migrate to `pinpoint-sms-voice`.fixMigrate your code and type annotations from the `sms-voice` service to the `pinpoint-sms-voice` service stubs.
affects: mypy-boto3-builder >=8.11.0
gotchaPyCharm users might experience slow performance or high CPU usage due to `Literal` overloads when using the full `boto3-stubs` or standalone `mypy-boto3-*` packages. The `boto3-stubs-lite` versions are recommended as a workaround until the upstream PyCharm issue is resolved.fixConsider installing `boto3-stubs-lite[clouddirectory]` (if available for the specific service) or disabling PyCharm's internal type checker and using `mypy` or `pyright` instead for type analysis.
affects: All versions, specifically with PyCharm
Upgrade
Version history
1.43.69latest on PyPI · released Aug 11, 2026
Audit
Dependencies
boto3requiredProvides the core AWS SDK functionality that these type stubs annotate.