Install & Compatibility
Where this runs
tested against v1.43.63 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.2MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.6s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
EKSAuthClient
✓ from mypy_boto3_eks_auth import EKSAuthClient
✗ from mypy_boto3_eks_auth import EKSAuthClient
Demonstrates how to type-hint a `boto3` EKSAuth client using `mypy-boto3-eks-auth` for static analysis. It shows importing the client type and a response type, and type-hinting a client and its method call. Note that runtime execution of `get_token` requires valid AWS credentials and an existing EKS cluster.
import boto3
from mypy_boto3_eks_auth.client import EKSAuthClient
from mypy_boto3_eks_auth.type_defs import GetTokenResponseTypeDef
import os
# Type-hint the boto3 client directly for static analysis
eks_auth_client: EKSAuthClient = boto3.client(
"eks-auth",
aws_access_key_id=os.environ.get('AWS_ACCESS_KEY_ID', 'DUMMY_KEY'),
aws_secret_access_key=os.environ.get('AWS_SECRET_ACCESS_KEY', 'DUMMY_SECRET'),
region_name=os.environ.get('AWS_REGION', 'us-west-2') # EKS is region-specific
)
print(f"Client object type: {type(eks_auth_client)}")
# Demonstrating a method call that mypy would type-check.
# This call requires a valid EKS cluster name and proper AWS credentials to succeed at runtime.
# For quickstart, we wrap it in a try-except as it might fail without real setup.
cluster_name = os.environ.get('EKS_CLUSTER_NAME', 'your-eks-cluster-name')
try:
# This will likely result in an authentication/authorization error without real AWS credentials
# and a valid EKS cluster configured.
response: GetTokenResponseTypeDef = eks_auth_client.get_token(clusterName=cluster_name)
print(f"Successfully called get_token (type checked):")
print(f" Token expiry: {response.get('expiration', 'N/A')}")
except Exception as e:
print(f"Error calling get_token (expected without real setup or valid cluster): {e}")
# To verify type checking, you would run `mypy your_script_name.py`
Debug
Known issues
breakingPython 3.8 support has been removed since `mypy-boto3-builder` version 8.12.0. Users must use Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or later.
affects: >=8.12.0 (builder), >=1.42.3 (service package)
breakingPackages migrated to PEP 561 standard with `mypy-boto3-builder` version 8.12.0. This might affect how static analysis tools (like mypy) discover and utilize the stub files, especially in complex project setups.fixEnsure your `mypy` configuration is up-to-date and correctly pointing to `site-packages` for stub discovery. In most cases, `mypy` should handle this automatically.
affects: >=8.12.0 (builder), >=1.42.3 (service package)
breakingTypeDef names were changed for clarity and to resolve conflicts in `mypy-boto3-builder` version 8.9.0. If you explicitly imported TypeDefs, their names might have changed (e.g., `CreateDistributionRequestRequestTypeDef` to `CreateDistributionRequestTypeDef`, or `Extra` postfix moved).fixReview your code for direct `from mypy_boto3_service.type_defs import ...` imports and update TypeDef names according to the latest package structure.
affects: >=8.9.0 (builder)
gotchaThis package provides *type stubs* for `boto3`. You must also install `boto3` itself for your code to run at runtime.fixEnsure `boto3` is installed in your environment: `pip install boto3`.
affects: all
gotchaThese type annotations are only effective when used with a static type checker like `mypy`. Without running `mypy`, you will not get the benefits of type checking.fixInstall `mypy` (`pip install mypy`) and integrate it into your development workflow (e.g., `mypy your_script.py`).
affects: all
Upgrade
Version history
1.43.63latest on PyPI · released Aug 3, 2026
Audit
Dependencies
boto3requiredProvides the actual runtime client for AWS services, without which these type stubs have no runtime functionality.
mypyrequiredRequired to perform static type checking and leverage the type annotations provided by this library.
typing-extensionsrequiredRuntime dependency for advanced type features, automatically installed.