armodel 1.8.7__py3-none-any.whl → 1.9.1__py3-none-any.whl

armodel/report/connector_xls_report.py

@@ -1,78 +1,77 @@
-from ..models.M2.AUTOSARTemplates.SWComponentTemplate.Components import CompositionSwComponentType
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.ARPackage import ARPackage
-from .excel_report import ExcelReporter
-from ..models import AUTOSAR
-from ..models import PPortInCompositionInstanceRef, RPortInCompositionInstanceRef
-from typing import List
-
-class ConnectorXlsReport(ExcelReporter):
-    def __init__(self) -> None:
-        super().__init__()
-        self.swcs = []              # type: List[CompositionSwComponentType]
-
-    def _parse_pkg(self, parent: ARPackage):
-        for pkg in parent.getARPackages():
-            self._parse_pkg(pkg)
-        for swc in parent.getSwComponentTypes():
-            self.swcs.append(swc)
-
-    def import_data(self, document: AUTOSAR):
-        for pkg in document.getARPackages():
-            self._parse_pkg(pkg)
-
-    def _write_assembly_sw_connection(self, swc: CompositionSwComponentType, index = 0):
-        sheet = self.wb.create_sheet("%s - AC" % swc.short_name, index)
-        title_row = ["Short Name", "Provide SW-C", "PPort", "Request SW-C", "RPort"]
-        self.write_title_row(sheet, title_row)
-
-        row = 2
-        for connector in swc.getAssemblySwConnectors():
-            self._logger.debug("Write AssemblySwConnection %s" % connector.short_name)
-            self.write_cell(sheet, row, 1, connector.short_name)
-            self.write_cell(sheet, row, 2, connector.provider_iref.context_component_ref.value)
-            self.write_cell(sheet, row, 3, connector.provider_iref.target_p_port_ref.value)
-            self.write_cell(sheet, row, 4, connector.requester_iref.context_component_ref.value)
-            self.write_cell(sheet, row, 5, connector.requester_iref.target_r_port_ref.value)
-            row += 1
-
-        self.auto_width(sheet)
-
-    def _write_delegation_sw_connection(self, swc: CompositionSwComponentType, index = 0):
-        sheet = self.wb.create_sheet("%s - DC" % swc.short_name, index)
-        title_row = ["Short Name", "Inner SW-C", "Inner PPort", "Outer PPort", "Inner RPort", "Outer RPort"]
-        self.write_title_row(sheet, title_row)
-
-        row = 2
-        for connector in swc.getDelegationSwConnectors():
-            self._logger.debug("Write DelegationSwConnection %s" % connector.short_name)
-            self.write_cell(sheet, row, 1, connector.short_name)
-
-            if connector.inner_port_iref:
-                if isinstance(connector.inner_port_iref, PPortInCompositionInstanceRef):
-                    self.write_cell(sheet, row, 2, connector.inner_port_iref.context_component_ref.value)
-                    self.write_cell(sheet, row, 3, connector.inner_port_iref.target_p_port_ref.value)
-                elif isinstance(connector.inner_port_iref, RPortInCompositionInstanceRef):
-                    self.write_cell(sheet, row, 2, connector.inner_port_iref.context_component_ref.value)
-                    self.write_cell(sheet, row, 5, connector.inner_port_iref.target_r_port_ref.value)
-
-            if connector.outer_port_ref.dest == "P-PORT-PROTOTYPE":
-                self.write_cell(sheet, row, 4, connector.outer_port_ref.value)
-            elif connector.outer_port_ref.dest == "R-PORT-PROTOTYPE":
-                self.write_cell(sheet, row, 6, connector.outer_port_ref.value)
-            else:
-                raise ValueError("Invalid OUTER-PORT-REF of SwConnector <%s>" % connector.short_name)
-            row += 1
-
-        self.auto_width(sheet)
-
-    def write(self, filename: str):
-        swc_list = filter(lambda o: isinstance(o, CompositionSwComponentType), self.swcs)
-        
-        idx = 1
-        for swc in sorted(swc_list, key = lambda o: o.short_name):
-            self._logger.info("CompositionSwComponentType %s" % swc.short_name)
-            self._write_assembly_sw_connection(swc, idx)
-            self._write_delegation_sw_connection(swc, idx + 1)
-            idx += 2
-
+from armodel.models.M2.AUTOSARTemplates.SWComponentTemplate.Composition import CompositionSwComponentType
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.ARPackage import ARPackage
+from armodel.models.M2.AUTOSARTemplates.excel_report import ExcelReporter
+from armodel.models import AUTOSAR
+from armodel.models import PPortInCompositionInstanceRef, RPortInCompositionInstanceRef
+
+class ConnectorXlsReport(ExcelReporter):
+    def __init__(self) -> None:
+        super().__init__()
+        self.swcs = []              # type: List[CompositionSwComponentType]
+
+    def _parse_pkg(self, parent: ARPackage):
+        for pkg in parent.getARPackages():
+            self._parse_pkg(pkg)
+        for swc in parent.getSwComponentTypes():
+            self.swcs.append(swc)
+
+    def import_data(self, document: AUTOSAR):
+        for pkg in document.getARPackages():
+            self._parse_pkg(pkg)
+
+    def _write_assembly_sw_connection(self, swc: CompositionSwComponentType, index = 0):
+        sheet = self.wb.create_sheet("%s - AC" % swc.short_name, index)
+        title_row = ["Short Name", "Provide SW-C", "PPort", "Request SW-C", "RPort"]
+        self.write_title_row(sheet, title_row)
+
+        row = 2
+        for connector in swc.getAssemblySwConnectors():
+            self._logger.debug("Write AssemblySwConnection %s" % connector.short_name)
+            self.write_cell(sheet, row, 1, connector.short_name)
+            self.write_cell(sheet, row, 2, connector.provider_iref.context_component_ref.value)
+            self.write_cell(sheet, row, 3, connector.provider_iref.target_p_port_ref.value)
+            self.write_cell(sheet, row, 4, connector.requester_iref.context_component_ref.value)
+            self.write_cell(sheet, row, 5, connector.requester_iref.target_r_port_ref.value)
+            row += 1
+
+        self.auto_width(sheet)
+
+    def _write_delegation_sw_connection(self, swc: CompositionSwComponentType, index = 0):
+        sheet = self.wb.create_sheet("%s - DC" % swc.short_name, index)
+        title_row = ["Short Name", "Inner SW-C", "Inner PPort", "Outer PPort", "Inner RPort", "Outer RPort"]
+        self.write_title_row(sheet, title_row)
+
+        row = 2
+        for connector in swc.getDelegationSwConnectors():
+            self._logger.debug("Write DelegationSwConnection %s" % connector.short_name)
+            self.write_cell(sheet, row, 1, connector.short_name)
+
+            if connector.inner_port_iref:
+                if isinstance(connector.inner_port_iref, PPortInCompositionInstanceRef):
+                    self.write_cell(sheet, row, 2, connector.inner_port_iref.context_component_ref.value)
+                    self.write_cell(sheet, row, 3, connector.inner_port_iref.target_p_port_ref.value)
+                elif isinstance(connector.inner_port_iref, RPortInCompositionInstanceRef):
+                    self.write_cell(sheet, row, 2, connector.inner_port_iref.context_component_ref.value)
+                    self.write_cell(sheet, row, 5, connector.inner_port_iref.target_r_port_ref.value)
+
+            if connector.outer_port_ref.dest == "P-PORT-PROTOTYPE":
+                self.write_cell(sheet, row, 4, connector.outer_port_ref.value)
+            elif connector.outer_port_ref.dest == "R-PORT-PROTOTYPE":
+                self.write_cell(sheet, row, 6, connector.outer_port_ref.value)
+            else:
+                raise ValueError("Invalid OUTER-PORT-REF of SwConnector <%s>" % connector.short_name)
+            row += 1
+
+        self.auto_width(sheet)
+
+    def write(self, filename: str):
+        swc_list = filter(lambda o: isinstance(o, CompositionSwComponentType), self.swcs)
+        
+        idx = 1
+        for swc in sorted(swc_list, key = lambda o: o.short_name):
+            self._logger.info("CompositionSwComponentType %s" % swc.short_name)
+            self._write_assembly_sw_connection(swc, idx)
+            self._write_delegation_sw_connection(swc, idx + 1)
+            idx += 2
+
         self.wb.save(filename)

armodel/report/excel_report.py

@@ -1,42 +1,42 @@
-from openpyxl import Workbook
-
-import logging
-
-class ExcelReporter:
-    def __init__(self) -> None:
-        self.wb = Workbook()
-        self._logger = logging.getLogger()
-    
-    def write_revision(self):
-        sheet = self.wb['Sheet']
-        sheet.title = "History"
-
-        title_rows = ["When", "Who", "Version", "History"]
-        self.write_title_row(sheet, title_rows)
-
-    def auto_width(self, worksheet):
-        dims = {}
-        for row in worksheet.rows:
-            for cell in row:
-                if cell.value:
-                    dims[cell.column_letter] = max((dims.get(cell.column_letter, 0), len(str(cell.value))))
-
-        for col, value in dims.items():
-            worksheet.column_dimensions[col].width = (value + 2) + 2
-
-    def write_title_row(self, sheet, title_row):
-        for idx in range(0, len(title_row)):
-            cell = sheet.cell(row=1, column=idx + 1)
-            cell.value = title_row[idx]
-
-    def write_cell(self, sheet, row, column, value, format = None):
-        cell = sheet.cell(row = row, column=column) 
-        cell.value = value
-        if (format != None):
-            if ('alignment' in format):
-                cell.alignment = format['alignment']
-            if ('number_format' in format):
-                cell.number_format = format['number_format']
-
-    def save(self, name: str):
+from openpyxl import Workbook
+
+import logging
+
+class ExcelReporter:
+    def __init__(self) -> None:
+        self.wb = Workbook()
+        self._logger = logging.getLogger()
+    
+    def write_revision(self):
+        sheet = self.wb['Sheet']
+        sheet.title = "History"
+
+        title_rows = ["When", "Who", "Version", "History"]
+        self.write_title_row(sheet, title_rows)
+
+    def auto_width(self, worksheet):
+        dims = {}
+        for row in worksheet.rows:
+            for cell in row:
+                if cell.value:
+                    dims[cell.column_letter] = max((dims.get(cell.column_letter, 0), len(str(cell.value))))
+
+        for col, value in dims.items():
+            worksheet.column_dimensions[col].width = (value + 2) + 2
+
+    def write_title_row(self, sheet, title_row):
+        for idx in range(0, len(title_row)):
+            cell = sheet.cell(row=1, column=idx + 1)
+            cell.value = title_row[idx]
+
+    def write_cell(self, sheet, row, column, value, format = None):
+        cell = sheet.cell(row = row, column=column) 
+        cell.value = value
+        if (format != None):
+            if ('alignment' in format):
+                cell.alignment = format['alignment']
+            if ('number_format' in format):
+                cell.number_format = format['number_format']
+
+    def save(self, name: str):
         self.wb.save(name)

armodel/transformer/abstract.py

@@ -1,6 +1,6 @@
-class AbstractTransformer():
-    def __init__(self):
-        pass
-
-    def remove(self):
-        pass
+class AbstractTransformer():
+    def __init__(self):
+        pass
+
+    def remove(self):
+        pass

armodel/transformer/admin_data.py

@@ -1,31 +1,31 @@
-import logging
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.ARPackage import ARPackage
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.Identifiable import Describable, Identifiable
-from ..models.M2.AUTOSARTemplates.AutosarTopLevelStructure import AUTOSAR
-from ..transformer.abstract import AbstractTransformer
-
-
-class AdminDataTransformer(AbstractTransformer):
-    def __init__(self):
-        super().__init__()
-        self.logger = logging.getLogger()
-
-    def process_pkg(self, pkg: ARPackage):
-        for sub_package in pkg.getARPackages():
-            self.process_pkg(sub_package)
-
-        self.logger.debug("Remove AdminData of <%s>", pkg.getShortName())
-        pkg.removeAdminData()
-
-        for element in pkg.getElements():
-            if isinstance(element, Describable):
-                self.logger.debug("Remove AdminData of <%s>", element.getShortName())
-                element.removeAdminData()
-            elif isinstance(element, Identifiable):
-                self.logger.debug("Remove AdminData of <%s>", element.getShortName())
-                element.removeAdminData()
-
-    def remove(self, root: AUTOSAR):
-        root.removeAdminData()
-        for pkg in root.getARPackages():
-            self.process_pkg(pkg)
+import logging
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.ARPackage import ARPackage
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.Identifiable import Describable, Identifiable
+from armodel.models.M2.AUTOSARTemplates.AutosarTopLevelStructure import AUTOSAR
+from armodel.transformer.abstract import AbstractTransformer
+
+
+class AdminDataTransformer(AbstractTransformer):
+    def __init__(self):
+        super().__init__()
+        self.logger = logging.getLogger()
+
+    def process_pkg(self, pkg: ARPackage):
+        for sub_package in pkg.getARPackages():
+            self.process_pkg(sub_package)
+
+        self.logger.debug("Remove AdminData of <%s>", pkg.getShortName())
+        pkg.removeAdminData()
+
+        for element in pkg.getElements():
+            if isinstance(element, Describable):
+                self.logger.debug("Remove AdminData of <%s>", element.getShortName())
+                element.removeAdminData()
+            elif isinstance(element, Identifiable):
+                self.logger.debug("Remove AdminData of <%s>", element.getShortName())
+                element.removeAdminData()
+
+    def remove(self, root: AUTOSAR):
+        root.removeAdminData()
+        for pkg in root.getARPackages():
+            self.process_pkg(pkg)

armodel/writer/__init__.py

@@ -1 +1 @@
-from .arxml_writer import ARXMLWriter
+from armodel.writer.arxml_writer import ARXMLWriter

armodel/writer/abstract_arxml_writer.py

@@ -1,147 +1,146 @@
-import sys
-from abc import ABCMeta
-import re
-from xml.dom import minidom
-from colorama import Fore
-
-import logging
-import xml.etree.cElementTree as ET
-
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.ArObject import ARObject
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.PrimitiveTypes import ARFloat, ARLiteral, ARNumerical, DateTime, Integer
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.PrimitiveTypes import RevisionLabelString, TimeValue
-from ..models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.PrimitiveTypes import RefType, ARBoolean
-
-
-class AbstractARXMLWriter:
-    __metaclass__ = ABCMeta
-     
-    def __init__(self, options=None) -> None:
-        if type(self) is AbstractARXMLWriter:
-            raise NotImplementedError("AbstractARXMLWriter is an abstract class.")
-        
-        self.options = {}
-        self.options['warning'] = False
-        self.options['version'] = "4.2.2"
-        self.logger = logging.getLogger()
-        
-        self._processOptions(options=options)
-
-        self.nsmap = {
-            "xmlns": "http://autosar.org/schema/r4.0",
-        }
-
-    def _processOptions(self, options):
-        if options:
-            if 'warning' in options:
-                self.options['warning'] = options['warning']
-
-    def _raiseError(self, error_msg):
-        if (self.options['warning'] is True):
-            self.logger.error(Fore.RED + error_msg + Fore.WHITE)
-        else:
-            raise ValueError(error_msg)
-        
-    def notImplemented(self, error_msg):
-        if (self.options['warning'] is True):
-            self.logger.error(Fore.RED + error_msg + Fore.WHITE)
-        else:
-            raise NotImplementedError(error_msg)
-        
-    def writeARObjectAttributes(self, element: ET.Element, ar_obj: ARObject):
-        if ar_obj.timestamp is not None:
-            # self.logger.debug("Timestamp: %s" % ar_obj.timestamp)
-            element.attrib['T'] = ar_obj.timestamp
-        if ar_obj.uuid is not None:
-            # self.logger.debug("UUID: %s" % ar_obj.uuid)
-            element.attrib['UUID'] = ar_obj.uuid
-
-    '''
-    def setChildElementOptionalValue(self, element: ET.Element, key: str, value: str):
-        if value is not None:
-            child_element = ET.SubElement(element, key)
-            child_element.text = value
-    '''
-
-    '''
-    def setChildElementOptionalNumberValue(self, element: ET.Element, key: str, value: str):
-        if value is not None:
-            child_element = ET.SubElement(element, key)
-            child_element.text = str(value)
-    '''
-
-    def setChildElementOptionalNumericalValue(self, element: ET.Element, key: str, numerical: ARNumerical):
-        if numerical is not None:
-            child_element = ET.SubElement(element, key)
-            self.writeARObjectAttributes(child_element, numerical)
-            if numerical.getShortLabel() is not None:
-                child_element.attrib["SHORT-LABEL"] = numerical.getShortLabel()
-            child_element.text = numerical._text
-
-    def setChildElementOptionalIntegerValue(self, element: ET.Element, key: str, value: Integer):
-        self.setChildElementOptionalNumericalValue(element, key, value)
-
-    def setChildElementOptionalPositiveInteger(self, element: ET.Element, key: str, value: Integer):
-        self.setChildElementOptionalNumericalValue(element, key, value)
-    
-    def setChildElementOptionalRevisionLabelString(self, element: ET.Element, key: str, literal: RevisionLabelString):
-        self.setChildElementOptionalLiteral(element, key, literal)
-
-    def setChildElementOptionalDataTime(self, element: ET.Element, key: str, literal: DateTime):
-        self.setChildElementOptionalLiteral(element, key, literal)
-
-    def setChildElementOptionalRefType(self, parent: ET.Element, child_tag_name: str, ref: RefType):
-        if ref is not None:
-            child_tag = ET.SubElement(parent, child_tag_name)
-            base = ref.getBase()
-            if base is not None:
-                child_tag.attrib['BASE'] = base
-            dest = ref.getDest()
-            if dest is not None:
-                child_tag.attrib['DEST'] = dest
-            if ref.value is not None:
-                child_tag.text = ref.value
-
-    def setChildElementOptionalFloatValue(self, element: ET.Element, key: str, value: ARFloat):
-        if value is not None:
-            child_element = ET.SubElement(element, key)
-            self.writeARObjectAttributes(child_element, value)
-            child_element.text = value.getText()
-
-    def setChildElementOptionalTimeValue(self, element: ET.Element, key: str, value: TimeValue):
-        self.setChildElementOptionalFloatValue(element, key, value)
-
-    def setChildElementOptionalBooleanValue(self, element: ET.Element, key: str, value: ARBoolean) -> ET.Element:
-        if value is not None:
-            child_element = ET.SubElement(element, key)
-            self.writeARObjectAttributes(child_element, value)
-            child_element.text = value.getText()
-        return element
-
-    def setChildElementOptionalLiteral(self, element: ET.Element, key: str, value: ARLiteral) -> ET.Element:
-        if value is not None:
-            child_element = ET.SubElement(element, key)
-            self.writeARObjectAttributes(child_element, value)
-            child_element.text = value.getText()
-        return element
-    
-    def patch_xml(self, xml: str) -> str:
-        xml = re.sub(r"\<([\w-]+)\/\>", r"<\1></\1>", xml)
-        # xml = re.sub(r"<([\w-]+)\s+(\w+)=(\"[\w-]+\")\/>", r"<\1 \2=\3></\1>", xml)
-        # xml = re.sub(r"&quot;", '"', xml)
-        return xml
-
-    def saveToFile(self, filename, root: ET.Element):
-        if sys.version_info <= (3, 9):
-            xml = ET.tostring(root, encoding="UTF-8", short_empty_elements=False)
-        else:
-            xml = ET.tostring(root, encoding="UTF-8", xml_declaration=True, short_empty_elements=False)
-        
-        dom = minidom.parseString(xml.decode())
-        xml = dom.toprettyxml(indent="  ", encoding="UTF-8")
-
-        text = self.patch_xml(xml.decode())
-    
-        with open(filename, "w", encoding="utf-8") as f_out:
-            # f_out.write(xml.decode())
-            f_out.write(text)
+import sys
+from abc import ABC
+import re
+from xml.dom import minidom
+from colorama import Fore
+
+import logging
+import xml.etree.cElementTree as ET
+
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.ArObject import ARObject
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.PrimitiveTypes import ARFloat, ARLiteral, ARNumerical, DateTime, Integer
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.PrimitiveTypes import RevisionLabelString, TimeValue
+from armodel.models.M2.AUTOSARTemplates.GenericStructure.GeneralTemplateClasses.PrimitiveTypes import RefType, ARBoolean
+
+
+class AbstractARXMLWriter(ABC):
+
+    def __init__(self, options=None) -> None:
+        if type(self) is AbstractARXMLWriter:
+            raise TypeError("AbstractARXMLWriter is an abstract class.")
+        
+        self.options = {}
+        self.options['warning'] = False
+        self.options['version'] = "4.2.2"
+        self.logger = logging.getLogger()
+        
+        self._processOptions(options=options)
+
+        self.nsmap = {
+            "xmlns": "http://autosar.org/schema/r4.0",
+        }
+
+    def _processOptions(self, options):
+        if options:
+            if 'warning' in options:
+                self.options['warning'] = options['warning']
+
+    def _raiseError(self, error_msg):
+        if (self.options['warning'] is True):
+            self.logger.error(Fore.RED + error_msg + Fore.WHITE)
+        else:
+            raise ValueError(error_msg)
+        
+    def notImplemented(self, error_msg):
+        if (self.options['warning'] is True):
+            self.logger.error(Fore.RED + error_msg + Fore.WHITE)
+        else:
+            raise NotImplementedError(error_msg)
+        
+    def writeARObjectAttributes(self, element: ET.Element, ar_obj: ARObject):
+        if ar_obj.timestamp is not None:
+            # self.logger.debug("Timestamp: %s" % ar_obj.timestamp)
+            element.attrib['T'] = ar_obj.timestamp
+        if ar_obj.uuid is not None:
+            # self.logger.debug("UUID: %s" % ar_obj.uuid)
+            element.attrib['UUID'] = ar_obj.uuid
+
+    '''
+    def setChildElementOptionalValue(self, element: ET.Element, key: str, value: str):
+        if value is not None:
+            child_element = ET.SubElement(element, key)
+            child_element.text = value
+    '''
+
+    '''
+    def setChildElementOptionalNumberValue(self, element: ET.Element, key: str, value: str):
+        if value is not None:
+            child_element = ET.SubElement(element, key)
+            child_element.text = str(value)
+    '''
+
+    def setChildElementOptionalNumericalValue(self, element: ET.Element, key: str, numerical: ARNumerical):
+        if numerical is not None:
+            child_element = ET.SubElement(element, key)
+            self.writeARObjectAttributes(child_element, numerical)
+            if numerical.getShortLabel() is not None:
+                child_element.attrib["SHORT-LABEL"] = numerical.getShortLabel()
+            child_element.text = numerical._text
+
+    def setChildElementOptionalIntegerValue(self, element: ET.Element, key: str, value: Integer):
+        self.setChildElementOptionalNumericalValue(element, key, value)
+
+    def setChildElementOptionalPositiveInteger(self, element: ET.Element, key: str, value: Integer):
+        self.setChildElementOptionalNumericalValue(element, key, value)
+    
+    def setChildElementOptionalRevisionLabelString(self, element: ET.Element, key: str, literal: RevisionLabelString):
+        self.setChildElementOptionalLiteral(element, key, literal)
+
+    def setChildElementOptionalDataTime(self, element: ET.Element, key: str, literal: DateTime):
+        self.setChildElementOptionalLiteral(element, key, literal)
+
+    def setChildElementOptionalRefType(self, parent: ET.Element, child_tag_name: str, ref: RefType):
+        if ref is not None:
+            child_tag = ET.SubElement(parent, child_tag_name)
+            base = ref.getBase()
+            if base is not None:
+                child_tag.attrib['BASE'] = base
+            dest = ref.getDest()
+            if dest is not None:
+                child_tag.attrib['DEST'] = dest
+            if ref.value is not None:
+                child_tag.text = ref.value
+
+    def setChildElementOptionalFloatValue(self, element: ET.Element, key: str, value: ARFloat):
+        if value is not None:
+            child_element = ET.SubElement(element, key)
+            self.writeARObjectAttributes(child_element, value)
+            child_element.text = value.getText()
+
+    def setChildElementOptionalTimeValue(self, element: ET.Element, key: str, value: TimeValue):
+        self.setChildElementOptionalFloatValue(element, key, value)
+
+    def setChildElementOptionalBooleanValue(self, element: ET.Element, key: str, value: ARBoolean) -> ET.Element:
+        if value is not None:
+            child_element = ET.SubElement(element, key)
+            self.writeARObjectAttributes(child_element, value)
+            child_element.text = value.getText()
+        return element
+
+    def setChildElementOptionalLiteral(self, element: ET.Element, key: str, value: ARLiteral) -> ET.Element:
+        if value is not None:
+            child_element = ET.SubElement(element, key)
+            self.writeARObjectAttributes(child_element, value)
+            child_element.text = value.getText()
+        return element
+    
+    def patch_xml(self, xml: str) -> str:
+        xml = re.sub(r"\<([\w-]+)\/\>", r"<\1></\1>", xml)
+        # xml = re.sub(r"<([\w-]+)\s+(\w+)=(\"[\w-]+\")\/>", r"<\1 \2=\3></\1>", xml)
+        # xml = re.sub(r"&quot;", '"', xml)
+        return xml
+
+    def saveToFile(self, filename, root: ET.Element):
+        if sys.version_info <= (3, 9):
+            xml = ET.tostring(root, encoding="UTF-8", short_empty_elements=False)
+        else:
+            xml = ET.tostring(root, encoding="UTF-8", xml_declaration=True, short_empty_elements=False)
+        
+        dom = minidom.parseString(xml.decode())
+        xml = dom.toprettyxml(indent="  ", encoding="UTF-8")
+
+        text = self.patch_xml(xml.decode())
+    
+        with open(filename, "w", encoding="utf-8") as f_out:
+            # f_out.write(xml.decode())
+            f_out.write(text)