Source code for pyEDAA.IPXACT.Design

# ==================================================================================================================== #
#              _____ ____    _        _      ___ ______  __    _    ____ _____                                         #
#  _ __  _   _| ____|  _ \  / \      / \    |_ _|  _ \ \/ /   / \  / ___|_   _|                                        #
# | '_ \| | | |  _| | | | |/ _ \    / _ \    | || |_) \  /   / _ \| |     | |                                          #
# | |_) | |_| | |___| |_| / ___ \  / ___ \ _ | ||  __//  \  / ___ \ |___  | |                                          #
# | .__/ \__, |_____|____/_/   \_\/_/   \_(_)___|_|  /_/\_\/_/   \_\____| |_|                                          #
# |_|    |___/                                                                                                         #
# ==================================================================================================================== #
# Authors:                                                                                                             #
#   Patrick Lehmann                                                                                                    #
#                                                                                                                      #
# License:                                                                                                             #
# ==================================================================================================================== #
# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
# Copyright 2016-2016 Patrick Lehmann - Dresden, Germany                                                               #
#                                                                                                                      #
# Licensed under the Apache License, Version 2.0 (the "License");                                                      #
# you may not use this file except in compliance with the License.                                                     #
# You may obtain a copy of the License at                                                                              #
#                                                                                                                      #
#   http://www.apache.org/licenses/LICENSE-2.0                                                                         #
#                                                                                                                      #
# Unless required by applicable law or agreed to in writing, software                                                  #
# distributed under the License is distributed on an "AS IS" BASIS,                                                    #
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.                                             #
# See the License for the specific language governing permissions and                                                  #
# limitations under the License.                                                                                       #
#                                                                                                                      #
# SPDX-License-Identifier: Apache-2.0                                                                                  #
# ==================================================================================================================== #
#
from pathlib              import Path
from sys                  import version_info
from textwrap             import dedent
from typing               import List, ClassVar, Optional as Nullable

from lxml.etree           import _Element, QName
from pyTooling.Decorators import export
from pyTooling.Common     import getFullyQualifiedName

from pyEDAA.IPXACT        import RootElement, __DEFAULT_SCHEMA__, VLNV, IPXACTSchema, Element, IPXACTException


[docs] @export class Design(RootElement): """Represents an IP-XACT design.""" _rootTagName: ClassVar[str] = "design" _componentInstances: List _interconnections: List _adHocConnections: List
[docs] def __init__( self, designFile: Nullable[Path] = None, parse: bool = False, vlnv: Nullable[VLNV] = None, description: Nullable[str] = None ): """ Instantiates a design structure. :param vlnv: A Vendor-Library-Name-Version unique identified. :param description: A description text. """ self._componentInstances = [] self._interconnections = [] self._adHocConnections = [] super().__init__(designFile, parse, vlnv, description)
# if not isinstance(description, str): # ex = TypeError(f"Parameter 'description' is not a string.") # if version_info >= (3, 11): # pragma: no cover # ex.add_note(f"Got type '{getFullyQualifiedName(description)}'.") # raise ex # elif description == "": # raise ValueError(f"Parameter 'description' is empty.") def Parse(self, element: _Element) -> None: elementLocalname = QName(element).localname if elementLocalname == "componentInstances": pass # for ipxactFileElement in element: # self.AddItem(IpxactFile.FromXml(ipxactFileElement)) elif elementLocalname == "componentInstances": pass elif elementLocalname == "interconnections": pass elif elementLocalname == "adHocConnections": pass else: raise IPXACTException(f"Unsupported tag '{elementLocalname}' at root-level.") def AddItem(self, item) -> None: if isinstance(item, ComponentInstance): self._componentInstances.append(item) elif isinstance(item, Interconnection): self._interconnections.append(item) elif isinstance(item, AdHocConnection): self._adHocConnections.append(item) else: raise ValueError()
[docs] def ToXml(self, schema: IPXACTSchema = __DEFAULT_SCHEMA__) -> str: """Converts the object's data into XML format.""" xmlns = schema.NamespacePrefix buffer = dedent(f"""\ <?xml version="1.0" encoding="UTF-8"?> <{xmlns}:design \txmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" \txmlns:{xmlns}="{schema.SchemaUri}" \txsi:schemaLocation="{schema.SchemaUri} {schema.SchemaUrl}"> {self._vlnv.ToXml(schema, isVersionedIdentifier=True)} \t<{xmlns}:description>{self._description}</{xmlns}:description> """) if self._componentInstances: buffer += f"\t<{xmlns}:componentInstances>\n" for componentInstance in self._componentInstances: buffer += componentInstance.ToXml(2, schema) buffer += f"\t</{xmlns}:componentInstances>\n" if self._interconnections: buffer += f"\t<{xmlns}:interconnections>\n" for interconnection in self._interconnections: buffer += interconnection.ToXml(2, schema) buffer += f"\t</{xmlns}:interconnections>\n" if self._adHocConnections: buffer += f"\t<{xmlns}:adHocConnections>\n" for adHocConnection in self._adHocConnections: buffer += adHocConnection.ToXml(2, schema) buffer += f"\t</{xmlns}:adHocConnections>\n" buffer += dedent(f"""\ </{xmlns}:design> """) return buffer
[docs] @export class IpxactFile(Element): """Represents a IP-XACT file.""" _name: str #: Name _description: str #: Description
[docs] def __init__(self, vlnv, name, description): """ Instantiates an ipxactFile structure. :param vlnv: A Vendor-Library-Name-Version unique identified. :param name: Name of the IP-XACT file. :param description: A description text. :raises TypeError: If parameter vlnv is not a VLNV. :raises TypeError: If parameter name is not a string. :raises ValueError: If parameter name is empty. :raises TypeError: If parameter description is not a string. :raises ValueError: If parameter description is empty. """ super().__init__(vlnv) if not isinstance(name, str): ex = TypeError(f"Parameter 'name' is not a string.") if version_info >= (3, 11): # pragma: no cover ex.add_note(f"Got type '{getFullyQualifiedName(name)}'.") raise ex elif name == "": raise ValueError(f"Parameter 'name' is empty.") if not isinstance(description, str): ex = TypeError(f"Parameter 'description' is not a string.") if version_info >= (3, 11): # pragma: no cover ex.add_note(f"Got type '{getFullyQualifiedName(description)}'.") raise ex elif description == "": raise ValueError(f"Parameter 'description' is empty.") self._name = name self._description = description
[docs] def ToXml(self, indent: int = 0, schema: IPXACTSchema = __DEFAULT_SCHEMA__) -> str: """Converts the object's data into XML format.""" # WORKAROUND: # Python <=3.11: # {'\t' * indent} is not supported by Python before 3.12 due to a backslash within {...} indent = "\t" * indent xmlns = schema.NamespacePrefix return dedent(f"""\ {indent}<{xmlns}:ipxactFile> {indent}\t{self._vlnv.ToXml(indent)} {indent}\t<{xmlns}:name>{self._name}</{xmlns}:name> {indent}\t<{xmlns}:description>{self._description}</{xmlns}:description> {indent}</{xmlns}:ipxactFile> """)
[docs] @export class ComponentInstance(Element): """Represents an IP-XACT component instance."""
[docs] def __init__(self, vlnv: VLNV) -> None: super().__init__(vlnv)
[docs] def ToXml(self, indent: int = 0, schema: IPXACTSchema = __DEFAULT_SCHEMA__) -> str: """Converts the object's data into XML format.""" return ""
[docs] @export class Interconnection(Element): """Represents an IP-XACT interconnection."""
[docs] def __init__(self, vlnv: VLNV) -> None: super().__init__(vlnv)
[docs] def ToXml(self, indent: int = 0, schema: IPXACTSchema = __DEFAULT_SCHEMA__) -> str: """Converts the object's data into XML format.""" return ""
[docs] @export class AdHocConnection(Element): """Represents an IP-XACT ad-hoc connection."""
[docs] def __init__(self, vlnv: VLNV) -> None: super().__init__(vlnv)
[docs] def ToXml(self, indent: int = 0, schema: IPXACTSchema = __DEFAULT_SCHEMA__) -> str: """Converts the object's data into XML format.""" return ""