Registry / type-stubs / mypy-boto3-timestream-query

mypy-boto3-timestream-query

library1.43.0pypypi✓ verified 23d ago

mypy-boto3-timestream-query provides type annotations (stubs) for the `boto3` Timestream Query service, enhancing static analysis with tools like MyPy. It is actively maintained by the `youtype/mypy_boto3_builder` project, with versions updated frequently to align with new `boto3` releases and improvements to the builder itself. The current version is 1.42.3.

type-stubs aws

pip install boto3 mypy-boto3-timestream-query

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · MYPY-BOTO3-TIMESTR

mypy-boto3-timestream-query

type-stubspythonv1.43.0

Install

3.9s avg

Import

559ms

Disk

50MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

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

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.570s · 51.9MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 3.9s · import 0.547s · 52MB

50MB installed

● package 50MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TimestreamQueryClient

✓ from mypy_boto3_timestream_query.client import TimestreamQueryClient

✗ from boto3.timestream_query import TimestreamQueryClient

Type stubs are imported from the dedicated `mypy_boto3_` package, not directly from `boto3`.

ListDatabasesResponseTypeDef

✓ from mypy_boto3_timestream_query.type_defs import ListDatabasesResponseTypeDef

✗ from mypy_boto3_timestream_query import ListDatabasesResponseTypeDef

Most generated TypeDefs are located in the `type_defs` submodule for clarity.

Demonstrates how to initialize a `boto3` Timestream Query client and use the `mypy-boto3-timestream-query` stubs for type-hinted API calls. This code requires valid AWS credentials with access to Timestream Query to run successfully.

import boto3 from mypy_boto3_timestream_query.client import TimestreamQueryClient from mypy_boto3_timestream_query.type_defs import ListDatabasesResponseTypeDef # Initialize a boto3 client. Mypy will use the stubs for type checking. # Ensure AWS credentials are configured (e.g., via environment variables, ~/.aws/credentials) client: TimestreamQueryClient = boto3.client("timestream-query") # Example API call with type hinting try: print("Attempting to list Timestream databases...") response: ListDatabasesResponseTypeDef = client.list_databases() databases = response.get("Databases", []) if databases: print("Timestream Databases:") for db in databases: print(f"- {db.get('DatabaseName')}") else: print("No Timestream databases found.") except Exception as e: print(f"Error listing databases: {e}") print("Ensure you have configured AWS credentials with permissions for Timestream Query.")

Debug

Known issues

breakingPython 3.8 support was removed for `mypy-boto3-builder` versions 8.12.0 and later, which includes `mypy-boto3-timestream-query` 1.42.3 and newer. Users on Python 3.8 will encounter installation or runtime errors with these versions.

fix

Upgrade your Python environment to 3.9 or higher, or explicitly pin `mypy-boto3-timestream-query<1.42.3` to use an older compatible version.

affects: >=1.42.3

breakingThe `mypy-boto3-builder` project migrated to PEP 561 compliant namespace packages in version 8.12.0. While largely transparent, this change could affect how type checkers discover packages in complex or non-standard environments.

fix

Verify that your type checker (e.g., MyPy) correctly resolves imports. If issues arise, check your `mypy` configuration (e.g., `MYPYPATH`) and update as necessary. For most users, no action is required.

affects: >=1.42.3

gotchaThese packages provide *type stubs* for `boto3`, not the `boto3` library itself. You must install `boto3` separately (e.g., `pip install boto3`) for runtime functionality. Without `boto3`, your code will fail at runtime.

fix

Always install `boto3` alongside `mypy-boto3-timestream-query`.

affects: all

gotchaFor accurate type checking, the version of `mypy-boto3-timestream-query` should ideally synchronize with the major and minor version of your installed `boto3` library. Significant mismatches can lead to incorrect or missing type hints.

fix

Keep `boto3` and `mypy-boto3-timestream-query` versions aligned. For example, `boto3==1.28.x` should ideally be paired with `mypy-boto3-timestream-query==1.42.x`.

affects: all

breakingIn `mypy-boto3-builder` 8.9.0, the naming conventions for some generated TypeDefs were shortened or adjusted to resolve conflicts (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`). This may require updates if you directly reference generated TypeDef names in your code.

fix

Review the `mypy-boto3-builder` release notes for `8.9.0` and later, and update any directly referenced TypeDef names in your code to match the new convention.

affects: ~>1.38.0

Upgrade

Version history

1.43.0latest on PyPI · released Apr 29, 2026

Audit

Dependencies

boto3requiredRuntime library for which these are type stubs. Required for actual AWS API calls.

mypyoptionalStatic type checker that consumes these stubs for analysis.

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/youtype/mypy_boto3_builder ↗

packagehttps://pypi.org/project/mypy-boto3-timestream-query/ ↗

docshttps://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_query/ ↗