thundergraph-model 1.4.2__tar.gz → 1.4.3__tar.gz

{thundergraph_model-1.4.2 → thundergraph_model-1.4.3}/PKG-INFO

@@ -1,8 +1,7 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: thundergraph-model
-Version: 1.4.2
+Version: 1.4.3
 Summary: Executable systems modeling in Python
-License-File: LICENSE
 Requires-Python: >=3.11
 Requires-Dist: unitflow[numpy]>=0.2.0
 Provides-Extra: dev

{thundergraph_model-1.4.2 → thundergraph_model-1.4.3}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["hatchling>=1.24"]
+requires = ["hatchling>=1.24,<1.27"]
 build-backend = "hatchling.build"
 
 [project]
 name = "thundergraph-model"
-version = "1.4.2"
+version = "1.4.3"
 description = "Executable systems modeling in Python"
 readme = "PYPI.md"
 requires-python = ">=3.11"

{thundergraph_model-1.4.2 → thundergraph_model-1.4.3}/tg_model/execution/configured_model.py

@@ -12,6 +12,7 @@ per-run scenario data.
 
 from __future__ import annotations
 
+import uuid
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
@@ -492,6 +493,8 @@ def _instantiate_children(
             _register(constraint_instance, path_registry, id_registry)
 
         elif kind == "citation":
+            # Assign a stable UUID once per citation, independent of name/content
+            metadata["_citation_stable_id"] = str(uuid.uuid4())
             cite_instance = ElementInstance(
                 stable_id=child_id,
                 definition_type=parent.definition_type,
@@ -538,6 +541,8 @@ def _instantiate_requirement_block_children(
             package.add_member(name, req_instance)
             _register(req_instance, path_registry, id_registry)
         elif kind == "citation":
+            # Assign a stable UUID once per citation, independent of name/content
+            metadata["_citation_stable_id"] = str(uuid.uuid4())
             cite_instance = ElementInstance(
                 stable_id=child_id,
                 definition_type=definition_root_type,

{thundergraph_model-1.4.2 → thundergraph_model-1.4.3}/tg_model/execution/stable_ids.py

@@ -87,3 +87,22 @@ def class_scoped_slot_sid(
             return f"class_slot:{cls.__module__}.{cls.__qualname__}:{local_name}"
 
     return None
+
+
+def class_scoped_citation_sid(element: "ElementInstance") -> str | None:
+    """Return the class-scoped stable_id for a citation element.
+
+    Citations are identified by a deterministic UUID assigned once at instantiation,
+    stored in the citation's metadata as ``_citation_stable_id``. This UUID is
+    independent of the citation's name, content, or position, allowing citations to
+    be renamed or edited without creating duplicate nodes.
+
+    Returns ``None`` only when the citation has no _citation_stable_id in metadata
+    (should not occur in a properly instantiated model).
+
+    Format: The raw UUID string assigned at instantiation time.
+    """
+    if not element.metadata:
+        return None
+    citation_uuid = element.metadata.get("_citation_stable_id")
+    return citation_uuid if isinstance(citation_uuid, str) else None