boto3-type-annotations

What it is and what it does

boto3_type_annotations is a code-generation package that creates type-annotated Python classes mirroring boto3's runtime-generated AWS service interfaces. Because boto3 constructs its clients, resources, paginators, and waiters dynamically at runtime using string identifiers, IDEs cannot provide code completion or type inference without explicit type declarations. This package solves that by parsing boto3's docstrings to extract method signatures and return types, then generating stand-in classes that can be used for type annotations in your own code.

You install it alongside boto3 and import its service-specific modules (e.g., `boto3_type_annotations.s3`) to declare the types of boto3 objects in your code. The package is available in two forms: a lean 2.2 MB version without docstrings, and a 41 MB version with full documentation for development use. However, the project has been abandoned since May 2019 and receives no updates, so it will not cover AWS services or API changes introduced after that date.

Use it for:

• Enable IDE autocomplete and type checking when working with boto3 S3, EC2, or other AWS services in development.
• Add type hints to function signatures that accept boto3 clients or resources without runtime overhead.
• Reduce IDE lag and improve developer experience in large codebases that make heavy use of boto3.
• Support static type checkers like mypy or pyright in validating boto3 API calls before runtime.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type-annotated stand-in classes for boto3 services, enabling IDE code completion and type inference for AWS API clients, resources, paginators, and waiters.

No, unless you are locked to a pre-2019 boto3 version. The project is abandoned and will not track new AWS services or API changes. Modern alternatives like boto3-stubs (via typeshed or boto3-stubs packages) are actively maintained and provide current type coverage. If you are already using an old boto3 version and cannot upgrade, this package may provide value, but it is not a safe choice for new projects.

Install

boto3-type-annotations on PyPI

pip install boto3-type-annotations

uv add boto3-type-annotations

poetry add boto3-type-annotations

Installing boto3-type-annotations

Before you install

Installation is frictionless (pure Python wheel, no runtime dependencies), but the project is abandoned as of 2019. The package has not been updated in over six years, which means it will not track new AWS services or API changes introduced since its last release.

License in practice

MIT License permits unrestricted use, modification, and distribution with minimal restrictions, making it safe to adopt from a licensing standpoint.

Quickstart

pip install boto3_type_annotations

import boto3
from boto3_type_annotations.s3 import Client

client: Client = boto3.client('s3')
client.create_bucket(Bucket='my-bucket')

The package is abandoned and will not include type annotations for AWS services added or modified after May 2019; newer boto3 versions may have incompatible APIs.

Verify before relying

• Compatibility with current boto3 and botocore versions—the package has not been updated since 2019.
• Whether type annotations remain accurate for services that existed in 2019 but have since evolved.
• Support for modern Python versions beyond what was current in 2019.

Package facts

Evidence: boto3_type_annotations-0.3.1-py3-none-any.whl

Tags

More Software Development packages