Install & Compatibility
Where this runs
tested against v1.43.55 · 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.661s · 53.6MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 5.5s · import 0.598s · 54MB
52MB installed
● package 52MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AppStreamClient
✓ from mypy_boto3_appstream import AppStreamClient
AccessEndpointTypeDef
✓ from mypy_boto3_appstream.type_defs import AccessEndpointTypeDef
AccessEndpointTypeType
✓ from mypy_boto3_appstream.literals import AccessEndpointTypeType
FleetStartedWaiter
✓ from mypy_boto3_appstream.waiter import FleetStartedWaiter
This example demonstrates how to initialize an AppStream client with type annotations and use a type-hinted `TypeDef` for the response. It queries existing AppStream fleets.
import boto3
from mypy_boto3_appstream import AppStreamClient
from mypy_boto3_appstream.type_defs import DescribeFleetsResultTypeDef
def get_appstream_fleets() -> DescribeFleetsResultTypeDef:
client: AppStreamClient = boto3.client('appstream')
response = client.describe_fleets()
print(f"Found {len(response['Fleets'])} AppStream fleets.")
return response
if __name__ == '__main__':
# This quickstart assumes AWS credentials are configured (e.g., via AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION_NAME env vars)
# or ~/.aws/credentials and ~/.aws/config files.
# Replace with actual usage or mock for testing if needed.
# Example of using environment variables for auth (for demonstration, actual auth depends on boto3 setup):
# import os
# if not os.environ.get('AWS_ACCESS_KEY_ID'):
# os.environ['AWS_ACCESS_KEY_ID'] = 'AKIA...'
# if not os.environ.get('AWS_SECRET_ACCESS_KEY'):
# os.environ['AWS_SECRET_ACCESS_KEY'] = 'secret...'
# if not os.environ.get('AWS_REGION_NAME'):
# os.environ['AWS_REGION_NAME'] = 'us-east-1'
try:
fleets_data = get_appstream_fleets()
# Further processing with type-hinted data, e.g., fleets_data['Fleets'][0]['DisplayName']
except Exception as e:
print(f"Error fetching AppStream fleets: {e}")
Debug
Known issues
breakingSupport for Python 3.8 was removed from `mypy-boto3-builder` (which generates these stubs). Using `mypy-boto3-appstream` with Python 3.8 will no longer receive updates or guaranteed compatibility.fixUpgrade your Python environment to 3.9 or newer. The `requires_python` metadata is `^3.9`.
affects: mypy-boto3-builder >= 8.12.0
breakingType definition (TypeDef) names for packed method arguments may have changed for some services, using shorter names (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`). While not specific to `AppStream` in the reported changes, this indicates a pattern for future breaking changes across services.fixReview your code for explicit `TypeDef` imports and adjust names according to the latest documentation or builder output.
affects: mypy-boto3-builder >= 8.9.0
gotchaFor Pylint compatibility, if you use `mypy-boto3` stubs with `pylint`, you might encounter false positives (e.g., undefined variables). It is recommended to wrap stub imports or type assignments in a `TYPE_CHECKING` block to avoid these errors in runtime code.fixUse `from typing import TYPE_CHECKING; if TYPE_CHECKING: from mypy_boto3_appstream import AppStreamClient else: AppStreamClient = object` or similar patterns.
affects: All versions
gotchaWhile PyCharm and Mypy often automatically discover types for `boto3.client()` calls, VSCode users might need to explicitly annotate the client variable for full auto-completion and type inference support.fixExplicitly add type hints to your client objects, e.g., `client: AppStreamClient = boto3.client('appstream')`. affects: All versions
Upgrade
Version history
1.43.55latest on PyPI · released Jul 23, 2026
Audit
Dependencies
boto3requiredProvides the AWS SDK for Python that these stubs type-hint.
pythonrequiredRequires Python 3.9 or higher. Support for Python 3.8 was removed in mypy-boto3-builder v8.12.0.
mypyoptionalThe primary static type checker these stubs are designed for.