matrx-orm 3.1.26__tar.gz → 3.1.27__tar.gz

{matrx_orm-3.1.26 → matrx_orm-3.1.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrx-orm
-Version: 3.1.26
+Version: 3.1.27
 Summary: Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching
 Project-URL: Homepage, https://github.com/AI-Matrix-Engine/aidream-current
 Project-URL: Repository, https://github.com/AI-Matrix-Engine/aidream-current

{matrx_orm-3.1.26 → matrx_orm-3.1.27}/matrx_orm/core/MODULE_README.md

@@ -28,6 +28,15 @@ python utils/code_context/generate_module_readme.py src/matrx_orm/core --mode si
 
 ## Architecture
 
+### Pydantic bridge default invariant
+
+`pydantic_bridge.py` derives input/output schemas from ORM fields. Every
+non-`None` static field default is normalized through that field's `to_python`
+conversion before it is attached to the generated Pydantic schema. This keeps
+defaults canonical even though Pydantic does not validate defaults by default
+(for example, `DecimalField(default=0)` exposes `Decimal("0")`, not an `int`) and
+prevents serializer type warnings at API boundaries.
+
 > **Fill this in.** Describe the execution flow and layer map for this module.
 > See `utils/code_context/MODULE_README_SPEC.md` for the recommended format.
 >

{matrx_orm-3.1.26 → matrx_orm-3.1.27}/matrx_orm/core/pydantic_bridge.py

@@ -210,7 +210,6 @@ def _field_annotation(field: Any, *, partial: bool) -> tuple[Any, Any]:
     from matrx_orm.core.fields import (  # noqa: PLC0415
         DateField,
         DateTimeField,
-        EnumField,
         ForeignKey,
         TimeField,
     )
@@ -218,15 +217,15 @@ def _field_annotation(field: Any, *, partial: bool) -> tuple[Any, Any]:
     py_type = field.python_type()
 
     def _default() -> Any:
-        """ORM field defaults for EnumField are often bare strings
-        (``default='internal'`` in generated models). Pydantic v2 does not
-        re-validate defaults, so a string default on an Enum-typed field
-        survives onto the instance and ``model_dump()`` emits
-        ``PydanticSerializationUnexpectedValue``. Coerce via ``to_python``
-        so the schema default is a real enum member.
+        """Coerce ORM defaults into each field's canonical Python type.
+
+        Pydantic v2 does not re-validate defaults. Generated model defaults
+        therefore otherwise retain their DB-literal types (for example ``0``
+        on a DecimalField or ``"internal"`` on an EnumField), and
+        ``model_dump()`` emits ``PydanticSerializationUnexpectedValue``.
         """
         value = field.get_default()
-        if isinstance(field, EnumField) and value is not None:
+        if value is not None:
             try:
                 return field.to_python(value)
             except (TypeError, ValueError):

{matrx_orm-3.1.26 → matrx_orm-3.1.27}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.26"
+version = "3.1.27"
 description = "Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching"
 readme = "README.md"
 license = { text = "MIT" }

matrx_orm-3.1.27/tests/level1/test_pydantic_bridge.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import warnings
+from decimal import Decimal
+
+from matrx_orm import (
+    DecimalField,
+    Model,
+    TextField,
+    UUIDField,
+    build_input_schema,
+    validate_model_input,
+)
+
+
+class CostedRecord(Model):
+    _table_name = "costed_record"
+    _database = "test"
+
+    id = UUIDField(primary_key=True)
+    name = TextField(null=False)
+    total_cost = DecimalField(null=False, default=0)
+
+
+def test_decimal_default_is_canonical_before_pydantic_serialization() -> None:
+    with warnings.catch_warnings(record=True) as caught:
+        warnings.simplefilter("always")
+        validated = validate_model_input(CostedRecord, {"name": "example"})
+
+    assert validated == {"name": "example"}
+    schema = build_input_schema(CostedRecord)
+    assert schema(name="example").total_cost == Decimal("0")
+    assert not [w for w in caught if "Pydantic serializer warnings" in str(w.message)]