Registry /
type-stubs / mypy-boto3-wellarchitected
Install & Compatibility
Where this runs
tested against v1.43.70 · 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.4s · import 0.000s · 21MB
18MB installed
● package 18MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
WellArchitectedClient
✓ from mypy_boto3_wellarchitected import WellArchitectedClient
✗ from mypy_boto3_wellarchitected import WellArchitectedClient
This quickstart demonstrates how to obtain a type-hinted `WellArchitectedClient` using `boto3` and the `mypy-boto3-wellarchitected` stubs. It uses environment variables for AWS credentials, which is good practice. The `list_workloads` call is included to show typical client interaction, though it requires valid AWS credentials and permissions to execute successfully.
import os
import boto3
from mypy_boto3_wellarchitected.client import WellArchitectedClient
def get_wellarchitected_client() -> WellArchitectedClient:
"""Initializes and returns a WellArchitectedClient with type annotations."""
session = boto3.Session(
aws_access_key_id=os.environ.get('AWS_ACCESS_KEY_ID', 'DUMMY_KEY'),
aws_secret_access_key=os.environ.get('AWS_SECRET_ACCESS_KEY', 'DUMMY_SECRET'),
region_name=os.environ.get('AWS_REGION', 'us-east-1')
)
client: WellArchitectedClient = session.client("wellarchitected")
return client
# Example usage (will require valid AWS credentials for actual execution)
if __name__ == "__main__":
try:
wa_client = get_wellarchitected_client()
# This call will typically fail without proper credentials and permissions
# but demonstrates type-hinted client usage.
response = wa_client.list_workloads(
MaxResults=10
)
print("Successfully initialized WellArchitected client (response may be empty/error without valid creds).")
# print(response.get('WorkloadSummaries'))
except Exception as e:
print(f"An error occurred: {e}")
Debug
Known issues
breakingSupport for Python 3.8 has been removed in `mypy-boto3-builder` version 8.12.0 and subsequent `mypy-boto3` packages. Users on Python 3.8 will need to upgrade to Python 3.9 or higher.fixUpgrade your Python environment to 3.9 or newer.
affects: >=8.12.0 of mypy-boto3-builder, affecting mypy-boto3-wellarchitected versions built with it
breakingIn `mypy-boto3-builder` version 8.9.0, TypeDef names for packed method arguments were shortened, and conflicting `Extra` postfixes were moved. If you have explicitly imported or referenced generated `TypeDef` names, these may have changed.fixReview your code for direct imports of `TypeDef` objects from `mypy_boto3_wellarchitected.type_defs` and adjust to the new naming conventions if they break.
affects: >=8.9.0 of mypy-boto3-builder, affecting mypy-boto3-wellarchitected versions built with it
gotchaThe `mypy-boto3` ecosystem migrated to PEP 561 packages in `mypy-boto3-builder` 8.12.0. While beneficial for type checkers, it might cause unexpected behavior with older `pip` versions or custom build systems that do not correctly handle PEP 561 stub distribution.fixEnsure your `pip` is up-to-date (`pip install --upgrade pip`) and your build environment correctly recognizes PEP 561 compliant stub packages.
affects: >=8.12.0 of mypy-boto3-builder, affecting mypy-boto3-wellarchitected versions built with it
gotchaFor optimal type checking and compatibility, the version of `mypy-boto3-wellarchitected` should ideally align with the version of `boto3` you are using. Mismatched versions can lead to incorrect type hints or missing attributes, especially after significant `boto3` updates.fixKeep `mypy-boto3-wellarchitected` updated to a version compatible with your `boto3` installation. The `mypy-boto3` documentation often suggests installing with `boto3-stubs[boto3]` to ensure synchronization.
affects: All versions
Upgrade
Version history
1.43.70latest on PyPI · released Aug 12, 2026
Audit
Dependencies
boto3requiredRuntime dependency for AWS SDK functionality; stubs are for this library.
mypyoptionalRequired for static type checking, the primary purpose of the library.