feat: added support for the libraries linking and referencing from model

src/capellambse/aird/_common.py

@@ -44,6 +44,10 @@
     "/xmi:XMI/viewpoint:DAnalysis/ownedViews[viewpoint]",
     namespaces=_n.NAMESPACES,
 )
+XP_DANALYSIS = etree.XPath(
+    "/xmi:XMI/viewpoint:DAnalysis",
+    namespaces=_n.NAMESPACES,
+)
 ELEMENT = builder.ElementMaker(nsmap={"xmi": str(_n.NAMESPACES["xmi"])})
 
 

src/capellambse/loader/core.py

@@ -80,6 +80,11 @@
 METADATA_TAG = f"{{{_n.NAMESPACES['metadata']}}}Metadata"
 _ROOT_NS = "org.polarsys.capella.core.data.capellamodeller"
 
+XP_SEMANTIC_RESOURCES = etree.XPath(
+    "/viewpoint:DAnalysis/semanticResources",
+    namespaces=_n.NAMESPACES,
+)
+
 
 def _derive_entrypoint(
     path: str | os.PathLike | filehandler.FileHandler,
@@ -590,6 +595,106 @@ def check_duplicate_uuids(self) -> None:
                 " - check the 'resources' for duplicate models"
             )
 
+    def __get_metadata(self, afm: ModelFile) -> etree._Element:
+        """Return metadata from given model.
+
+        Parameters
+        ----------
+        afm
+            model metadata file
+
+        Returns
+        -------
+        etree._Element
+            metadata element if found
+
+        Raises
+        ------
+        RuntimeError
+            If metadata could not be found
+        """
+        metadata = next(afm.root.iter(METADATA_TAG), None)
+        if metadata is None:
+            raise RuntimeError("Cannot find <Metadata> in primary .afm file")
+        LOGGER.debug("Found <Metadata> with ID %s", metadata.get("id"))
+        return metadata
+
+    def link_library(self, lib: pathlib.PurePosixPath) -> None:
+        """Link library into the project tree.
+
+        Parameters
+        ----------
+        lib
+            path to a library .aird file
+
+        Description
+        -----------
+        Method updates .aird, .capella, .afm to correcrly reflect library in target model
+
+        When you need to refere to external library (or reuse one in a project)
+        ```
+        p = "..." #path to library
+        model._loader.link_library(p)
+
+        lib = model.project.extensions[0].reference.library
+        ```
+        """
+        handler = self.resources[str(lib)]
+        _h, filename = _derive_entrypoint(handler)
+
+        frag_path = lib.joinpath(filename)
+        if self.trees.get(frag_path) is not None:
+            # for already loaded fragments skip library loading
+            return
+
+        frag = ModelFile(
+            filename, handler, ignore_uuid_dups=self.__ignore_uuid_dups
+        )
+
+        self.trees[frag_path] = frag
+        for ref in _find_refs(frag.root):
+            ref_name = helpers.normalize_pure_path(
+                _unquote_ref(ref), base=frag_path.parent
+            )
+            self.__load_referenced_files(ref_name)
+
+            if ref_name.suffix == ".afm":
+                meta_lib = self.__get_metadata(self.trees[ref_name])
+                meta_self = self.__find_metadata()
+
+                if not next(
+                    filter(
+                        lambda el: re.search(str(ref_name), el.attrib["href"]),
+                        meta_self.iterchildren("additionalResources"),
+                    ),
+                    None,
+                ):
+                    ael = meta_self.makeelement(
+                        "additionalMetadata",
+                        href=f"../{ref_name}#{meta_lib.attrib['id']}",
+                    )
+                    meta_self.append(ael)
+            elif ref_name.suffix == ".capella":
+                aird_self = self.trees[
+                    pathlib.PurePosixPath(f"\x00/{self.entrypoint}")
+                ]
+
+                last = next(
+                    filter(
+                        lambda el: re.search(str(ref_name), el.text),
+                        XP_SEMANTIC_RESOURCES(aird_self.root),
+                    ),
+                    None,
+                )
+                if last is not None:
+                    for r in XP_SEMANTIC_RESOURCES(aird_self.root):
+                        last = r
+
+                    if last is not None:
+                        sr = last.makeelement("semanticResources")
+                        sr.text = f"platform:/resource/{ref_name}"
+                        last.addnext(sr)
+
     def __load_referenced_files(
         self, resource_path: pathlib.PurePosixPath
     ) -> None:
@@ -1302,6 +1407,15 @@ def _find_fragment(
         for fragment, tree in self.trees.items():
             if tree.root is root:
                 return (fragment, tree)
+        # fallback here is necessary because
+        # working with root collections, i.e. key_value_pairs,
+        # causes project root being represented by two entities, i.e.
+        # <Element {http://www.polarsys.org/capella/core/modeller/7.0.0}Project at 0x7feced455dc0>
+        # <Element {http://www.polarsys.org/capella/core/modeller/7.0.0}Project at 0x7fecee0f6640>
+        # they do not pass "is" check but have the same IDs
+        for fragment, tree in self.trees.items():
+            if tree.root.attrib.get("id") == root.attrib.get("id"):
+                return (fragment, tree)
         raise ValueError("Element is not contained in any fragment")
 
     def _follow_href(self, element: etree._Element) -> etree._Element:
@@ -1345,11 +1459,7 @@ def __find_metadata(self) -> etree._Element:
         )
         if afm is None:
             raise RuntimeError("Cannot find .afm file in primary resource")
-        metadata = next(afm.root.iter(METADATA_TAG), None)
-        if metadata is None:
-            raise RuntimeError("Cannot find <Metadata> in primary .afm file")
-        LOGGER.debug("Found <Metadata> with ID %s", metadata.get("id"))
-        return metadata
+        return self.__get_metadata(afm)
 
     def referenced_viewpoints(self) -> cabc.Iterator[tuple[str, str]]:
         metadata = self.__find_metadata()

src/capellambse/metamodel/capellacore.py

@@ -77,6 +77,9 @@ class CapellaElement(
     features = m.Association["EnumerationPropertyLiteral"](
         (NS, "EnumerationPropertyLiteral"), "features"
     )
+    owned_traces = m.Containment["capellacommon.TransfoLink"](
+        "ownedTraces", (ns.CAPELLACOMMON, "TransfoLink")
+    )
 
 
 class NamedElement(

src/capellambse/metamodel/capellamodeller.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import capellambse.model as m
+from capellambse.metamodel import re
 
 from . import capellacore
 from . import namespaces as ns

src/capellambse/metamodel/information/datavalue.py

@@ -236,11 +236,11 @@ class AbstractExpressionValue(
 
 class BinaryExpression(AbstractExpressionValue):
     operator = m.EnumPOD("operator", BinaryOperator)
-    left_operand = m.Containment["DataValue"](
-        "ownedLeftOperand", (NS, "DataValue")
+    left_operand = m.Single["DataValue"](
+        m.Containment("ownedLeftOperand", (NS, "DataValue"))
     )
-    right_operand = m.Containment["DataValue"](
-        "ownedRightOperand", (NS, "DataValue")
+    right_operand = m.Single["DataValue"](
+        m.Containment("ownedRightOperand", (NS, "DataValue"))
     )
 
 

src/capellambse/metamodel/interaction.py

@@ -83,9 +83,11 @@ class SequenceMessage(capellacore.NamedElement):
     exchange_context = m.Association["capellacore.Constraint"](
         (ns.CAPELLACORE, "Constraint"), "exchangeContext"
     )
-    sending_end = m.Association["MessageEnd"]((NS, "MessageEnd"), "sendingEnd")
-    receiving_end = m.Association["MessageEnd"](
-        (NS, "MessageEnd"), "receivingEnd"
+    sending_end = m.Single(
+        m.Association["MessageEnd"]((NS, "MessageEnd"), "sendingEnd")
+    )
+    receiving_end = m.Single(
+        m.Association["MessageEnd"]((NS, "MessageEnd"), "receivingEnd")
     )
     exchanged_items = m.Association["information.ExchangeItem"](
         (ns.INFORMATION, "ExchangeItem"), "exchangedItems"
@@ -218,14 +220,13 @@ class _EventOperation(Event):
 
 
 class EventReceiptOperation(_EventOperation):
-    operation = m.Association["information.AbstractEventOperation"](
-        (ns.INFORMATION, "AbstractEventOperation"), "operation"
+    operation = m.Single(
+        m.Association["information.AbstractEventOperation"]((ns.INFORMATION, "AbstractEventOperation"), "operation")
     )
 
-
 class EventSentOperation(_EventOperation):
-    operation = m.Association["information.AbstractEventOperation"](
-        (ns.INFORMATION, "AbstractEventOperation"), "operation"
+    operation = m.Single(
+        m.Association["information.AbstractEventOperation"]((ns.INFORMATION, "AbstractEventOperation"), "operation")
     )
 
 

src/capellambse/metamodel/pa/__init__.py

@@ -181,7 +181,7 @@ class PhysicalFunction(fa.AbstractFunction):
         "realized_functions"
     )
     functions = m.Containment["fa.AbstractFunction"](
-        "ownedPhysicalComponents", (NS, "PhysicalComponent")
+        "ownedFunctions", (NS, "PhysicalFunction")
     )
     packages = m.Containment["PhysicalFunctionPkg"](
         "ownedPhysicalFunctionPkgs", (NS, "PhysicalFunctionPkg")

src/capellambse/metamodel/re.py

@@ -55,12 +55,16 @@ class GroupingElementPkg(CatalogElementPkg):
 
 
 class CatalogElementLink(ReAbstractElement):
-    source = m.Association["CatalogElement"]((NS, "CatalogElement"), "source")
-    target = m.Association["m.ModelElement"](
-        (ns.MODELLINGCORE, "ModelElement"), "target"
+    source = m.Single["CatalogElement"](
+        m.Association((NS, "CatalogElement"), "source")
     )
-    origin = m.Association["CatalogElementLink"](
-        (NS, "CatalogElementLink"), "origin"
+    target = m.Single["m.ModelElement"](
+        m.Association((ns.MODELLINGCORE, "ModelElement"), "target")
+    )
+    origin = m.Single(
+        m.Association["CatalogElementLink"](
+            (NS, "CatalogElementLink"), "origin"
+        )
     )
     unsynchronized_features = m.StringPOD("unsynchronizedFeatures")
     is_suffixed = m.BoolPOD("suffixed")
@@ -75,12 +79,18 @@ class CatalogElement(ReDescriptionElement, ReElementContainer):
     is_read_only = m.BoolPOD("readOnly")
     version = m.StringPOD("version")
     tags = m.StringPOD("tags")
-    origin = m.Association["CatalogElement"]((NS, "CatalogElement"), "origin")
-    current_compliancy = m.Association["CompliancyDefinition"](
-        (NS, "CompliancyDefinition"), "currentCompliancy"
+    origin = m.Single(
+        m.Association["CatalogElement"]((NS, "CatalogElement"), "origin")
+    )
+    current_compliancy = m.Single(
+        m.Association["CompliancyDefinition"](
+            (NS, "CompliancyDefinition"), "currentCompliancy"
+        )
     )
-    default_replica_compliancy = m.Association["CompliancyDefinition"](
-        (NS, "CompliancyDefinition"), "defaultReplicaCompliancy"
+    default_replica_compliancy = m.Single(
+        m.Association["CompliancyDefinition"](
+            (NS, "CompliancyDefinition"), "defaultReplicaCompliancy"
+        )
     )
     links = m.Containment["CatalogElementLink"](
         "ownedLinks", (NS, "CatalogElementLink")

src/capellambse/metamodel/sa.py

@@ -28,8 +28,8 @@ class SystemAnalysis(cs.ComponentArchitecture):
     component_pkg = m.Single["SystemComponentPkg"](
         m.Containment("ownedSystemComponentPkg", (NS, "SystemComponentPkg"))
     )
-    mission_pkg = m.Containment["MissionPkg"](
-        "ownedMissionPkg", (NS, "MissionPkg")
+    mission_pkg = m.Single["MissionPkg"](
+        m.Containment["MissionPkg"]("ownedMissionPkg", (NS, "MissionPkg"))
     )
     operational_analysis_realizations = m.Containment[
         "OperationalAnalysisRealization"

src/capellambse/model/_pods.py

@@ -495,7 +495,6 @@ def __setitem__(
             it = self._parent.iterchildren(self._tag)
             elems = list(itertools.islice(it, idx.start, idx.stop, idx.step))
             values = [i.text for i in elems]
-            values[idx] = value
             for e, v in zip(elems, values, strict=True):
                 e.text = v