typing-inspection provides tools to inspect type annotations at runtime in Python. It is useful for developers who need to understand or validate typing information while the program is running.
Project status
- Actively maintained, with the most recent upstream push and corresponding package update on 2026-08-12, and prior updates arriving repeatedly across 2025 and 2026 (not a long dormant gap).
- Apparent update cadence is roughly every few months during 2025, and still continuing in 2026 (latest change about 1 week before today, 2026-08-20).
AI summary generated
Recent updates
v0.4.3
Release v0.4.3 drops Python 3.9 support, adds Python 3.15 compatibility, and improves runtime performance in typing inspection by avoiding repeated module attribute lookups. Most functional changes are targeted at introspection/type-check helpers, with several CI and tooling updates accompanying the release.
BreakingFeaturesv0.4.2
Release v0.4.2 adds a new runtime typing-inspection helper, `typing_objects.is_noextraitems()`, for detecting the `NoExtraItems` sentinel. The release notes document this addition, and the code diff shows it implemented across the Python module, type stubs, docs, and tests.
Featuresv0.4.1
v0.4.1 focuses on compatibility and typing-introspection correctness improvements, especially around newer Python versions (including 3.14) and union/forward reference handling. It also updates type hints for inspected annotation metadata and introduces a new runtime helper for detecting ForwardRef instances.
Featuresv0.4.0
v0.4.0 adds runtime introspection support for dataclasses.InitVar by introducing a new DATACLASS annotation source and the corresponding init_var qualifier. It also improves the ForbiddenQualifier exception by explicitly annotating the qualifier attribute. Overall, this release is primarily feature-focused with small internal code adjustments.
Featuresv0.3.1
v0.3.1 primarily updates `get_literal_values` to handle `Literal` arguments that contain unhashable items. This release includes a small test addition covering unhashable `Literal` parameters.
v0.3.0
v0.3.0 renames the bare-type sentinel from INFERRED to UNKNOWN and extends introspection to handle bare ClassVar as a valid qualifier without requiring a type expression. The release also updates docs and tests to reflect the new sentinel semantics.
BreakingFeaturesv0.2.0
v0.2.0 adds a new runtime/type-checking helper, `typing_objects.is_deprecated()`, and updates the typing inspection stubs. It also enriches the package metadata with project URLs and corrects stub signatures by adding missing positional-only markers.
BreakingFeaturesv0.1.0
v0.1.0 is the initial release of this project, so there are no documented feature additions, fixes, or changes beyond establishing the baseline functionality. Developers should treat this version as the starting point and verify compatibility based on the first published API and behavior.