A whole bunch of new usecases for managing IFC library information and references

src/ifcopenshell-python/ifcopenshell/api/library/assign_reference.py

@@ -0,0 +1,34 @@
+import ifcopenshell
+
+
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {
+            "product": None,
+            "reference": None,
+        }
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        rels = self.settings["reference"].LibraryRefForObjects
+        if not rels:
+            return self.file.create_entity(
+                "IfcRelAssociatesLibrary",
+                GlobalId=ifcopenshell.guid.new(),
+                OwnerHistory=ifcopenshell.api.run("owner.create_owner_history", self.file),
+                RelatedObjects=[self.settings["product"]],
+                RelatingLibrary=self.settings["reference"],
+            )
+
+        for rel in rels:
+            if self.settings["product"] in rel.RelatedObjects:
+                return rel
+
+        rel = rels[0]
+        related_objects = list(rel.RelatedObjects)
+        related_objects.append(self.settings["product"])
+        rel.RelatedObjects = related_objects
+        ifcopenshell.api.run("owner.update_owner_history", self.file, element=rel)
+        return rel