Install & Compatibility
Where this runs
tested against v1.43.25 · 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.597s · 53.3MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 5.6s · import 0.560s · 54MB
52MB installed
● package 52MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
TaxSettingsClient
✓ from mypy_boto3_taxsettings.client import TaxSettingsClient
AccountDetailsTypeDef
✓ from mypy_boto3_taxsettings.type_defs import AccountDetailsTypeDef
Example TypeDef for service request/response bodies.
Demonstrates how to use type hints for the TaxSettingsClient. The `if TYPE_CHECKING:` block ensures that type imports are only active during type checking, avoiding runtime import issues and improving performance. An explicit type annotation is used for the client and return type for clarity.
from typing import TYPE_CHECKING
import boto3
if TYPE_CHECKING:
from mypy_boto3_taxsettings.client import TaxSettingsClient
from mypy_boto3_taxsettings.type_defs import GetTaxRegistrationOutputTypeDef
def get_tax_registration_details(region: str) -> 'GetTaxRegistrationOutputTypeDef':
client: TaxSettingsClient = boto3.client("taxsettings", region_name=region)
response = client.get_tax_registration()
print(response)
return response
if __name__ == "__main__":
# Replace 'us-east-1' with your desired AWS region
# ensure your AWS credentials are configured (e.g., via AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY env vars or ~/.aws/credentials)
try:
tax_details = get_tax_registration_details("us-east-1")
print(f"Successfully retrieved tax registration details: {tax_details}")
except Exception as e:
print(f"Error retrieving tax registration details: {e}")
Debug
Known issues
breakingPython 3.8 support has been removed. All `mypy-boto3` packages, including `mypy-boto3-taxsettings`, now require Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or higher. For older Python versions, use an older `mypy-boto3-taxsettings` version compatible with your Python runtime.
affects: mypy-boto3-builder 8.12.0 and above (which generates mypy-boto3-taxsettings 1.42.3+)
gotchaThis package provides only type stubs. The actual `boto3` library must be installed separately in your environment for the code to run at runtime.fixEnsure `boto3` is installed alongside `mypy-boto3-taxsettings` (e.g., `pip install boto3 mypy-boto3-taxsettings`).
affects: All versions
gotchaIt is best practice to wrap type-only imports (e.g., `TaxSettingsClient`, `TypeDefs`) within an `if TYPE_CHECKING:` block to prevent potential runtime import errors or circular dependencies and improve runtime performance.fixEncapsulate type imports: `from typing import TYPE_CHECKING` and then `if TYPE_CHECKING: from mypy_boto3_taxsettings.client import TaxSettingsClient`.
affects: All versions
breakingThe `mypy-boto3-builder` version 8.9.0 introduced breaking changes to `TypeDef` naming conventions (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`). If you are explicitly referencing `TypeDef` names from older `mypy-boto3` versions, these may have changed.fixReview your code for explicit `TypeDef` references and update names according to the latest generated types if upgrading from a significantly older `mypy-boto3` stub version.
affects: mypy-boto3-builder 8.9.0 and above. Affects `mypy-boto3` stub packages generated by these builder versions.
gotchaPyCharm's built-in type checker may experience slow performance with Literal overloads. For better performance, consider using `boto3-stubs-lite` or configuring PyCharm to use `mypy` or `pyright` as its type checker.fixInstall `boto3-stubs-lite[taxsettings]` instead (`pip install 'boto3-stubs-lite[taxsettings]'`), or disable PyCharm's internal type checker and use an external one like `mypy` or `pyright`.
affects: All versions, specifically affecting PyCharm users.
Upgrade
Version history
1.43.25latest on PyPI · released Jun 8, 2026
Audit
Dependencies
boto3requiredRuntime dependency for AWS SDK functionality, as this package only provides type stubs.
mypyrequiredStatic type checker. Other type checkers like PyRight also work.
pythonrequiredRequires Python 3.9 or higher due to recent builder changes.