metaobjects 0.17.0__tar.gz → 0.19.0__tar.gz

{metaobjects-0.17.0 → metaobjects-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metaobjects
-Version: 0.17.0
+Version: 0.19.0
 Summary: Cross-language metadata standard: declare typed entities once, generate idiomatic drift-checked code across languages — Python port.
 Project-URL: Homepage, https://metaobjects.dev
 Project-URL: Repository, https://github.com/metaobjectsdev/metaobjects

{metaobjects-0.17.0 → metaobjects-0.19.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "metaobjects"
-version = "0.17.0"
+version = "0.19.0"
 description = "Cross-language metadata standard: declare typed entities once, generate idiomatic drift-checked code across languages — Python port."
 readme = "README.md"
 requires-python = ">=3.11"

{metaobjects-0.17.0 → metaobjects-0.19.0}/src/metaobjects/spec_metamodel/__init__.py

@@ -55,6 +55,7 @@ SPEC_FILES: tuple[str, ...] = (
     "source.json",
     "template.json",
     "ui.json",
+    "ui-web.json",
     "validator.json",
     "view.json",
 )

metaobjects-0.19.0/src/metaobjects/spec_metamodel/ui-web.json

@@ -0,0 +1,21 @@
+{
+  "provider": "metaobjects-ui-web",
+  "extends": [
+    {
+      "type": "view", "subType": "textarea",
+      "children": [
+        { "type": "attr", "subType": "int", "name": "rows", "min": 0, "max": 1, "description": "Visible row count for the generated <textarea>; the form generator defaults to 4 when absent." }
+      ]
+    },
+    {
+      "type": "view", "subType": "image",
+      "children": [
+        { "type": "attr", "subType": "double", "name": "aspectRatio", "min": 0, "max": 1, "description": "Crop aspect ratio (width / height). Omit for freeform." },
+        { "type": "attr", "subType": "int", "name": "maxEdge", "min": 0, "max": 1, "description": "Longest-edge bound in px for the re-encoded output." },
+        { "type": "attr", "subType": "string", "name": "store", "min": 0, "max": 1, "description": "Opaque storage-namespace hint passed to the upload adapter (not infrastructure)." },
+        { "type": "attr", "subType": "string", "name": "accept", "isArray": true, "min": 0, "max": 1, "description": "Accepted MIME types (client guard; the server re-enforces)." },
+        { "type": "attr", "subType": "int", "name": "maxBytes", "min": 0, "max": 1, "description": "Client-side size ceiling in bytes." }
+      ]
+    }
+  ]
+}

{metaobjects-0.17.0 → metaobjects-0.19.0}/src/metaobjects/spec_metamodel/ui.json

@@ -7,7 +7,8 @@
       "children": [
         { "type": "attr", "subType": "boolean", "name": "filterable", "min": 0, "max": 1, "description": "When true, the field is exposed in generated CRUD filter allowlists (Project D filter layer)." },
         { "type": "attr", "subType": "boolean", "name": "sortable", "min": 0, "max": 1, "description": "When true, the field is exposed in generated CRUD sort allowlists. Inherits from @filterable by default; set false to opt out." },
-        { "type": "attr", "subType": "string", "name": "sortableDefaultOrder", "min": 0, "max": 1, "allowedValues": ["asc", "desc"], "description": "Default sort direction applied when this field is the default sort field." }
+        { "type": "attr", "subType": "string", "name": "sortableDefaultOrder", "min": 0, "max": 1, "allowedValues": ["asc", "desc"], "description": "Default sort direction applied when this field is the default sort field." },
+        { "type": "attr", "subType": "boolean", "name": "formExclude", "min": 0, "max": 1, "description": "When true, the field is omitted from generated forms. Inert on fields for which no form is generated (e.g. projection/derived fields)." }
       ]
     },
     {

{metaobjects-0.17.0 → metaobjects-0.19.0}/src/metaobjects/spec_metamodel/view.json

@@ -70,6 +70,7 @@
       "type": "view",
       "subType": "currency",
       "description": "Currency display formatting (locale-aware via @locale)."
-    }
+    },
+    { "type": "view", "subType": "image", "description": "Image upload/display control; the field stores an opaque storage key (field.string)." }
   ]
 }

metaobjects-0.19.0/tests/codegen/test_origin_nullability.py

@@ -0,0 +1,129 @@
+"""#195 — the ``origin_guaranteed_non_null`` contract drives read-model nullability.
+
+A projection field derived by ``origin.aggregate @agg:any|all|collect`` is
+COALESCE-guaranteed non-null in the synthesized view (any→false, all→true,
+collect→[]), so the generated Pydantic read model types it as MANDATORY even when
+the field is not ``@required``. ``origin.first`` (an empty related set selects no
+row → null) and ``origin.computed`` (nullability is expression-dependent) stay the
+conservative nullable default.
+
+Mirrors the TS ``codegen-ts`` ``projection-decl.test.ts`` "#195 projection
+read-schema nullability" block — the Python port had the ``origin_guaranteed_non_null``
+logic (``entity_model.py``) but no test pinning it.
+"""
+
+import metaobjects.core_types  # noqa: F401 — side-effect: registers attr classes
+from metaobjects.codegen.generators.entity_model import (
+    origin_guaranteed_non_null,
+    render_entity_model,
+)
+from metaobjects.meta.core.field import field_constants as fc
+from metaobjects.meta.core.field.meta_field import MetaField
+from metaobjects.meta.core.object.meta_object import MetaObject
+from metaobjects.meta.persistence.origin.meta_origin import MetaOrigin
+from metaobjects.meta.persistence.origin.origin_constants import (
+    AGG_ALL,
+    AGG_ANY,
+    AGG_COLLECT,
+    ORIGIN_ATTR_AGG,
+    ORIGIN_SUBTYPE_AGGREGATE,
+    ORIGIN_SUBTYPE_COMPUTED,
+    ORIGIN_SUBTYPE_FIRST,
+)
+from metaobjects.meta.persistence.source.meta_source import MetaSource
+from metaobjects.meta.persistence.source.source_constants import (
+    SOURCE_ATTR_KIND,
+    SOURCE_KIND_VIEW,
+    SOURCE_SUBTYPE_RDB,
+)
+from metaobjects.shared.base_types import (
+    TYPE_FIELD,
+    TYPE_OBJECT,
+    TYPE_ORIGIN,
+    TYPE_SOURCE,
+)
+
+
+def _aggregate(agg: str) -> MetaOrigin:
+    o = MetaOrigin(TYPE_ORIGIN, ORIGIN_SUBTYPE_AGGREGATE, agg)
+    o.set_attr(ORIGIN_ATTR_AGG, agg)
+    return o
+
+
+def _origin(sub_type: str) -> MetaOrigin:
+    return MetaOrigin(TYPE_ORIGIN, sub_type, "")
+
+
+def _field(
+    name: str, sub: str, origin: MetaOrigin, *, is_array: bool = False
+) -> MetaField:
+    f = MetaField(TYPE_FIELD, sub, name)
+    f.is_array = is_array
+    f.add_child(origin)
+    return f
+
+
+# ── origin_guaranteed_non_null (the function under test) ─────────────────────
+
+
+def test_guaranteed_non_null_true_for_any_all_collect() -> None:
+    for agg in (AGG_ANY, AGG_ALL, AGG_COLLECT):
+        f = _field("x", fc.FIELD_SUBTYPE_BOOLEAN, _aggregate(agg))
+        assert origin_guaranteed_non_null(f) is True, agg
+
+
+def test_guaranteed_non_null_false_for_first_and_computed() -> None:
+    for sub in (ORIGIN_SUBTYPE_FIRST, ORIGIN_SUBTYPE_COMPUTED):
+        f = _field("x", fc.FIELD_SUBTYPE_STRING, _origin(sub))
+        assert origin_guaranteed_non_null(f) is False, sub
+
+
+def test_guaranteed_non_null_false_without_origin() -> None:
+    plain = MetaField(TYPE_FIELD, fc.FIELD_SUBTYPE_STRING, "x")
+    assert origin_guaranteed_non_null(plain) is False
+
+
+# ── end-to-end read-model typing ─────────────────────────────────────────────
+
+
+def _projection() -> MetaObject:
+    """A view-backed read projection carrying one field per #195 origin kind — all
+    NON-required, so nullability is decided purely by origin_guaranteed_non_null."""
+    o = MetaObject(TYPE_OBJECT, "entity", "OrderInsights")
+    o.package = "acme::test"
+    src = MetaSource(TYPE_SOURCE, SOURCE_SUBTYPE_RDB, "")
+    src.set_attr(SOURCE_ATTR_KIND, SOURCE_KIND_VIEW, sub_type="string")
+    o.add_child(src)
+    o.add_child(MetaField(TYPE_FIELD, fc.FIELD_SUBTYPE_INT, "id"))
+    o.add_child(_field("hasLong", fc.FIELD_SUBTYPE_BOOLEAN, _aggregate(AGG_ANY)))
+    o.add_child(_field("allLong", fc.FIELD_SUBTYPE_BOOLEAN, _aggregate(AGG_ALL)))
+    o.add_child(
+        _field(
+            "labels", fc.FIELD_SUBTYPE_STRING, _aggregate(AGG_COLLECT), is_array=True
+        )
+    )
+    o.add_child(
+        _field("latest", fc.FIELD_SUBTYPE_STRING, _origin(ORIGIN_SUBTYPE_FIRST))
+    )
+    o.add_child(
+        _field("flag", fc.FIELD_SUBTYPE_BOOLEAN, _origin(ORIGIN_SUBTYPE_COMPUTED))
+    )
+    return o
+
+
+def test_read_model_typing_any_all_collect_mandatory_first_computed_optional() -> None:
+    # A view-backed projection is read-only (no Create/Patch model), so the whole
+    # rendered module is the read model.
+    read_model = render_entity_model(_projection())
+
+    # any / all / collect → COALESCE-guaranteed → mandatory, NO ``| None``.
+    assert "hasLong: bool" in read_model
+    assert "hasLong: bool | None" not in read_model
+    assert "allLong: bool" in read_model
+    assert "allLong: bool | None" not in read_model
+    assert "labels: list[str]" in read_model
+    assert "labels: list[str] | None" not in read_model
+
+    # first / computed → conservative nullable.
+    assert "latest: str | None" in read_model
+    assert "flag: bool | None" in read_model