Install & Compatibility
Where this runs
tested against v1.43.71 · 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.000s · 52.6MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.9s · import 0.000s · 53MB
51MB installed
● package 51MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CleanRoomsClient
✓ from mypy_boto3_cleanrooms.client import CleanRoomsClient
CreateConfiguredTableInputRequestTypeDef
✓ from mypy_boto3_cleanrooms.type_defs import CreateConfiguredTableInputRequestTypeDef
✗ from mypy_boto3_cleanrooms.type_defs import CreateConfiguredTableRequestRequestTypeDef
TypeDef names were shortened in version 8.9.0 of mypy-boto3-builder.
Paginator
✓ from mypy_boto3_cleanrooms.paginator import ListConfiguredTablesPaginator
Waiter
✓ from mypy_boto3_cleanrooms.waiter import ConfiguredTableReadyWaiter
Waiters are available for some services; import specific ones as needed.
This quickstart demonstrates how to initialize a `boto3` CleanRooms client and perform a basic operation (`list_configured_tables`) with full type-hinting provided by `mypy-boto3-cleanrooms`. It highlights how `CleanRoomsClient` and `ListConfiguredTablesOutputTypeDef` enable static analysis and autocompletion.
import boto3
from mypy_boto3_cleanrooms.client import CleanRoomsClient
from mypy_boto3_cleanrooms.type_defs import ListConfiguredTablesOutputTypeDef
import os
# Initialize a CleanRooms client with type hints
cleanrooms_client: CleanRoomsClient = boto3.client(
"cleanrooms",
region_name=os.environ.get("AWS_REGION", "us-east-1")
)
# Use the client with type-checked parameters and responses
try:
response: ListConfiguredTablesOutputTypeDef = cleanrooms_client.list_configured_tables(
maxResults=10
)
print("Successfully listed configured tables:")
for table in response.get("configuredTableSummaries", []):
print(f" - {table['name']} ({table['id']})")
except Exception as e:
print(f"Error listing configured tables: {e}")
# Example of using a specific type definition for input
# from mypy_boto3_cleanrooms.type_defs import CreateConfiguredTableInputRequestTypeDef
# create_table_input: CreateConfiguredTableInputRequestTypeDef = {
# "name": "my-test-table",
# "description": "My configured table description",
# "tableReferences": [{"lambda": {...}}],
# "allowedColumns": ["id", "name"]
# }
# cleanrooms_client.create_configured_table(**create_table_input)
Debug
Known issues
breakingPython 3.8 support has been removed. All `mypy-boto3-*` packages, including `mypy-boto3-cleanrooms`, now require Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or a newer version.
affects: mypy-boto3-builder 8.12.0 and later (corresponds to mypy-boto3-cleanrooms 1.42.52 and later)
breakingTypeDef naming conventions changed, shortening names (e.g., `CreateConfiguredTableRequestRequestTypeDef` to `CreateConfiguredTableInputRequestTypeDef`) and moving 'Extra' postfixes. This may break existing explicit type hints.fixReview and update specific `TypeDef` imports and annotations in your codebase to reflect the new shorter names.
affects: mypy-boto3-builder 8.9.0 and later
gotchaThis library provides only type stubs, not the runtime functionality of boto3. You must install `boto3` separately for your code to run.fixEnsure `boto3` is included in your project dependencies: `pip install boto3 mypy-boto3-cleanrooms`.
affects: All versions
gotchaThe `mypy-boto3-cleanrooms` version aligns with the `boto3` version it provides stubs for. Significant mismatches between your installed `boto3` version and `mypy-boto3-cleanrooms` version can lead to incorrect or missing type hints.fixKeep `mypy-boto3-cleanrooms` and `boto3` versions as closely aligned as possible for optimal type checking accuracy.
affects: All versions
gotchaThe builder migrated to PEP 561 compliance, which typically improves type checker discovery but might affect custom build or packaging setups that relied on older stub discovery mechanisms.fixVerify that your type checker (e.g., MyPy) correctly discovers the stubs after updating. Standard `pip install` usually handles this seamlessly.
affects: mypy-boto3-builder 8.12.0 and later (corresponds to mypy-boto3-cleanrooms 1.42.52 and later)
Upgrade
Version history
1.43.71latest on PyPI · released Aug 13, 2026
Audit
Dependencies
boto3requiredProvides the actual runtime functionality for interacting with AWS services. `mypy-boto3-cleanrooms` only provides type stubs.