Registry /
type-stubs / mypy-boto3-connecthealth
Install & Compatibility
Where this runs
tested against v1.43.27 · 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.940 runs
installs and imports cleanly · install 0.0s · import 0.595s · 53MB
glibcpy 3.10–3.940 runs
installs and imports cleanly · install 5.4s · import 0.553s · 54MB
52MB installed
● package 52MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ConnectHealthClient
✓ from mypy_boto3_connecthealth.client import ConnectHealthClient
DescribeEventsPaginator
✓ from mypy_boto3_connecthealth.paginator import DescribeEventsPaginator
EventTypeDef
✓ from mypy_boto3_connecthealth.type_defs import EventTypeDef
This quickstart demonstrates how to initialize a `boto3` ConnectHealth client with type annotations and fetch events. It includes explicit type hints for `ConnectHealthClient` and `EventTypeDef` to leverage static analysis. Ensure `boto3` is installed alongside `mypy-boto3-connecthealth`.
from typing import TYPE_CHECKING
import boto3
import os
if TYPE_CHECKING:
from mypy_boto3_connecthealth.client import ConnectHealthClient
from mypy_boto3_connecthealth.type_defs import EventTypeDef
def get_connect_health_events(region_name: str) -> list["EventTypeDef"]:
# boto3 client creation without explicit type hint will still work
# but explicit type hints provide better IDE support and type checking
client: ConnectHealthClient = boto3.client(
"connect-health",
region_name=region_name,
aws_access_key_id=os.environ.get('AWS_ACCESS_KEY_ID', ''),
aws_secret_access_key=os.environ.get('AWS_SECRET_ACCESS_KEY', ''),
aws_session_token=os.environ.get('AWS_SESSION_TOKEN', '')
)
# Example: Describe events (Connect Health operations might require specific permissions)
try:
response = client.describe_events(
Filter={
'EventType': {'Values': ['AWS_HEALTH_EVENT']}
}
)
return response['Events']
except client.exceptions.InvalidRequestException as e:
print(f"Error describing events: {e}")
return []
if __name__ == "__main__":
events = get_connect_health_events("us-east-1")
print(f"Found {len(events)} Connect Health events.")
for event in events:
print(f" - Event ARN: {event['eventArn']}")
Debug
Known issues
breakingSupport for Python 3.8 was removed in `mypy-boto3-builder` version 8.12.0 (November 2025). This affects all generated `mypy-boto3` stub packages, including `mypy-boto3-connecthealth` versions 1.42.x and newer. Projects using Python 3.8 or older will encounter compatibility issues.fixUpgrade your Python environment to version 3.9 or newer.
affects: mypy-boto3-builder >= 8.12.0, mypy-boto3-connecthealth >= 1.42.x
breakingType definition (TypeDef) naming conventions changed in `mypy-boto3-builder` version 8.9.0 (November 2025). Type definition names for method arguments and conflicting types may have been shortened or rearranged (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`). This could break existing explicit type annotations in your codebase that referenced the old names.fixReview your codebase for explicit `TypeDef` annotations and update them to reflect the new naming conventions, consulting the `mypy_boto3_connecthealth.type_defs` module for the correct names.
affects: mypy-boto3-builder >= 8.9.0, mypy-boto3-connecthealth >= 1.42.x (packages generated with 8.9.0+)
gotcha`mypy-boto3-connecthealth` is a stub-only package and does not include the actual `boto3` runtime. Your application must have `boto3` installed to function at runtime. The type stubs are solely for static analysis.fixAlways ensure `boto3` is installed in your runtime environment (e.g., `pip install boto3`).
affects: All versions
gotchaFollowing the migration to PEP 561 compliant packages in `mypy-boto3-builder` 8.12.0, ensure your `mypy` or other type checker is up-to-date. Older versions might not correctly discover or utilize the stubs, leading to `Missing type stub` errors or incorrect type inference.fixUpdate your type checker (e.g., `pip install --upgrade mypy`) and ensure it's configured to recognize PEP 561-compliant stub packages.
affects: mypy-boto3-builder >= 8.12.0, mypy-boto3-connecthealth >= 1.42.x
gotchaFor optimal performance and to avoid runtime dependencies, type imports from `mypy_boto3_*` packages should ideally be placed within `if TYPE_CHECKING:` blocks. This ensures that these stub packages are only used by static analysis tools and are not treated as runtime dependencies.fixWrap your `from mypy_boto3_SERVICE import ...` statements in `if TYPE_CHECKING:` blocks.
affects: All versions
gotchaPyCharm users might experience slow performance and high CPU usage due to a known issue with Literal overloads (issue PY-40997) when using `boto3-stubs`.fixConsider installing the `boto3-stubs-lite` version (e.g., `pip install 'boto3-stubs-lite[connecthealth]'`) which is more RAM-friendly but requires explicit type annotations. Alternatively, disable PyCharm's internal type checker and use `mypy` or `pyright` instead.
affects: All versions
Upgrade
Version history
1.43.27latest on PyPI · released Jun 10, 2026
Audit
Dependencies
boto3requiredRuntime dependency for interacting with AWS services.
mypyoptionalStatic type checker to utilize the provided type annotations.