Type Annotations for boto3 EMR Containers

1.42.3 · active · verified Sat Apr 11

mypy-boto3-emr-containers provides static type annotations (stubs) for the boto3 EMR Containers service, enhancing development with type-checking capabilities. It ensures type safety when using boto3 clients, resources, and collections for EMR Containers, preventing common runtime errors. The library is automatically generated by mypy-boto3-builder and typically releases new versions in sync with boto3 and botocore updates.

Warnings

breaking Python 3.8 support was removed for all mypy-boto3 packages, including mypy-boto3-emr-containers, starting with mypy-boto3-builder v8.12.0.
Fix: Upgrade your Python environment to 3.9 or higher. If you must use Python 3.8, pin your mypy-boto3-emr-containers version to an earlier release (e.g., <1.42.0).
gotcha This package provides *type stubs* for boto3, not boto3 itself. You must install `boto3` separately for your code to run.
Fix: Always install `boto3` alongside `mypy-boto3-emr-containers` (e.g., `pip install boto3 mypy-boto3-emr-containers`).
breaking TypeDef naming conventions changed significantly with mypy-boto3-builder v8.9.0. Some TypeDefs for packed method arguments or conflicting names received shorter or reordered postfixes (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`).
Fix: Update your type annotation imports and usage to reflect the new TypeDef names. Consult the generated stub files or the `mypy-boto3-builder` release notes for specific changes.

Install

pip install mypy-boto3-emr-containers boto3 Install with boto3
pip install mypy-boto3-emr-containers Install stubs only (boto3 separate)

Imports

EMRContainersClient
```
from mypy_boto3_emr_containers import EMRContainersClient
```
The client type is provided by the stub package, not directly from boto3.
ListVirtualClustersOutputTypeDef
```
from mypy_boto3_emr_containers.type_defs import ListVirtualClustersOutputTypeDef
```
Type definitions (TypedDicts) are located in the `type_defs` submodule.

Quickstart

This quickstart demonstrates how to instantiate a type-hinted EMR Containers client and use it to list virtual clusters. The `EMRContainersClient` type ensures that method calls and return values are correctly type-checked by tools like mypy, catching potential issues at development time rather than runtime. Remember to have `boto3` installed alongside the stubs.

import boto3
from mypy_boto3_emr_containers import EMRContainersClient
from mypy_boto3_emr_containers.type_defs import ListVirtualClustersOutputTypeDef

def get_emr_containers_client() -> EMRContainersClient:
    """Returns a type-hinted EMR Containers client."""
    # Ensure boto3 is installed: pip install boto3 mypy-boto3-emr-containers
    client: EMRContainersClient = boto3.client("emr-containers")
    return client

def list_virtual_clusters() -> None:
    """Lists EMR Containers virtual clusters with type checking."""
    client = get_emr_containers_client()
    try:
        response: ListVirtualClustersOutputTypeDef = client.list_virtual_clusters()
        print("Successfully listed virtual clusters:")
        for cluster in response.get("virtualClusters", []):
            name = cluster.get("name", "N/A")
            cluster_id = cluster.get("id", "N/A")
            status = cluster.get("status", {}).get("state", "UNKNOWN")
            print(f"  - Name: {name}, ID: {cluster_id}, Status: {status}")
        if not response.get("virtualClusters"):
            print("  No virtual clusters found.")
    except Exception as e:
        print(f"Error listing virtual clusters: {e}")

if __name__ == "__main__":
    list_virtual_clusters()

view raw JSON →