Install & Compatibility
Where this runs
tested against v1.43.74 · 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 · 18.5MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
OutpostsClient
✓ from mypy_boto3_outposts import OutpostsClient
✗ from mypy_boto3_outposts import OutpostsClient
This quickstart demonstrates how to obtain a type-hinted `OutpostsClient` from `boto3` and use it to interact with the AWS Outposts service. The type annotations provided by `mypy-boto3-outposts` enable robust static analysis and IDE auto-completion for client methods and response structures.
import boto3
from mypy_boto3_outposts.client import OutpostsClient
def get_outposts_client() -> OutpostsClient:
"""Returns a type-hinted Outposts client."""
client: OutpostsClient = boto3.client("outposts")
return client
if __name__ == "__main__":
outposts_client = get_outposts_client()
try:
# Example: List outposts
response = outposts_client.list_outposts()
print(f"Found {len(response.get('Outposts', []))} Outposts.")
if response.get('Outposts'):
print(f"First Outpost ARN: {response['Outposts'][0]['OutpostArn']}")
except Exception as e:
print(f"An error occurred: {e}")
Debug
Known issues
breakingPython 3.8 support was removed in `mypy-boto3-builder` version 8.12.0. Users on Python 3.8 or older must upgrade their Python version to >=3.9 or use an older version of `mypy-boto3-outposts` and its builder.fixUpgrade Python to 3.9 or higher. Alternatively, pin `mypy-boto3-builder` to a version older than 8.12.0 if using Python 3.8.
affects: mypy-boto3-builder >=8.12.0, mypy-boto3-outposts (built with >=8.12.0)
breakingBreaking changes to `TypeDef` names occurred in `mypy-boto3-builder` version 8.9.0. Packed method arguments now use shorter names (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`), and conflicting `Extra` postfixes were moved (e.g., `CreateDistributionExtraRequestTypeDef` to `CreateDistributionRequestExtraTypeDef`).fixUpdate your code to use the new `TypeDef` naming conventions as reflected in the generated stubs.
affects: mypy-boto3-builder >=8.9.0, mypy-boto3-outposts (built with >=8.9.0)
gotchaThe `mypy-boto3` ecosystem migrated to PEP 561 compliant stub-only packages starting with `mypy-boto3-builder` 8.12.0. This means `mypy` will typically auto-discover types if the packages are installed, but users should be aware that `MYPYPATH` is not used for stub-only packages and direct installation is necessary for type checkers to find them.fixEnsure `mypy-boto3-outposts` is installed in the same Python environment used by your type checker. No special `MYPYPATH` configuration is needed or supported for stub-only packages.
affects: mypy-boto3-builder >=8.12.0, all generated `mypy-boto3-*` packages
deprecatedA pattern of service renaming/deprecation exists within the `mypy-boto3` ecosystem. For example, the `sms-voice` service was deprecated in favor of `pinpoint-sms-voice` in builder 8.11.0. While specific to `sms-voice`, this indicates that users should periodically check release notes for service-specific stub deprecations or renames.fixConsult the changelog for the specific `mypy-boto3-*` package or the `mypy-boto3-builder` repository for any service renames or deprecations relevant to your project.
affects: mypy-boto3-builder >=8.11.0 (for other services)
gotchaThe legacy `mypy-boto3` package was moved to a separate product starting in `mypy-boto3-builder` 8.9.0 and is no longer generated alongside `boto3-stubs`. Users upgrading from older `mypy-boto3` installations might need to adjust their package names or rebuild their stubs.fixEnsure you are installing `boto3-stubs` or specific `mypy-boto3-` service packages, rather than relying on the older `mypy-boto3` package for new projects or after upgrading the builder.
affects: mypy-boto3-builder >=8.9.0
Upgrade
Version history
1.43.74latest on PyPI · released Aug 18, 2026
Audit
Dependencies
boto3requiredProvides the AWS SDK for Python, which these stubs type-check.
typing-extensionsoptionalMay be required for advanced type-hinting features on older Python versions (prior to 3.9), though less critical for modern Python versions supported by this library.