types-aiobotocore-s3

What it is and what it does

This package is a type stub library generated by mypy-boto3-builder 8.12.0 that adds complete type annotations for the aiobotocore S3 service. It enables static type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to provide accurate code completion, inline documentation, and type error detection when working with async AWS S3 operations through aiobotocore.

The stubs cover the full S3 API surface including clients, paginators, waiters, service resources, and type definitions. Installation is straightforward—a single pip command adds the types to your environment, and they work automatically with any IDE or type checker that supports stub packages. The package has no runtime behavior; it only provides metadata for development-time tooling.

Use it for:

• Enable IDE autocompletion and inline type hints when writing async S3 code with aiobotocore in VSCode or PyCharm.
• Run mypy or pyright type checking on aiobotocore S3 code to catch type errors before runtime.
• Document S3 API method signatures and parameter types in your codebase without writing manual annotations.
• Reduce bugs in async S3 operations by catching incorrect method calls or argument types at development time.
• Generate paginator and waiter type hints for complex S3 operations like listing large buckets or waiting for uploads.

Worth the install?

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

Provides type stubs and IDE autocompletion support for aiobotocore S3 3.9.0, enabling static type checking with mypy, pyright, and other tools.

Yes, if you use aiobotocore for S3 operations. The package is actively maintained, has no security vulnerabilities, carries a permissive MIT license, and adds zero runtime overhead. Install friction is minimal (one dependency). The only caveat is PyCharm users may experience performance issues with the full type stubs on large projects; the docs recommend the lite variant in that case.

Install

types-aiobotocore-s3 on PyPI

pip install types-aiobotocore-s3

uv add types-aiobotocore-s3

poetry add types-aiobotocore-s3

Installing types-aiobotocore-s3

Before you install

Low install friction with a single lightweight dependency (typing-extensions). Active maintenance with a recent release 12 days ago; repository shows 670 stars and steady commits.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

# Install
python -m pip install types-aiobotocore-s3

# Use in code
from aiobotocore.session import get_session
from types_aiobotocore_s3 import S3Client

session = get_session()
async with session.create_client("s3") as client:
    client: S3Client
    # Type checking and IDE completion now work

Requires aiobotocore 3.9.0 to be installed separately; Python 3.9 or later.

Verify before relying

• Performance impact on PyCharm noted in docs (issue PY-40997) but severity/current status unclear.
• Whether types-aiobotocore-lite variant is recommended for production deployments over full version.

Package facts

Evidence: types_aiobotocore_s3-3.9.0-py3-none-any.whl

Keywords: aiobotocore, s3, aiobotocore-stubs, type-annotations, mypy, typeshed, autocomplete

Tags

More Software Development packages