Implement assign and unassign ports in IfcOpenShell API

src/ifcopenshell-python/test/api/system/test_assign_port.py

@@ -0,0 +1,43 @@
+# IfcOpenShell - IFC toolkit and geometry engine
+# Copyright (C) 2022 Dion Moult <dion@thinkmoult.com>
+#
+# This file is part of IfcOpenShell.
+#
+# IfcOpenShell is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# IfcOpenShell is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with IfcOpenShell.  If not, see <http://www.gnu.org/licenses/>.
+
+import test.bootstrap
+import ifcopenshell.api
+import ifcopenshell.util.system
+
+
+class TestAssignPort(test.bootstrap.IFC4):
+    def test_assigning_a_port_once_only(self):
+        port = self.file.createIfcDistributionPort()
+        element = ifcopenshell.api.run("root.create_entity", self.file, ifc_class="IfcChiller")
+        ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
+        assert element.IsNestedBy[0].RelatedObjects == (port,)
+        assert ifcopenshell.util.system.get_ports(element) == [port]
+        ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
+        assert ifcopenshell.util.system.get_ports(element) == [port]
+
+
+class TestAssignPortIFC2X3(test.bootstrap.IFC2X3):
+    def test_assigning_a_port_once_only(self):
+        port = self.file.createIfcDistributionPort()
+        element = ifcopenshell.api.run("root.create_entity", self.file, ifc_class="IfcFlowSegment")
+        ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
+        assert element.HasPorts[0].RelatingPort == port
+        assert ifcopenshell.util.system.get_ports(element) == [port]
+        ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
+        assert ifcopenshell.util.system.get_ports(element) == [port]

src/ifcopenshell-python/test/api/system/test_unassign_port.py

@@ -0,0 +1,39 @@
+# IfcOpenShell - IFC toolkit and geometry engine
+# Copyright (C) 2022 Dion Moult <dion@thinkmoult.com>
+#
+# This file is part of IfcOpenShell.
+#
+# IfcOpenShell is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# IfcOpenShell is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with IfcOpenShell.  If not, see <http://www.gnu.org/licenses/>.
+
+import test.bootstrap
+import ifcopenshell.api
+import ifcopenshell.util.system
+
+
+class TestAssignPort(test.bootstrap.IFC4):
+    def test_assigning_a_port_once_only(self):
+        port = self.file.createIfcDistributionPort()
+        element = ifcopenshell.api.run("root.create_entity", self.file, ifc_class="IfcChiller")
+        ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
+        ifcopenshell.api.run("system.unassign_port", self.file, element=element, port=port)
+        assert ifcopenshell.util.system.get_ports(element) == []
+
+
+class TestAssignPortIFC2X3(test.bootstrap.IFC2X3):
+    def test_assigning_a_port_once_only(self):
+        port = self.file.createIfcDistributionPort()
+        element = ifcopenshell.api.run("root.create_entity", self.file, ifc_class="IfcFlowSegment")
+        ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
+        ifcopenshell.api.run("system.unassign_port", self.file, element=element, port=port)
+        assert ifcopenshell.util.system.get_ports(element) == []