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

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

@@ -0,0 +1,14 @@
+import ifcopenshell
+import ifcopenshell.util.schema
+import ifcopenshell.util.date
+
+
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"name": None}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        return self.file.create_entity("IfcLibraryInformation", Name=self.settings["name"])

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

@@ -0,0 +1,14 @@
+import ifcopenshell
+
+
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {
+            "library": None,
+        }
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        return self.file.createIfcLibraryReference(ReferencedLibrary=self.settings["library"])

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

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

@@ -0,0 +1,10 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"library": None, "attributes": {}}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        for name, value in self.settings["attributes"].items():
+            setattr(self.settings["library"], name, value)

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

@@ -0,0 +1,10 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"reference": None, "attributes": {}}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        for name, value in self.settings["attributes"].items():
+            setattr(self.settings["reference"], name, value)

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

@@ -0,0 +1,14 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"library": None}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        for reference in set(self.settings["library"].HasLibraryReferences or []):
+            self.file.remove(reference)
+        self.file.remove(self.settings["library"])
+        for rel in self.file.by_type("IfcRelAssociatesLibrary"):
+            if not rel.RelatingLibrary:
+                self.file.remove(rel)

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

@@ -0,0 +1,11 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"reference": None}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        for rel in self.settings["reference"].LibraryRefForObjects:
+            self.file.remove(rel)
+        self.file.remove(self.settings["reference"])

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

@@ -0,0 +1,19 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"reference": None, "product": None}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        rels = self.settings["reference"].LibraryRefForObjects
+        if not rels:
+            return
+        for rel in rels:
+            if self.settings["product"] in rel.RelatedObjects:
+                if len(rel.RelatedObjects) == 1:
+                    self.file.remove(rel)
+                    continue
+                related_objects = list(rel.RelatedObjects)
+                related_objects.remove(self.settings["product"])
+                rel.RelatedObjects = related_objects