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.95 runs
installs and imports cleanly · install 0.0s · import 0.774s · 117.2MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 6.0s · import 0.702s · 115MB
115MB installed
● package 115MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
DatabaseMigrationServiceClient
✓ from mypy_boto3_dms.client import DatabaseMigrationServiceClient
Primary client type for DMS.
DescribeReplicationTasksResponseTypeDef
✓ from mypy_boto3_dms.type_defs import DescribeReplicationTasksResponseTypeDef
Example TypeDef for API response structures.
AssessmentReportTypeType
✓ from mypy_boto3_dms.literals import AssessmentReportTypeType
Example Literal type for specific string values.
This quickstart demonstrates how to initialize a `boto3` DMS client with type annotations and perform a simple API call. The `TYPE_CHECKING` block ensures that type-only imports do not incur runtime overhead. Replace placeholder environment variables with actual AWS credentials for real use.
import boto3
from typing import TYPE_CHECKING
from os import environ
if TYPE_CHECKING:
from mypy_boto3_dms.client import DatabaseMigrationServiceClient
from mypy_boto3_dms.type_defs import DescribeReplicationTasksResponseTypeDef
def list_dms_replication_tasks() -> "DescribeReplicationTasksResponseTypeDef":
"""Lists DMS replication tasks with type hints."""
# Explicitly type the client for enhanced IDE support and static analysis.
client: DatabaseMigrationServiceClient = boto3.client(
"dms",
region_name=environ.get("AWS_REGION", "us-east-1"),
aws_access_key_id=environ.get("AWS_ACCESS_KEY_ID", "TEST_ACCESS_KEY"),
aws_secret_access_key=environ.get("AWS_SECRET_ACCESS_KEY", "TEST_SECRET_KEY"),
)
response = client.describe_replication_tasks()
print("DMS Replication Tasks:", response.get("ReplicationTasks"))
return response
if __name__ == "__main__":
list_dms_replication_tasks()
Debug
Known issues
breakingPython 3.8 support was removed starting with `mypy-boto3-builder` version 8.12.0. Ensure your project uses Python 3.9 or newer.fixUpgrade your Python environment to 3.9 or a later version.
affects: mypy-boto3-builder >= 8.12.0 (affecting mypy-boto3-dms from this version onwards)
breakingTypeDef naming conventions changed in `mypy-boto3-builder` 8.9.0. Some packed method arguments now use shorter names (e.g., `RequestRequestTypeDef` -> `RequestTypeDef`), and conflicting `Extra` postfixes were moved (`ExtraRequestTypeDef` -> `RequestExtraTypeDef`). While this applies generally to generated service stubs, it may impact DMS TypeDefs if such patterns were used.fixUpdate your code to reflect the new TypeDef naming conventions if you were using explicitly imported TypeDefs that matched these patterns.
affects: mypy-boto3-builder >= 8.9.0 (affecting mypy-boto3-dms from this version onwards)
gotchaPyCharm may experience slow performance or high CPU usage with `Literal` overloads, a common pattern in `mypy-boto3` stubs. It is recommended to use `boto3-stubs-lite` or disable PyCharm's internal type checker in favor of `mypy` or `pyright`.fixConsider installing `boto3-stubs-lite` (if available for DMS) or configure PyCharm to use external type checkers like Mypy/Pyright for `boto3` code.
affects: All versions, specifically with PyCharm
gotchaWhile many IDEs offer auto-discovery, explicitly annotating your `boto3.client('dms')` calls with `DatabaseMigrationServiceClient` provides the most robust type checking and autocompletion experience.fixAdd explicit type annotations, as shown in the quickstart example: `client: DatabaseMigrationServiceClient = boto3.client("dms")`. affects: All versions
gotcha`mypy-boto3-dms` is a stub-only package (PEP 561) and does not contain any runtime code. It must be installed in the same Python environment as `boto3` and `mypy` for type checkers to correctly find and utilize its type information.fixEnsure `mypy-boto3-dms` is installed via `pip` (or equivalent package manager) in the environment where your type checker runs. Avoid relying on `MYPYPATH` for stub-only packages.
affects: All versions
Upgrade
Version history
1.43.59latest on PyPI · released Jul 29, 2026
Audit
Dependencies
boto3requiredRuntime dependency for interacting with AWS services.
mypyrequiredRequired for static type checking.