mypy-boto3-xray

What it is and what it does

mypy-boto3-xray is a stub package that adds type annotations for the boto3 XRay service. It is generated from boto3 1.43.0 using mypy-boto3-builder 8.12.0 and works with type checkers (mypy, pyright) and IDEs (VSCode, PyCharm, Emacs, Sublime Text) to provide type checking and code completion for XRay API calls.

The package is designed as a development-time dependency—you install it in your environment to get IDE support and type checking, but it does not affect runtime behavior. It provides explicit type annotations for the XRayClient, paginators, and type definitions, allowing you to catch API misuse before runtime. The package supports Python 3.9 through 3.14 and has no production dependencies beyond typing-extensions.

Use it for:

• Enable IDE autocompletion and type hints when writing boto3 XRay API calls in VSCode or PyCharm.
• Catch XRay API usage errors during static type checking with mypy or pyright before deployment.
• Provide explicit type annotations for XRayClient, paginators, and service resources in larger codebases.
• Support distributed tracing workflows by ensuring correct parameter types and return values for XRay operations.

Worth the install?

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

Provides type annotations for boto3's XRay service, enabling type checking and IDE autocompletion for XRay API calls in mypy, pyright, VSCode, PyCharm, and other tools.

Yes, if you use boto3's XRay service and want type safety and IDE support. Install friction is minimal, maintenance is active, and there are no security issues. The MIT license poses no restrictions. Consider boto3-stubs-lite as an alternative if PyCharm performance is a concern.

Install

mypy-boto3-xray on PyPI

pip install mypy-boto3-xray

uv add mypy-boto3-xray

poetry add mypy-boto3-xray

Installing mypy-boto3-xray

Before you install

Low install friction with a single lightweight runtime dependency (typing-extensions). 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 mypy-boto3-xray

from boto3.session import Session
from mypy_boto3_xray import XRayClient

client: XRayClient = Session().client("xray")
# Type checking and IDE completion now work on client calls

Requires Python 3.9 or later; boto3 must be installed separately to use the annotations at runtime.

Verify before relying

• Whether PyCharm performance issues with Literal overloads (mentioned in docs) still affect current versions.
• Whether the lite variant (boto3-stubs-lite) offers meaningful performance benefits for typical XRay workloads.

Package facts

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

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

Tags

More Software Development packages