python-introspect 0.1.6__tar.gz → 0.1.8__tar.gz

{python_introspect-0.1.6/src/python_introspect.egg-info → python_introspect-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-introspect
-Version: 0.1.6
+Version: 0.1.8
 Summary: Pure Python introspection toolkit for function signatures, dataclasses, and type hints
 Author-email: Tristan Simas <tristan.simas@mail.mcgill.ca>
 License: MIT

{python_introspect-0.1.6 → python_introspect-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-introspect"
-version = "0.1.6"
+version = "0.1.8"
 description = "Pure Python introspection toolkit for function signatures, dataclasses, and type hints"
 readme = "README.md"
 requires-python = ">=3.10"

{python_introspect-0.1.6 → python_introspect-0.1.8}/src/python_introspect/__init__.py

@@ -9,7 +9,7 @@ Extensibility:
     type resolution for framework-specific types (lazy configs, proxies, etc.)
 """
 
-__version__ = "0.1.6"
+__version__ = "0.1.8"
 
 from .signature_analyzer import (
     SignatureAnalyzer,
@@ -41,6 +41,7 @@ from .enableable import (
     mark_enableable,
 )
 from .validation import (
+    AnnotatedDataclassValidationMixin,
     AnnotationValidationError,
     overlay_non_none_dataclass,
     validate_annotated_dataclass,
@@ -95,6 +96,7 @@ __all__ = [
     "is_enableable",
     "mark_enableable",
     # Runtime annotation validation
+    "AnnotatedDataclassValidationMixin",
     "AnnotationValidationError",
     "overlay_non_none_dataclass",
     "validate_annotated_dataclass",

{python_introspect-0.1.6 → python_introspect-0.1.8}/src/python_introspect/signature_analyzer.py

@@ -936,7 +936,7 @@ class SignatureAnalyzer:
         try:
             # Try to get type hints, fall back to __annotations__ if resolution fails
             try:
-                type_hints = get_type_hints(dataclass_type)
+                type_hints = get_type_hints(dataclass_type, include_extras=True)
             except Exception:
                 type_hints = inspect.get_annotations(dataclass_type, eval_str=False)
 

{python_introspect-0.1.6 → python_introspect-0.1.8}/src/python_introspect/validation.py

@@ -27,6 +27,19 @@ class AnnotationValidationError(ValueError):
 DataclassT = TypeVar("DataclassT")
 
 
+class AnnotatedDataclassValidationMixin:
+    """Validate a dataclass instance from its resolved annotations after construction.
+
+    Dataclass declarations inherit this mixin when their annotations are the
+    authoritative runtime schema. Keeping the lifecycle hook on a nominal base
+    also preserves validation when another package recreates the dataclass with
+    the same bases.
+    """
+
+    def __post_init__(self) -> None:
+        validate_annotated_dataclass(self)
+
+
 def overlay_non_none_dataclass(
     base: DataclassT,
     overlay: object,

{python_introspect-0.1.6 → python_introspect-0.1.8/src/python_introspect.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-introspect
-Version: 0.1.6
+Version: 0.1.8
 Summary: Pure Python introspection toolkit for function signatures, dataclasses, and type hints
 Author-email: Tristan Simas <tristan.simas@mail.mcgill.ca>
 License: MIT

{python_introspect-0.1.6 → python_introspect-0.1.8}/tests/test_init.py

@@ -11,7 +11,7 @@ class TestPackageImports:
         """Test that __version__ is available."""
         assert hasattr(python_introspect, "__version__")
         assert isinstance(python_introspect.__version__, str)
-        assert python_introspect.__version__ == "0.1.6"
+        assert python_introspect.__version__ == "0.1.8"
 
     def test_signature_analyzer_import(self):
         """Test SignatureAnalyzer is importable."""

{python_introspect-0.1.6 → python_introspect-0.1.8}/tests/test_signature_analyzer.py

@@ -5,7 +5,7 @@ from dataclasses import dataclass, field
 from enum import Enum
 from functools import wraps
 from typing import get_args
-from typing import Optional, List, Dict, Any
+from typing import Annotated, Optional, List, Dict, Any
 from python_introspect import (
     SignatureAnalyzer,
     ParameterInfo,
@@ -163,6 +163,18 @@ class TestSignatureAnalyzer:
         assert params["settings"].default_value == {}
         assert params["items"].is_required is False
 
+    def test_analyze_dataclass_preserves_annotated_metadata(self):
+        """Dataclass analysis retains metadata used by downstream projections."""
+        marker = object()
+
+        @dataclass
+        class Config:
+            shortcut: Annotated[str, marker] = "Ctrl+P"
+
+        params = SignatureAnalyzer.analyze(Config)
+
+        assert params["shortcut"].param_type == Annotated[str, marker]
+
     def test_field_type_docs_use_resolved_forward_annotations(self):
         docs = SignatureAnalyzer._extract_field_type_docs(
             ForwardFieldDocumentationOwner

{python_introspect-0.1.6 → python_introspect-0.1.8}/tests/test_validation.py

@@ -1,4 +1,4 @@
-from dataclasses import dataclass
+from dataclasses import dataclass, make_dataclass
 from enum import Enum
 from typing import Annotated, Literal
 
@@ -6,6 +6,7 @@ import pytest
 from annotated_types import Ge, Gt, Le, MinLen, Predicate
 
 from python_introspect import (
+    AnnotatedDataclassValidationMixin,
     overlay_non_none_dataclass,
     validate_annotated_dataclass,
 )
@@ -21,13 +22,10 @@ NonBlankText = Annotated[str, MinLen(1), Predicate(str.strip)]
 
 
 @dataclass(frozen=True)
-class BaseConfig:
+class BaseConfig(AnnotatedDataclassValidationMixin):
     port: Port = 7000
     mode: Mode = Mode.FIRST
 
-    def __post_init__(self) -> None:
-        validate_annotated_dataclass(self)
-
 
 @dataclass(frozen=True)
 class ChildConfig(BaseConfig):
@@ -53,6 +51,19 @@ def test_validation_rejects_wrong_nominal_types_without_coercion() -> None:
         ChildConfig(mode="first")
 
 
+def test_inherited_validation_survives_dataclass_recreation() -> None:
+    RecreatedConfig = make_dataclass(
+        "RecreatedConfig",
+        (("port", Port, 7000),),
+        bases=(AnnotatedDataclassValidationMixin,),
+        frozen=True,
+    )
+
+    assert RecreatedConfig(port=8000).port == 8000
+    with pytest.raises(ValueError, match="port must be at least"):
+        RecreatedConfig(port=0)
+
+
 @dataclass(frozen=True)
 class OptionalConfig:
     port: Port | None = None