types-boto3-ecr

What it is and what it does

types-boto3-ecr is a type stub package that adds static type information for boto3's ECR (Elastic Container Registry) service. It is generated from boto3 1.43.0 and works with mypy, pyright, VSCode Pylance, PyCharm, and other type-aware tools. When installed, it enables IDE autocompletion and type checking for ECR client operations, paginators, and waiters without requiring explicit type annotations in your code.

The package is a thin layer of type definitions only—it has no runtime behavior and does not replace boto3 itself. It is designed to be installed alongside boto3 in development environments or behind a TYPE_CHECKING guard in production code to avoid a runtime dependency. It supports Python 3.9 through 3.14 and is maintained as part of the mypy-boto3-builder project.

Use it for:

• Enable IDE autocompletion and type hints when writing boto3 ECR code in VSCode, PyCharm, or Emacs.
• Catch type errors in ECR client calls before runtime using mypy or pyright in CI/CD pipelines.
• Annotate ECR client, paginator, and waiter types explicitly in codebases that require strict type safety.
• Provide type information for ECR operations (e.g., describe_repositories, put_image) without manual annotation.
• Use in development environments only via TYPE_CHECKING to avoid adding a production dependency.

Worth the install?

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

Provides type stubs and annotations for boto3 ECR 1.43.0, enabling type checking and IDE autocompletion when working with AWS Elastic Container Registry through boto3.

Yes, if you use boto3 with ECR and want type checking or IDE autocompletion. Install friction is negligible, maintenance is active, and the MIT license poses no restrictions. The only gotcha is PyCharm's known performance issue with Literal overloads (documented in the package), which may warrant using types-boto3-lite instead. No security vulnerabilities.

Install

types-boto3-ecr on PyPI

pip install types-boto3-ecr

uv add types-boto3-ecr

poetry add types-boto3-ecr

Installing types-boto3-ecr

Before you install

Low install friction with a single lightweight runtime dependency (typing-extensions). Package is actively maintained with recent releases and no known vulnerabilities.

License in practice

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

Quickstart

pip install types-boto3-ecr

from boto3.session import Session
from types_boto3_ecr import ECRClient

client: ECRClient = Session().client("ecr")
# Type checking and IDE autocompletion now work

Requires Python 3.9 or later; boto3 must be installed separately in your environment.

Verify before relying

• Whether PyCharm performance issues mentioned in docs (PY-40997) remain relevant to current versions.
• Whether types-boto3-lite is recommended as a default over the full package for most users.

Package facts

Evidence: types_boto3_ecr-1.43.0-py3-none-any.whl

Keywords: boto3, ecr, boto3-stubs, type-annotations, mypy, typeshed, autocomplete

Tags

More Software Development packages