Install & Compatibility
Where this runs
tested against v1.43.59 · 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.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 20.6MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.4s · import 0.000s · 21MB
19MB installed
● package 19MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
IoTSiteWiseClient
✓ from mypy_boto3_iotsitewise import IoTSiteWiseClient
✗ from mypy_boto3_iotsitewise.client import IoTSiteWiseClient
This example demonstrates how to obtain a type-hinted IoTSiteWise client using `boto3` and `mypy-boto3-iotsitewise` for improved static analysis. It includes placeholder credential handling for a runnable example.
import boto3
from mypy_boto3_iotsitewise.client import IoTSiteWiseClient
def get_iotsitewise_client() -> IoTSiteWiseClient:
"""Get a type-hinted AWS IoT SiteWise client."""
# Ensure AWS credentials are set up (e.g., via environment variables or ~/.aws/credentials)
client: IoTSiteWiseClient = boto3.client(
"iotsitewise",
region_name="us-east-1", # Replace with your desired region
aws_access_key_id='YOUR_ACCESS_KEY' or os.environ.get('AWS_ACCESS_KEY_ID', ''),
aws_secret_access_key='YOUR_SECRET_KEY' or os.environ.get('AWS_SECRET_ACCESS_KEY', ''),
aws_session_token='YOUR_SESSION_TOKEN' or os.environ.get('AWS_SESSION_TOKEN', '')
)
return client
if __name__ == "__main__":
# Example usage: list assets (requires appropriate permissions)
try:
iotsitewise_client = get_iotsitewise_client()
response = iotsitewise_client.list_assets(maxResults=5)
print("Successfully retrieved IoT SiteWise assets:")
for asset in response.get("assetSummaries", []):
print(f" - {asset['name']} (ID: {asset['id']})")
except Exception as e:
print(f"Error interacting with IoT SiteWise: {e}")
Debug
Known issues
breakingSupport for Python 3.8 was removed in `mypy-boto3-builder` version 8.12.0. Users on Python 3.8 or older must upgrade to Python 3.9+ to use packages generated by this builder (including `mypy-boto3-iotsitewise` versions built with 8.12.0+).fixUpgrade your Python environment to 3.9 or newer.
affects: mypy-boto3-builder >= 8.12.0
breakingThe `mypy-boto3-builder` migrated to PEP 561 compliant package structure in version 8.12.0. This change might affect how some build systems or older type checkers locate or process the stub packages.fixEnsure your environment and type checker are updated to support PEP 561. Reinstalling the stub package might be necessary.
affects: mypy-boto3-builder >= 8.12.0
breakingTypeDef naming conventions changed in `mypy-boto3-builder` 8.9.0. Specifically, redundant 'Request' suffixes were removed (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`), and 'Extra' postfixes were moved (e.g., `CreateDistributionExtraRequestTypeDef` -> `CreateDistributionRequestExtraTypeDef`). While the example refers to `Distribution`, this is a general change that may affect explicit references to generated TypeDefs for IoTSiteWise.fixReview and update any explicit TypeDef references in your codebase to match the new naming conventions.
affects: mypy-boto3-builder >= 8.9.0
gotchaThe `mypy-boto3` ecosystem offers both standalone service packages (e.g., `mypy-boto3-iotsitewise`) and a consolidated `boto3-stubs` package with service-specific extras (e.g., `boto3-stubs[iotsitewise]`). Installing both for the same service can lead to conflicts or larger-than-necessary dependency graphs. Choose one method.fixPrefer `boto3-stubs` with extras if using multiple AWS services, or standalone packages for single-service projects, and ensure you don't install both for the same service.
affects: All
gotchaIf using `boto3-stubs-lite` (a more RAM-friendly variant), explicit type annotations for `session.client` and `session.resource` calls are *required* because it does not provide overloads for auto-discovery, unlike the full `boto3-stubs` or `mypy-boto3-` standalone packages.fixAlways provide explicit type annotations (e.g., `client: IoTSiteWiseClient = session.client("iotsitewise")`) when using `boto3-stubs-lite` or individual `-lite` stub packages. affects: All (when using -lite variants)
Upgrade
Version history
1.43.59latest on PyPI · released Jul 29, 2026
Audit
Dependencies
boto3requiredThis package provides type stubs for the boto3 library's IoTSiteWise client.
pythonrequiredRequires Python 3.9 or newer due to removal of Python 3.8 support in mypy-boto3-builder 8.12.0.