Source code for piel.types.connectivity.physical

from __future__ import annotations

from typing import Any
from .abstract import Port, Connection, Component
from ..core import PielBaseModel
from ..environment import Environment
from ..signal.core import ElectricalSignalDomains




class PhysicalPort(Port):
    """
    This refers to any form of physical port which can be connected to. The socket refers to the corresponding physical location where such a port is connected to.
    """

    domain: ElectricalSignalDomains | None = None
    connector: str = ""
    manifold: str = ""





class PhysicalConnection(PielBaseModel):
    """
    Describes a set of physical connection which are all connected. Represents a physical connection between interfaces.

    The components represent the physical implementation of the connections for the same connection index.
    """

    connections: list[Connection | Any] = []
    # TODO pending refactor of correct connectivity
    components: tuple[Component, ...] | list[Component] = []





class PhysicalComponent(Component):
    """
    Represents the data of a physical component or device.
    """

    ports: list[PhysicalPort | Port] | tuple[PhysicalPort | Port] = []
    connections: (
        list[PhysicalConnection | Connection] | tuple[PhysicalConnection | Connection]
    ) = []
    components: list[Component | PhysicalComponent] = []
    environment: Environment = Environment()

    manufacturer: str = ""
    """
    The manufacturer of the device.
    """

    model: str = ""
    """
    The model of the device.
    """