Feature work schedule (#1419)

* ifcopenshell.api modules Persons and Organisations account for IFC4 SCHEMA CHANGE

* New Feature to manpiulate Work Plans

src/ifcopenshell-python/ifcopenshell/api/aggregate/assign_object.py

@@ -50,3 +50,4 @@ class Usecase:
                     "RelatingObject": self.settings["relating_object"],
                 }
             )
+        return is_decomposed_by

src/ifcopenshell-python/ifcopenshell/api/sequence/add_work_schedule.py

@@ -0,0 +1,47 @@
+import ifcopenshell.api
+import ifcopenshell.util.date
+from datetime import datetime
+
+
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"name": "Unnamed", "predefined_type": "NOTDEFINED", "start_time": datetime.now(), "work_plan":None}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        work_schedule = ifcopenshell.api.run(
+            "root.create_entity",
+            self.file,
+            ifc_class="IfcWorkSchedule",
+            predefined_type=self.settings["predefined_type"],
+            name=self.settings["name"],
+        )
+        work_schedule.CreationDate = ifcopenshell.util.date.datetime2ifc(datetime.now(), "IfcDateTime")
+        person = ifcopenshell.api.owner.settings.get_person(self.file)
+        if person:
+            work_schedule.Creators = [person]
+        work_schedule.StartTime = ifcopenshell.util.date.datetime2ifc(self.settings["start_time"], "IfcDateTime")
+        
+        if self.settings["work_plan"]:
+            rel_aggregates = ifcopenshell.api.run("aggregate.assign_object", self.file, **{
+                "product": work_schedule,
+                "relating_object": self.settings["work_plan"]
+            })
+        else:
+            context = self.file.by_type("IfcContext")[0]
+            if context.Declares:
+                rel_declares = context.Declares[0]
+                ifcopenshell.api.run("owner.update_owner_history", self.file, element=rel_declares)
+            else:
+                rel_declares = self.file.create_entity("IfcRelDeclares", **{
+                    "GlobalId": ifcopenshell.guid.new(),
+                    "OwnerHistory": ifcopenshell.api.run("owner.create_owner_history", self.file),
+                    "RelatingContext": context
+                })
+            related_definitions = list(rel_declares.RelatedDefinitions or [])
+            related_definitions.append(work_schedule)
+            rel_declares.RelatedDefinitions = related_definitions
+
+        return work_schedule

src/ifcopenshell-python/ifcopenshell/api/sequence/assign_workplan.py

@@ -0,0 +1,31 @@
+import ifcopenshell
+import ifcopenshell.api
+
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {
+            "work_schedule": None,
+            "work_plan":None,
+        }
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        ###Project declaration should be removed if the workschedule is assigned to a project.####
+        if self.settings["work_schedule"].HasContext:
+            rel_declares = self.settings["work_schedule"].HasContext[0]
+            related_definitions = list(rel_declares.RelatedDefinitions)
+            related_definitions.remove(self.settings["work_schedule"])
+            rel_declares.RelatedDefinitions = related_definitions
+        if self.settings["work_plan"].IsDecomposedBy:
+            rel_aggregates = self.settings["work_plan"].IsDecomposedBy[0]
+            related_objects = list(rel_aggregates.RelatedObjects or [])
+            related_objects.append(self.settings["work_schedule"])
+            rel_aggregates.RelatedObjects = related_objects
+        else:             
+            rel_aggregates = ifcopenshell.api.run("aggregate.assign_object", self.file, **{
+                "product": self.settings["work_schedule"],
+                "relating_object": self.settings["work_plan"]
+            })
+        return rel_aggregates

src/ifcopenshell-python/ifcopenshell/api/sequence/edit_work_schedule.py

@@ -0,0 +1,13 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {
+            "work_schedule": 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["work_schedule"], name, value)

src/ifcopenshell-python/ifcopenshell/api/sequence/remove_work_schedule.py

@@ -0,0 +1,14 @@
+class Usecase:
+    def __init__(self, file, **settings):
+        self.file = file
+        self.settings = {"work_schedule": None}
+        for key, value in settings.items():
+            self.settings[key] = value
+
+    def execute(self):
+        # TODO: do a deep purge
+        if self.settings["work_schedule"].HasContext:
+            rel_declares = self.settings["work_schedule"].HasContext[0]
+            if len(rel_declares.RelatedDefinitions) == 1:
+                self.file.remove(rel_declares)
+        self.file.remove(self.settings["work_schedule"])