Install & Compatibility
Where this runs
tested against v1.43.0 · 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.4MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
FinspaceClient
✓ from mypy_boto3_finspace import FinspaceClient
✗ from mypy_boto3_finspace import FinspaceClient
This quickstart demonstrates how to initialize a boto3 Finspace client and use it with type hints provided by `mypy-boto3-finspace`. The `TYPE_CHECKING` guard ensures that type stub imports do not affect runtime behavior. It fetches a list of Finspace environments, illustrating type-safe interaction.
import boto3
import os
from typing import TYPE_CHECKING
# Only import type stubs when type checking
if TYPE_CHECKING:
from mypy_boto3_finspace.client import FinspaceClient
from mypy_boto3_finspace.type_defs import ListEnvironmentsResponseTypeDef
# Create a boto3 client (runtime object)
client = boto3.client(
"finspace",
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-east-1')
)
# Type hint the client for static analysis (optional at runtime, crucial for mypy)
if TYPE_CHECKING:
finspace_client: FinspaceClient = client
else:
finspace_client = client
try:
# Use the client with type-checked arguments and return types
response: ListEnvironmentsResponseTypeDef = finspace_client.list_environments()
print("Finspace Environments:")
for env in response.get('environments', []):
print(f" - {env.get('name')} ({env.get('status')})")
except Exception as e:
print(f"Error listing Finspace environments: {e}")
Debug
Known issues
breakingPython 3.8 is no longer supported. Packages generated by `mypy-boto3-builder` version 8.12.0 and later, including `mypy-boto3-finspace` 1.42.3, require Python 3.9 or higher.fixUpgrade your Python environment to 3.9 or newer. If you must use Python 3.8, pin your `mypy-boto3-finspace` version to a compatible older release (e.g., < 1.42.3).
affects: mypy-boto3-finspace >= 1.42.3 (aligned with builder >= 8.12.0)
gotchaThis library provides type *stubs* for boto3, not the boto3 library itself. You must install `boto3` separately for your code to run.fixEnsure `boto3` is installed in your environment: `pip install boto3`.
affects: All versions
breakingMany generated TypeDef names were shortened by `mypy-boto3-builder` (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`). This can break explicit references to these types.fixUpdate your code to use the new, shorter TypeDef names. Refer to the `type_defs.pyi` file within the installed package or the `mypy-boto3` documentation for the correct names.
affects: mypy-boto3-finspace >= 1.35.0 (aligned with builder >= 8.9.0)
gotchaThe version of `mypy-boto3-finspace` (e.g., `1.42.3`) is primarily tied to the `boto3` version that defines the Finspace service client, not the `mypy-boto3-builder`'s semantic versioning. This can lead to confusion when tracking updates.fixWhen troubleshooting or upgrading, remember that the `mypy-boto3-*` package version reflects the specific `boto3` API version it types. Consult the `mypy-boto3` GitHub repository or PyPI page for clarity on version alignment if issues arise after a `boto3` or `mypy-boto3-builder` update.
affects: All versions
Upgrade
Version history
1.43.0latest on PyPI · released Apr 29, 2026
Audit
Dependencies
boto3requiredProvides the actual runtime AWS SDK functionality; mypy-boto3-finspace only provides type stubs.
typing-extensionsoptionalMay be required for full type compatibility on older Python versions (before 3.9) or for specific advanced typing features.