Types for aiobotocore ACM Service

Common errors

• ModuleNotFoundError: No module named 'aiobotocore.session'

  cause The `aiobotocore` library itself is not installed.
  fix Install the `aiobotocore` library: `pip install aiobotocore`.

• ModuleNotFoundError: No module named 'types_aiobotocore_acm.client'

  cause The `types-aiobotocore-acm` type stub package is not installed or incorrectly installed.
  fix Install `types-aiobotocore-acm`: `pip install types-aiobotocore-acm` or `pip install 'types-aiobotocore[acm]'`.

• error: Need type annotation for 'client' (hint: "client: Any = ...")

  cause MyPy or another type checker cannot infer the type of the `aiobotocore` client, usually because an explicit type hint (e.g., `client: ACMClient`) is missing or the type stubs are not correctly picked up.
  fix Add an explicit type annotation for your client variable: `client: ACMClient = await session.create_client("acm")`.

• error: Argument 'CertificateStatuses' to 'list_certificates' of 'ACMClient' has incompatible type 'List[str]'; expected 'List[CertificateStatusType]'  [arg-type]

  cause Using a string literal that is not a valid `CertificateStatusType` or a mistyped list of strings when the stub expects specific literal types.
  fix Ensure the values passed match the `types_aiobotocore_acm.literals.CertificateStatusType` or other specific TypedDict/Literal types. Import literals for clarity, e.g., `from types_aiobotocore_acm.literals import CertificateStatusType`.

Warnings

• breaking Support for Python 3.8 was officially removed with mypy-boto3-builder version 8.12.0. Users on Python 3.8 will need to upgrade their Python version to 3.9 or newer to use current versions of `types-aiobotocore-acm`.
  Fix: Upgrade your Python environment to version 3.9 or later. Alternatively, pin `types-aiobotocore-acm` to a version compatible with Python 3.8 if available for your specific aiobotocore version.
• breaking TypeDef names for packed method arguments were shortened (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`) and conflicting `Extra` postfixes were moved (e.g., `CreateDistributionExtraRequestTypeDef` -> `CreateDistributionRequestExtraTypeDef`). This affects type hint usage for request/response dictionaries.
  Fix: Update your type annotations in code to reflect the new, shorter TypeDef names and corrected `Extra` postfix placements. Refer to the `types-aiobotocore` documentation for the exact TypeDef names for your service and method.
• gotcha This package provides only type annotations (stubs) and does not include the actual `aiobotocore` library. You must install `aiobotocore` separately for the code to run, otherwise you will encounter `ModuleNotFoundError` for `aiobotocore` components.
  Fix: Ensure `aiobotocore` is installed in your environment: `pip install aiobotocore`.
• gotcha Since `mypy-boto3-builder` migrated to PEP 561 packages, type checkers typically auto-discover types. However, for explicit typing or complex environments (e.g., custom `MYPYPATH`), ensure your type checker is correctly configured to find stub packages. `types-aiobotocore-lite` users must always use explicit type annotations.
  Fix: For explicit typing, always annotate your client objects (e.g., `client: ACMClient`). If experiencing issues with `mypy`, verify your `mypy.ini` configuration and that the stub package is installed in an accessible location for your type checker.

Install

• pip install types-aiobotocore-acm Install specific service types
• pip install 'types-aiobotocore[acm]' Install with 'types-aiobotocore' extras

Imports

• ACMClient

  from types_aiobotocore_acm.client import ACMClient

  Required for explicit client type annotation.
• get_session

  from aiobotocore.session import get_session

  Standard import for creating aiobotocore sessions.

Quickstart

This quickstart demonstrates how to initialize an aiobotocore ACM client and use the `ACMClient` type annotation from `types-aiobotocore-acm` to enable static type checking and IDE auto-completion for client methods and their parameters. It lists issued certificates in a specified region.

import asyncio
from aiobotocore.session import get_session
from types_aiobotocore_acm.client import ACMClient

async def list_acm_certificates():
    session = get_session()
    async with session.create_client("acm", region_name="us-east-1") as client:
        client: ACMClient # Explicit type annotation for the client
        response = await client.list_certificates(CertificateStatuses=['ISSUED'])
        for cert in response.get('CertificateSummaryList', []):
            print(f"Certificate ARN: {cert['CertificateArn']}")

if __name__ == "__main__":
    asyncio.run(list_acm_certificates())