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.95 runs
installs and imports cleanly · install 0.0s · import 0.588s · 116.5MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 5.9s · import 0.554s · 114MB
114MB installed
● package 114MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
MediaStoreClient
✓ from mypy_boto3_mediastore import MediaStoreClient
ContainerTypeDef
✓ from mypy_boto3_mediastore.type_defs import ContainerTypeDef
ListContainersPaginator
✓ from mypy_boto3_mediastore.paginator import ListContainersPaginator
ContainerLevelMetricsType
✓ from mypy_boto3_mediastore.literals import ContainerLevelMetricsType
This quickstart demonstrates how to use `mypy-boto3-mediastore` for type-hinting a boto3 MediaStore client. It shows explicit type annotation for the client and the return type of a method call. To verify type checking, ensure `mypy` is installed and run `mypy` on the script.
import os
import boto3
from mypy_boto3_mediastore import MediaStoreClient
from mypy_boto3_mediastore.type_defs import ContainerTypeDef
def list_mediastore_containers(client: MediaStoreClient) -> list[ContainerTypeDef]:
"""Lists MediaStore containers and returns typed responses."""
response = client.list_containers()
containers = response.get('Containers', [])
print(f"Found {len(containers)} MediaStore containers.")
for container in containers:
print(f" Container Name: {container.get('Name')}, Status: {container.get('Status')}")
return containers
if __name__ == "__main__":
# Ensure AWS credentials are configured (e.g., via environment variables or ~/.aws/credentials)
session = boto3.Session(region_name=os.environ.get('AWS_REGION', 'us-east-1'))
mediastore_client: MediaStoreClient = session.client('mediastore')
print("Listing MediaStore containers...")
containers = list_mediastore_containers(mediastore_client)
# Example of accessing a typed attribute (mypy would check this)
if containers:
first_container_arn: str = containers[0]['ARN']
print(f"First container ARN: {first_container_arn}")
# To run static analysis:
# pip install mypy
# mypy your_script_name.py
Debug
Known issues
breakingSupport for Python 3.8 has been removed in `mypy-boto3-builder` version 8.12.0 and later, affecting packages built with it, including `mypy-boto3-mediastore`. Ensure your project uses Python 3.9 or higher.fixUpgrade your Python environment to 3.9 or newer. Consider using `pyenv` or similar tools for managing Python versions.
affects: mypy-boto3-builder >=8.12.0, mypy-boto3-mediastore >=1.42.0
breakingTypeDef naming conventions were changed in `mypy-boto3-builder` version 8.9.0. This might affect direct imports of specific `TypeDef` classes (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`).fixReview and update any direct `import` statements for `TypeDef` classes to match the new, often shorter, naming conventions.
affects: mypy-boto3-builder >=8.9.0, mypy-boto3-mediastore versions built with it
gotchaThis package provides *only* type stubs. You must install the actual `boto3` library to use AWS services at runtime. `mypy-boto3-mediastore` will be automatically detected by `mypy` (PEP 561 compliant) if both are installed in the same environment.fixAlways include `boto3` in your project's dependencies alongside `mypy-boto3-mediastore` (e.g., `pip install boto3 mypy-boto3-mediastore`).
affects: All versions
gotchaWhile `mypy` often automatically infers types, explicit type annotations for `boto3.client` and similar calls (e.g., `client: MediaStoreClient = session.client('mediastore')`) are highly recommended for better IDE auto-completion and more robust type checking, especially with versions like `boto3-stubs-lite` which do not provide `session.client/resource` overloads.fixAdd explicit type annotations when initializing boto3 clients or resources, such as `client: MediaStoreClient = session.client('mediastore')`. affects: All versions
Upgrade
Version history
1.43.0latest on PyPI · released Apr 29, 2026
Audit
Dependencies
boto3requiredThis package provides type stubs for boto3; boto3 itself must be installed and used at runtime.
mypyoptionalRequired for static type checking using these stubs.