Install & Compatibility
Where this runs
tested against v1.43.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.9MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.4s · import 0.000s · 20MB
18MB installed
● package 18MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Route53Client
✓ from mypy_boto3_route53 import Route53Client
✗ from mypy_boto3_route53 import Route53Client
This quickstart demonstrates how to initialize a Route53 client with type hints and retrieve a list of hosted zones. It explicitly types the `boto3` client and the API response, allowing `mypy` to validate usage and provide autocompletion.
import boto3
from mypy_boto3_route53 import Route53Client
from mypy_boto3_route53.type_defs import ListHostedZonesResponseTypeDef
def get_hosted_zones() -> ListHostedZonesResponseTypeDef:
# boto3.client is untyped by default
client: Route53Client = boto3.client("route53")
response: ListHostedZonesResponseTypeDef = client.list_hosted_zones()
print(f"Found {len(response.get('HostedZones', []))} hosted zones.")
for zone in response.get('HostedZones', []):
print(f" - {zone.get('Name')} ({zone.get('Id')})")
return response
if __name__ == "__main__":
get_hosted_zones()
Debug
Known issues
breakingSupport for Python 3.8 has been removed across all `mypy-boto3-builder` generated packages. Projects still on Python 3.8 will encounter compatibility errors.fixUpgrade your Python environment to 3.9 or newer. If stuck on 3.8, pin to an older `mypy-boto3-route53` version (e.g., `<1.42.0`).
affects: mypy-boto3-builder >= 8.12.0 (and `mypy-boto3-route53` >= 1.42.0)
breakingTypeDef naming conventions were changed in `mypy-boto3-builder`, resulting in shorter or re-ordered names for some type definitions. This will break code that explicitly imports or references `TypeDef` objects by their old names.fixUpdate your `TypeDef` imports and references according to the new naming scheme (e.g., `CreateDistributionRequestRequestTypeDef` might become `CreateDistributionRequestTypeDef`). Consult the `mypy-boto3-builder` release notes or regenerate your type-hinted code to identify changes.
affects: mypy-boto3-builder >= 8.9.0
gotchaThese stubs are generated for specific `boto3` and `botocore` versions. Using a significantly different version of `boto3` can lead to discrepancies between the actual runtime behavior and the provided type hints, resulting in `mypy` errors or incorrect assumptions.fixEnsure your `boto3` and `mypy-boto3-route53` package versions are compatible. Ideally, `mypy-boto3-route53`'s minor version should match `boto3`'s minor version (e.g., `mypy-boto3-route53==1.42.x` for `boto3==1.42.x`).
affects: All versions
gotchaThe `mypy-boto3-builder` ecosystem transitioned to PEP 561 compliance in version 8.12.0. While largely transparent, this could affect type checker discovery in complex setups or when using custom `MYPYPATH` configurations.fixMost users will not need a fix. If encountering `mypy` stub discovery issues, verify your `mypy` configuration and ensure stub packages are correctly installed in your environment.
affects: mypy-boto3-builder >= 8.12.0 (and `mypy-boto3-route53` >= 1.42.0)
Upgrade
Version history
1.43.0latest on PyPI · released Apr 29, 2026
Audit
Dependencies
boto3requiredProvides the underlying AWS SDK for Python that these stubs type-hint. Ensure versions are compatible.