python-introspect 0.1.12__tar.gz → 0.1.13__tar.gz

{python_introspect-0.1.12/src/python_introspect.egg-info → python_introspect-0.1.13}/PKG-INFO

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

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

python_introspect-0.1.13/src/python_introspect/callable_declaration.py

@@ -0,0 +1,46 @@
+"""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],
+    omit_defaults: bool = True,
+) -> dict[str, ParameterValue]:
+    """Project supplied kwargs in signature order, optionally omitting defaults.
+
+    Equality remains caller-owned so frameworks can supply semantics for
+    arrays, lazy values, and other values whose ``==`` result is not boolean.
+    Extra kwargs retain their relative input order after declared parameters.
+    Missing parameters are never populated by this projection.
+    """
+
+    try:
+        parameters = inspect.signature(func).parameters
+    except (TypeError, ValueError):
+        parameters = {}
+    defaults = {
+        name: parameter.default
+        for name, parameter in parameters.items()
+        if parameter.default is not inspect.Parameter.empty
+    }
+    return {
+        name: kwargs[name]
+        for name in dict.fromkeys((*parameters, *kwargs))
+        if name in kwargs
+        and (
+            not omit_defaults
+            or name not in defaults
+            or not values_equal(kwargs[name], defaults[name])
+        )
+    }

{python_introspect-0.1.12 → python_introspect-0.1.13/src/python_introspect.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-introspect
-Version: 0.1.12
+Version: 0.1.13
 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.12 → python_introspect-0.1.13}/tests/test_callable_declaration.py

@@ -2,6 +2,8 @@ from __future__ import annotations
 
 from operator import attrgetter
 
+import pytest
+
 from python_introspect import callable_declaration_kwargs
 
 
@@ -38,3 +40,24 @@ def test_callable_declaration_kwargs_preserves_values_for_opaque_callable() -> N
     )
 
     assert declaration == kwargs
+
+
+@pytest.mark.parametrize("omit_defaults", [True, False])
+def test_signature_order_precedes_extra_keywords_without_mutation(omit_defaults):
+    kwargs = {"extra_b": 2, "enabled": False, "threshold": 99.8, "extra_a": 1}
+    original = kwargs.copy()
+    result = callable_declaration_kwargs(
+        sample_function, kwargs, values_equal=lambda a, b: a == b,
+        omit_defaults=omit_defaults,
+    )
+    assert list(result) == ["threshold", "enabled", "extra_b", "extra_a"]
+    assert list(kwargs.items()) == list(original.items())
+    assert result == kwargs
+
+
+def test_full_projection_keeps_explicit_defaults_but_does_not_insert_missing():
+    result = callable_declaration_kwargs(
+        sample_function, {"enabled": True}, values_equal=lambda a, b: a == b,
+        omit_defaults=False,
+    )
+    assert result == {"enabled": True}

python_introspect-0.1.12/src/python_introspect/callable_declaration.py

@@ -1,37 +0,0 @@
-"""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])
-    }