python-introspect 0.1.9__tar.gz → 0.1.10__tar.gz

{python_introspect-0.1.9/src/python_introspect.egg-info → python_introspect-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-introspect
-Version: 0.1.9
+Version: 0.1.10
 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.9 → python_introspect-0.1.10}/pyproject.toml

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

{python_introspect-0.1.9 → python_introspect-0.1.10}/src/python_introspect/__init__.py

@@ -9,7 +9,7 @@ Extensibility:
     type resolution for framework-specific types (lazy configs, proxies, etc.)
 """
 
-__version__ = "0.1.9"
+__version__ = "0.1.10"
 
 from .signature_analyzer import (
     SignatureAnalyzer,
@@ -71,6 +71,7 @@ from .annotation_types import (
     resolve_annotated,
     resolve_optional,
 )
+from .callable_declaration import callable_declaration_kwargs
 
 __all__ = [
     # Version
@@ -127,4 +128,6 @@ __all__ = [
     "optional_member_type",
     "resolve_annotated",
     "resolve_optional",
+    # Callable declarations
+    "callable_declaration_kwargs",
 ]

python_introspect-0.1.10/src/python_introspect/callable_declaration.py

@@ -0,0 +1,37 @@
+"""Declaration projections derived from callable signatures."""
+
+from __future__ import annotations
+
+import inspect
+from collections.abc import Callable, Mapping
+from typing import TypeVar
+
+
+ParameterValue = TypeVar("ParameterValue")
+
+
+def callable_declaration_kwargs(
+    func: Callable,
+    kwargs: Mapping[str, ParameterValue],
+    *,
+    values_equal: Callable[[object, object], bool],
+) -> dict[str, ParameterValue]:
+    """Return declared kwargs whose values differ from signature defaults.
+
+    Equality remains caller-owned so frameworks can supply semantics for
+    arrays, lazy values, and other values whose ``==`` result is not boolean.
+    """
+
+    try:
+        defaults = {
+            name: parameter.default
+            for name, parameter in inspect.signature(func).parameters.items()
+            if parameter.default is not inspect.Parameter.empty
+        }
+    except (TypeError, ValueError):
+        defaults = {}
+    return {
+        name: value
+        for name, value in kwargs.items()
+        if name not in defaults or not values_equal(value, defaults[name])
+    }

{python_introspect-0.1.9 → python_introspect-0.1.10/src/python_introspect.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-introspect
-Version: 0.1.9
+Version: 0.1.10
 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.9 → python_introspect-0.1.10}/src/python_introspect.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 src/python_introspect/__init__.py
 src/python_introspect/annotation_types.py
+src/python_introspect/callable_declaration.py
 src/python_introspect/dataclass_projection.py
 src/python_introspect/enableable.py
 src/python_introspect/environment_projection.py
@@ -16,6 +17,7 @@ src/python_introspect.egg-info/dependency_links.txt
 src/python_introspect.egg-info/requires.txt
 src/python_introspect.egg-info/top_level.txt
 tests/test_annotation_types.py
+tests/test_callable_declaration.py
 tests/test_dataclass_projection.py
 tests/test_environment_projection.py
 tests/test_exceptions.py

python_introspect-0.1.10/tests/test_callable_declaration.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from operator import attrgetter
+
+from python_introspect import callable_declaration_kwargs
+
+
+def sample_function(value, threshold: float = 1.0, enabled: bool = True):
+    return value
+
+
+def test_callable_declaration_kwargs_projects_signature_defaults() -> None:
+    kwargs = {
+        "threshold": 1,
+        "enabled": False,
+        "extension_parameter": "preserved",
+    }
+
+    declaration = callable_declaration_kwargs(
+        sample_function,
+        kwargs,
+        values_equal=lambda left, right: left == right,
+    )
+
+    assert declaration == {
+        "enabled": False,
+        "extension_parameter": "preserved",
+    }
+
+
+def test_callable_declaration_kwargs_preserves_values_for_opaque_callable() -> None:
+    kwargs = {"extension_parameter": "preserved"}
+
+    declaration = callable_declaration_kwargs(
+        attrgetter("value"),
+        kwargs,
+        values_equal=lambda left, right: left == right,
+    )
+
+    assert declaration == kwargs

{python_introspect-0.1.9 → python_introspect-0.1.10}/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.9"
+        assert python_introspect.__version__ == "0.1.10"
 
     def test_signature_analyzer_import(self):
         """Test SignatureAnalyzer is importable."""