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
- The repo appears to be actively maintained, with an upstream push on 2026-01-25. Recent published updates (v0.4.x) continued through 2025-10-01, and there is no evidence of abandonment.
- Update cadence looks moderately regular in 2025 (roughly every 3 to 5 months for v0.3.x to v0.4.x), but the latest documented update is v0.4.2 on 2025-10-01, leaving a larger gap until today (2026-06-09), despite that 2026-01-25 upstream activity.
AI summary generated 2026-06-09
Recent updates
v0.4.2
2025-10-01Release 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
2025-06-12v0.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
2025-02-25v0.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
2025-02-24v0.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
2025-02-24v0.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
2025-02-23v0.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
2025-02-23v0.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.