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.3MB
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.
SchemaSummaryTypeDef
✓ from mypy_boto3_schemas.type_defs import SchemaSummaryTypeDef
✗ from mypy_boto3_schemas.type_defs import SchemaSummaryTypeDef
Demonstrates how to import and use a TypeDef for the AWS Schemas service. It includes a `TYPE_CHECKING` block to guard against runtime dependencies on the stub package for production environments, which is a common pattern for `mypy-boto3` users. It shows how to define a schema input using the `CreateSchemaInputRequestTypeDef`.
from typing import TYPE_CHECKING
from mypy_boto3_schemas.type_defs import CreateSchemaInputRequestTypeDef
if TYPE_CHECKING:
import boto3
from mypy_boto3_schemas.client import SchemasClient
def create_example_schema(client: "SchemasClient") -> None:
# Example of a TypeDef for schema creation input
schema_input: CreateSchemaInputRequestTypeDef = {
"RegistryName": "my-registry",
"SchemaName": "my-schema",
"Content": "{\"type\": \"object\", \"properties\": {\"foo\": {\"type\": \"string\"}}}",
"Type": "OpenApi3", # Or 'JSONSchema', 'WSDL', 'XSD'
}
print(f"Attempting to create schema: {schema_input['SchemaName']}")
# In a real application, you would call a boto3 client method here, e.g.:
# client.create_schema(**schema_input)
# Example usage (requires boto3 to be installed and configured)
if __name__ == "__main__":
# This part would typically interact with a real boto3 client
# For demonstration, we'll use a mock if boto3 is not present
try:
import boto3
schemas_client: "SchemasClient" = boto3.client("schemas")
create_example_schema(schemas_client)
except ImportError:
print("boto3 not installed. Skipping live client example, but type hints are still valid.")
Debug
Known issues
breakingStarting with `mypy-boto3-builder` version 8.12.0 (which generates this package), support for Python 3.8 has been removed. Projects using `mypy-boto3-schemas` must use Python 3.9 or newer.fixUpgrade your project's Python interpreter to 3.9 or newer.
affects: >=8.12.0 (builder), >=1.42.0 (schemas)
breakingIn `mypy-boto3-builder` version 8.9.0, there were breaking changes to TypeDef naming conventions. Conflicting TypeDef names had `Extra` moved to the end (e.g., `CreateDistributionExtraRequestTypeDef` -> `CreateDistributionRequestExtraTypeDef`), and packed method arguments use shorter names (`CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`).fixReview and update TypeDef names in your codebase according to the new conventions. Refer to the specific service documentation for exact changes.
affects: >=8.9.0 (builder)
deprecatedThe `sms-voice` service was removed in `mypy-boto3-builder` version 8.11.0. If your project uses type hints for `sms-voice`, you should migrate to `pinpoint-sms-voice`.fixReplace imports and usage of `mypy_boto3_sms_voice` with `mypy_boto3_pinpoint_sms_voice` and update your `boto3` client calls accordingly.
affects: >=8.11.0 (builder)
gotchaThis package (`mypy-boto3-schemas`) is a stub-only library for static type checking. It does not contain any runtime code. You must have `boto3` (or `aioboto3` for async variants) installed in your environment for your application to run.fixEnsure `boto3` is installed via `pip install boto3`. It is recommended to install `mypy` as well if you intend to perform static type checks.
affects: *
gotchaWhen using `mypy-boto3` stubs with `pylint`, `pylint` might complain about undefined variables if types are used directly without a `TYPE_CHECKING` guard. This is because `pylint` may not fully understand the stub-only nature of the imports.fixWrap stub-only imports within a `if TYPE_CHECKING:` block and set runtime types to `object` outside of it to prevent `pylint` errors. This ensures type hints are only active during static analysis.
affects: *
Upgrade
Version history
1.43.0latest on PyPI · released Apr 29, 2026
Audit
Dependencies
boto3requiredmypy-boto3-schemas provides type annotations for boto3; boto3 is required at runtime for the type hints to be useful.
mypyoptionalThis is a stub package for static type checking; mypy is the primary tool used to leverage these annotations.