Type Annotations for aiobotocore Secrets Manager

Warnings

• breaking Python 3.8 support has been dropped starting with `mypy-boto3-builder` version 8.12.0. This means `types-aiobotocore-secretsmanager` versions built with 8.12.0 or later (including 3.4.0) require Python 3.9 or higher.
  Fix: Ensure your project uses Python 3.9 or newer. If you must use Python 3.8, pin to an older `types-aiobotocore-secretsmanager` version (e.g., `<3.4.0`) that was built with `mypy-boto3-builder` <8.12.0.
• gotcha It is crucial to align the version of `types-aiobotocore-secretsmanager` with the version of `aiobotocore` (and potentially `types-aiobotocore`) you are using at runtime. Mismatched versions can lead to incorrect types or missing attributes/methods, causing static analysis errors or runtime issues that type checking might miss.
  Fix: Always install `types-aiobotocore-secretsmanager` with a version constraint that matches your `aiobotocore` installation, or allow `pip` to resolve compatible versions. For example, if you have `aiobotocore==2.13.0`, you should ideally install `types-aiobotocore-secretsmanager==2.13.0` (or `~=2.13.0`). The `types-aiobotocore-secretsmanager` package has `aiobotocore` as a runtime dependency, so pip *should* find a compatible version.
• breaking The `mypy-boto3-builder` (which generates this package) introduced breaking changes in `8.9.0` regarding TypeDef naming conventions, such as `CreateDistributionRequestRequestTypeDef` becoming `CreateDistributionRequestTypeDef`. While this specific example is not for Secrets Manager, similar changes may occur in future versions for other service TypeDefs, if names become too long or conflicting.
  Fix: If you are directly importing and using specific `TypeDef` classes and upgrading to a new major version of `types-aiobotocore-secretsmanager`, review the release notes of `mypy-boto3-builder` for potential naming changes to `TypeDef` structures. Update your imports accordingly.
• gotcha This package is a type stub package (`py.typed`) and provides only type annotations. It does not include the actual runtime implementation of the `aiobotocore` Secrets Manager client. You must install `aiobotocore` separately for the code to run.
  Fix: Ensure `aiobotocore` is installed in your environment: `pip install aiobotocore`.

Install

• pip install types-aiobotocore-secretsmanager Install service-specific type stubs

Imports

• SecretsManagerClient

  from types_aiobotocore_secretsmanager.client import SecretsManagerClient

  Import the client type for static analysis.
• AioSession

  import aiobotocore.session

  The canonical way to get the session object is via 'aiobotocore.session.get_session()' or importing 'aiobotocore.session' directly.

Quickstart

This quickstart demonstrates how to obtain a typed `SecretsManagerClient` using `aiobotocore.session` and perform a basic asynchronous operation like listing secrets. The `TYPE_CHECKING` block ensures type imports do not add runtime dependencies.

from typing import TYPE_CHECKING
import asyncio
import aiobotocore.session

# These types are only needed for type checking, not at runtime
if TYPE_CHECKING:
    from types_aiobotocore_secretsmanager.client import SecretsManagerClient

async def get_secrets_manager_client():
    session = aiobotocore.session.get_session()
    # Annotate the client with the imported type for full type-checking benefits
    client: SecretsManagerClient
    async with session.client("secretsmanager") as client:
        try:
            response = await client.list_secrets()
            print(f"Secrets: {[s['Name'] for s in response.get('SecretList', [])]}")
        except Exception as e:
            print(f"Error listing secrets: {e}")

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