mypy-boto3-mediatailor: Type Annotations for AWS MediaTailor

Warnings

• breaking Support for Python 3.8 was removed in `mypy-boto3-builder` version 8.12.0, which generated this package version. Projects using `mypy-boto3-mediatailor` 1.42.84 or newer (generated by builder 8.12.0+) require Python 3.9 or higher.
  Fix: Upgrade your Python environment to 3.9 or newer.
• breaking Type definition names for packed method arguments may have changed for some services. For example, `CreateDistributionRequestRequestTypeDef` might become `CreateDistributionRequestTypeDef`. This could affect code directly referencing such types.
  Fix: Review your code for direct references to TypeDef names and update them according to the new naming conventions if type errors occur.
• gotcha This package provides *only* type annotations. You must have the `boto3` library installed separately (`pip install boto3`) for your code to run at runtime. This package does not declare `boto3` as a runtime dependency.
  Fix: Ensure `boto3` is included in your project's runtime dependencies (`pip install boto3`).
• gotcha The `mypy-boto3` stub packages are tightly coupled with `boto3` versions. For optimal type checking, ensure your `mypy-boto3-mediatailor` version aligns with your installed `boto3` version (e.g., `mypy-boto3-mediatailor==X.Y.Z` for `boto3==X.Y.Z`).
  Fix: Match `mypy-boto3-mediatailor`'s version to your `boto3` version. Consider using `boto3-stubs` which helps manage versions for all services.
• gotcha Avoid installing individual `mypy-boto3-*` service packages (like `mypy-boto3-mediatailor`) if you have already installed the comprehensive `boto3-stubs` package, which includes all service stubs. Installing both can lead to redundancy or potential conflicts.
  Fix: Choose one approach: either install `boto3-stubs` (recommended for projects using multiple services) or install individual `mypy-boto3-*` packages for only the services you need. Do not mix them for the same services.

Install

• pip install mypy-boto3-mediatailor Install service-specific stubs
• pip install boto3-stubs[mediatailor] Install using boto3-stubs (recommended for multiple services)

Imports

• MediaTailorClient

  from mypy_boto3_mediatailor.client import MediaTailorClient

  Imports the type hint for the MediaTailor client object.
• ListChannelsResponseTypeDef

  from mypy_boto3_mediatailor.type_defs import ListChannelsResponseTypeDef

  Imports type definition for specific API call responses.
• ChannelTypeDef

  from mypy_boto3_mediatailor.type_defs import ChannelTypeDef

  Imports type definition for a specific resource, e.g., a MediaTailor channel.

Quickstart

This quickstart demonstrates how to initialize a type-hinted MediaTailor client and perform a basic API call (list_channels). It highlights how to apply type annotations to the client object and API responses, leveraging the benefits of static type checking with `mypy` or similar tools.

import boto3
from mypy_boto3_mediatailor.client import MediaTailorClient
from mypy_boto3_mediatailor.type_defs import ListChannelsResponseTypeDef

# Create a typed client for AWS MediaTailor
client: MediaTailorClient = boto3.client("mediatailor")

# Example: List channels with type hints
try:
    response: ListChannelsResponseTypeDef = client.list_channels()
    channels = response.get('Items', [])
    print(f"Found {len(channels)} MediaTailor Channels:")
    for channel in channels:
        print(f"- {channel.get('ChannelName', 'N/A')} (ARN: {channel.get('ChannelArn', 'N/A')})")
except Exception as e:
    print(f"Error listing channels: {e}")
    print("Ensure AWS credentials and 'mediatailor' service are configured correctly.")