tdl-xoa-driver 1.5.1__py3-none-any.whl → 1.6.0__py3-none-any.whl

xoa_driver/internals/hli/ports/port_l23/trafficgen/runt.py

@@ -0,0 +1,32 @@
+import functools
+from typing import TYPE_CHECKING
+from xoa_driver.internals.commands import (
+    P_TXRUNTLENGTH,
+    P_RXRUNTLENGTH,
+    P_RXRUNTLEN_ERRS,
+
+)
+if TYPE_CHECKING:
+    from xoa_driver.internals.core import interfaces as itf
+
+class Runt:
+    """Runt settings."""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        self.tx_length = P_TXRUNTLENGTH(conn, module_id, port_id)
+        """L23 port's TX runt length.
+        
+        :type: P_TXRUNTLENGTH
+        """
+
+        self.rx_length = P_RXRUNTLENGTH(conn, module_id, port_id)
+        """L23 port's RX runt length.
+        
+        :type: P_RXRUNTLENGTH
+        """
+
+        self.has_length_errors = P_RXRUNTLEN_ERRS(conn, module_id, port_id)
+        """L23 port's RX runt length errors..
+        
+        :type: P_RXRUNTLEN_ERRS
+        """

xoa_driver/internals/hli/testers/l23_tester.py

@@ -57,9 +57,7 @@ def get_module_type(revision: str) -> Type:
 
 class L23Tester(BaseTester["testers_state.GenuineTesterLocalState"]):
     """
-    This is a conceptual class of Xena Valkyrie Tester.
-    It is essentially an extended :class:`BaseTester`.
-
+    Create an instanace to connect to a Xena chassis.
 
     :param host: tester's address/hostname
     :type host: str

xoa_driver/internals/utils/indices/_interfaces.py

@@ -1,18 +1,19 @@
 from typing import (
     Protocol,
     List,
-    Type,
+    TypeVar,
+    Self,
     TYPE_CHECKING,
 )
 
 if TYPE_CHECKING:
     from xoa_driver.internals.core import interfaces as itf
-    from .. import kind
-    from . import observer
+    from .. import kind as kind_module
+    from . import observer as idx_obs
 
 
 class IIndexType(Protocol):
-    def __init__(self, conn: "itf.IConnection", kind: "kind.IndicesKind", observer: "observer.IndicesObserver") -> None: ...  # noqa: E704
+    def __init__(self, conn: "itf.IConnection", kind: "kind_module.IndicesKind", observer: "idx_obs.IndicesObserver") -> None: ...  # noqa: E704
 
     async def delete(self) -> None: ...  # noqa: E704
 
@@ -20,7 +21,18 @@ class IIndexType(Protocol):
     def idx(self) -> int: ...  # noqa: E704
 
     @classmethod
-    async def _fetch(cls, conn, module_id, port_id) -> List[int]: ...  # noqa: E704
+    async def _fetch(
+        cls, 
+        conn: "itf.IConnection", 
+        module_id: int, 
+        port_id: int) -> List[int]: ...  # noqa: E704
 
     @classmethod
-    async def _new(cls, conn: "itf.IConnection", kind: "kind.IndicesKind", observer: "observer.IndicesObserver") -> Type: ...  # noqa: E704
+    async def _new(
+        cls, 
+        conn: "itf.IConnection", 
+        kind: "kind_module.IndicesKind", 
+        observer: "idx_obs.IndicesObserver"
+        ) -> Self: ...  # noqa: E704
+    
+IT = TypeVar("IT", bound=IIndexType)

xoa_driver/internals/utils/indices/index_manager.py

@@ -60,7 +60,13 @@ class IndexManager(Generic[IT]):
         return self._indices[key]
 
     def obtain_multiple(self, *keys: int):
-        """Obtain multiple resources as a tuple of indices"""
+        """Obtain multiple index objects
+
+        :param keys: Indices of the desired index objects
+        :type keys: int
+        :return: Tuple of index objects corresponding to the provided keys
+        :rtype: tuple[IT, ...]
+        """
         return tuple(self._indices[k] for k in keys)
 
     def __detect_empty_idx_slot(self) -> int:
@@ -74,7 +80,7 @@ class IndexManager(Generic[IT]):
         ]
         return min(empties) if empties else len(existing_indices)
 
-    def __remove_from_slot(self, index_inst: Type) -> None:
+    def __remove_from_slot(self, index_inst: IT) -> None:
         # throws ValueError if element is not exists in list of indices
         self._indices.remove(index_inst)
 

xoa_driver/internals/utils/managers/ports_manager.py

@@ -111,6 +111,9 @@ class PortsCombiManager(PortBaseManager[PT]):
             for port_id in range(self._ports_count)
         )
         ports = await asyncio.gather(*coros)
-        self._items = OrderedDict(
-            (port.kind.port_id, port) for port in ports
+        self._items = cast(
+            OrderedDict[int, PT],
+            OrderedDict(
+                (port.kind.port_id, port) for port in ports
+            )
         )

xoa_driver/misc.py

@@ -5,9 +5,9 @@
 from .internals.core.token import Token
 from .internals.core.transporter.protocol.payload.types import Hex
 from .internals.commands.subtypes import (
-    ArpChunk,
-    NdpChunk,
-    DhcpChunk,
+    ArpEntry,
+    NdpEntry,
+    DhcpEntry,
     GroupAddressElem,
     VlanTag,
     QueueStatsElem,
@@ -31,9 +31,9 @@ from xoa_driver.internals.hli.indices.macsecscs.genuine_macsecsc import GenuineM
 __all__ = (
     "Token",
     "Hex",
-    "ArpChunk",
-    "NdpChunk",
-    "DhcpChunk",
+    "ArpEntry",
+    "NdpEntry",
+    "DhcpEntry",
     "GroupAddressElem",
     "VlanTag",
     "QueueStatsElem",

xoa_driver/modules.py

@@ -1,21 +1,26 @@
 #: All available test module types.
 """Xena test module types."""
-
+from typing import Union
 from .internals.hli.modules.modules_l23.module_l23_base import ModuleL23
-from .internals.hli.modules.modules_l23.family_d import (
+from .internals.hli.modules.module_l23ve import ModuleL23VE
+from .internals.hli.modules.module_chimera import (
+    ModuleChimera,
+    MChi100G5S2P,
+    MChi100G5S2P_b,
+    MChi40G2S2P,
+)
+from .internals.hli.modules.module_l47 import ModuleL47
+from .internals.hli.modules.module_l47ve import ModuleL47VE
+from .internals.hli.modules.modules_l23.family_odin import (
     MOdin1G3S2PT,
     MOdin1G3S6P,
     MOdin1G3S6P_b,
     MOdin1G3S6PE,
-)
-from .internals.hli.modules.modules_l23.family_e import (
     MOdin5G4S6PCU,
     MOdin10G3S2PCU,
     MOdin10G3S6PCU,
     MOdin10G5S6PCU,
     MOdin10G5S6PCU_b,
-)
-from .internals.hli.modules.modules_l23.family_f import (
     MOdin10G1S2P,
     MOdin10G1S2P_b,
     MOdin10G1S2P_c,
@@ -25,31 +30,32 @@ from .internals.hli.modules.modules_l23.family_f import (
     MOdin10G1S6P_b,
     MOdin10G1S12P,
     MOdin10G6S6P_a,
+    MOdin100G3S1P,
+    MOdin1G3S6PT1RJ45,
+    MOdin10G4S2PCombi,
+    MOdin10G4S2PCombi_b,
+    MOdin40G2S2P,
+    MOdin40G2S2PB,
 )
-from .internals.hli.modules.modules_l23.family_g import (
+from .internals.hli.modules.modules_l23.family_loki import (
     MLoki100G3S1P,
     MLoki100G3S1P_b,
     MLoki100G3S1PSE,
     MLoki100G3S1PB,
     MLoki100G3S1PB_b,
     MLoki100G5S4P_a,
-)
-from .internals.hli.modules.modules_l23.family_h import (
     MLoki100G5S1P,
-    MOdin100G3S1P,
+    MLoki100G5S2P,
 )
-from .internals.hli.modules.modules_l23.family_i import MLoki100G5S2P
-from .internals.hli.modules.modules_l23.family_j import MThor100G5S4P
-from .internals.hli.modules.modules_l23.family_k import (
+from .internals.hli.modules.modules_l23.family_thor import (
+    MThor100G5S4P,
     MThor400G7S1P,
     MThor400G7S1PLE,
-)
-from .internals.hli.modules.modules_l23.family_l import (
     MThor400G7S1P_b,
     MThor400G7S1P_c,
     MThor400G7S1P_d,
 )
-from .internals.hli.modules.modules_l23.family_l1 import (
+from .internals.hli.modules.modules_l23.family_freya import (
     MFreya800G1S1P_a,
     MFreya800G1S1P_b,
     MFreya800G1S1POSFP_a,
@@ -99,33 +105,11 @@ from .internals.hli.modules.modules_l23.family_l1 import (
     MFreya800G4S1POSFP_e_g2,
     MFreya800G4S1POSFP_f_g2,
 )
-from .internals.hli.modules.modules_l23.family_m import MOdin1G3S6PT1RJ45
-from .internals.hli.modules.modules_l23.family_n import (
-    MOdin40G2S2P,
-    MOdin40G2S2PB,
-)
-from .internals.hli.modules.modules_l23.family_combi import (
-    MOdin10G4S2PCombi,
-    MOdin10G4S2PCombi_b,
-)
-from .internals.hli.modules.module_l23ve import ModuleL23VE
-from .internals.hli.modules.module_chimera import (
-    ModuleChimera,
-    MChi100G5S2P,
-    MChi100G5S2P_b,
-    MChi40G2S2P,
-)
-from .internals.hli.modules.module_l47 import ModuleL47
-from .internals.hli.modules.module_l47ve import ModuleL47VE
-
 from .internals.hli.modules.modules_l23.family_edun import (
     MEdun800G3S1PSMPX_a,
     MEdun1600G4S1POSFP_a
 )
-
-import typing
-
-Z10OdinModule = typing.Union[
+Z10OdinModule = Union[
     MOdin1G3S2PT,
     MOdin1G3S6P,
     MOdin1G3S6P_b,
@@ -152,7 +136,7 @@ Z10OdinModule = typing.Union[
     MOdin100G3S1P,
 ]
 
-Z100LokiModule = typing.Union[
+Z100LokiModule = Union[
     MLoki100G3S1P,
     MLoki100G3S1P_b,
     MLoki100G3S1PSE,
@@ -163,7 +147,7 @@ Z100LokiModule = typing.Union[
     MLoki100G5S4P_a,
 ]
 
-Z400ThorModule = typing.Union[
+Z400ThorModule = Union[
     MThor100G5S4P,
     MThor400G7S1P,
     MThor400G7S1PLE,
@@ -172,7 +156,7 @@ Z400ThorModule = typing.Union[
     MThor400G7S1P_d,
 ]
 
-Z800FreyaModule = typing.Union[
+Z800FreyaModule = Union[
     MFreya800G1S1P_a,
     MFreya800G1S1P_b,
     MFreya800G1S1POSFP_a,
@@ -223,25 +207,25 @@ Z800FreyaModule = typing.Union[
     MFreya800G4S1POSFP_f_g2,
 ]
 
-Z1600EdunModule = typing.Union[
+Z1600EdunModule = Union[
     MEdun800G3S1PSMPX_a,
     MEdun1600G4S1POSFP_a
 ]
 
-E100ChimeraModule = typing.Union[
+E100ChimeraModule = Union[
     ModuleChimera,
     MChi100G5S2P,
     MChi100G5S2P_b,
     MChi40G2S2P,
 ]
 
-LegacyModule = typing.Union[
+LegacyModule = Union[
     ModuleL23VE,
     ModuleL47,
     ModuleL47VE,
 ]
 
-GenericL23Module = typing.Union[
+GenericL23Module = Union[
     "MOdin1G3S2PT",
     "MOdin1G3S6P",
     "MOdin1G3S6P_b",
@@ -336,7 +320,7 @@ GenericL23Module = typing.Union[
     "MEdun1600G4S1POSFP_a",
 ]
 
-GenericAnyModule = typing.Union[
+GenericAnyModule = Union[
     GenericL23Module,
     
     "ModuleL23VE",

xoa_driver/ports.py

@@ -13,30 +13,21 @@ from .internals.hli.ports.port_l23.chimera.port_chimera import (
     PChi40G2S2P,
 )
 
-from .internals.hli.ports.port_l23.bases.port_l23 import BasePortL23
-from xoa_driver.internals.hli.ports.port_l23.family_combi import (
+from .internals.hli.ports.port_l23.trafficgen.port_l23 import BasePortL23
+from xoa_driver.internals.hli.ports.port_l23.family_odin import (
     POdin1G4S4PCombi,
     POdin1G4S4PCombi_b,
     POdin10G4S2PCombi,
     POdin10G4S2PCombi_b,
-)
-
-from xoa_driver.internals.hli.ports.port_l23.family_d import (
     POdin1G3S2PT,
     POdin1G3S6P,
     POdin1G3S6P_b,
     POdin1G3S6PE,
-)
-
-from xoa_driver.internals.hli.ports.port_l23.family_e import (
     POdin5G4S6PCU,
     POdin10G3S2PCU,
     POdin10G3S6PCU,
     POdin10G5S6PCU,
     POdin10G5S6PCU_b,
-)
-
-from xoa_driver.internals.hli.ports.port_l23.family_f import (
     POdin10G1S2P,
     POdin10G1S2P_b,
     POdin10G1S2P_c,
@@ -48,35 +39,28 @@ from xoa_driver.internals.hli.ports.port_l23.family_f import (
     POdin40G2S2P,
     POdin40G2S2PB,
     POdin10G6S6P_a,
+    POdin100G3S1P,
+    POdin1G3S6PT1RJ45,
 )
-
-from xoa_driver.internals.hli.ports.port_l23.family_g import (
+from xoa_driver.internals.hli.ports.port_l23.family_loki import (
     PLoki100G3S1P,
     PLoki100G3S1P_b,
     PLoki100G3S1PSE,
     PLoki100G3S1PB,
     PLoki100G3S1PB_b,
     PLoki100G5S4P_a,
-)
-
-from xoa_driver.internals.hli.ports.port_l23.family_h import (
     PLoki100G5S1P,
-    POdin100G3S1P,
+    PLoki100G5S2P,
 )
-
-from xoa_driver.internals.hli.ports.port_l23.family_i import PLoki100G5S2P
-from xoa_driver.internals.hli.ports.port_l23.family_j import PThor100G5S4P
-from xoa_driver.internals.hli.ports.port_l23.family_k import (
+from xoa_driver.internals.hli.ports.port_l23.family_thor import (
+    PThor100G5S4P,
     PThor400G7S1P,
     PThor400G7S1PLE,
-)
-from xoa_driver.internals.hli.ports.port_l23.family_l import (
     PThor400G7S1P_b,
     PThor400G7S1P_c,
     PThor400G7S1P_d,
 )
-
-from xoa_driver.internals.hli.ports.port_l23.family_l1 import (
+from xoa_driver.internals.hli.ports.port_l23.family_freya import (
     PFreya800G1S1P_a,
     PFreya800G1S1P_b,
     PFreya800G1S1POSFP_a,
@@ -95,12 +79,9 @@ from xoa_driver.internals.hli.ports.port_l23.family_l1 import (
     PFreya800G4S1POSFP_e,
     PFreya800G4S1POSFP_f,
 )
-
-from xoa_driver.internals.hli.ports.port_l23.family_m import POdin1G3S6PT1RJ45
-
 from xoa_driver.internals.hli.ports.port_l23.family_edun import (
     PEdun800G3S1PSMPX_a,
-    PEdun1600G4S1POSFP_a
+    PEdun1600G4S1POSFP_a,
 )
 
 Z10OdinPort = typing.Union[

xoa_driver/internals/hli/modules/modules_l23/family_d.py

@@ -1,75 +0,0 @@
-import typing
-from xoa_driver import ports
-from xoa_driver.internals.hli import revisions
-from xoa_driver.internals.utils.managers import ports_manager as pm
-
-
-if typing.TYPE_CHECKING:
-    from xoa_driver.internals.core import interfaces as itf
-    from .. import __interfaces as m_itf
-
-from .module_l23_base import ModuleL23
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-1G-3S-6P")
-class MOdin1G3S6P(ModuleL23):
-    """Test module Odin-1G-3S-6P"""
-
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin1G3S6P] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin1G3S6P,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-1G-3S-6P"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-1G-3S-6P[b]")
-class MOdin1G3S6P_b(ModuleL23):
-    """Test module Odin-1G-3S-6P[b]"""
-
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin1G3S6P_b] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin1G3S6P_b,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-1G-3S-6P[b]"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-1G-3S-6P-E")
-class MOdin1G3S6PE(ModuleL23):
-    """Test module Odin-1G-3S-6P-E"""
-
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin1G3S6PE] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin1G3S6PE,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-1G-3S-6P-E"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-1G-3S-2P-T")
-class MOdin1G3S2PT(ModuleL23):
-    """Test module Odin-1G-3S-2P-T"""
-
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin1G3S2PT] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin1G3S2PT,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-1G-3S-2P-T"""

xoa_driver/internals/hli/modules/modules_l23/family_e.py

@@ -1,85 +0,0 @@
-import typing
-from xoa_driver import ports
-from xoa_driver.internals.hli import revisions
-from xoa_driver.internals.utils.managers import ports_manager as pm
-
-if typing.TYPE_CHECKING:
-    from xoa_driver.internals.core import interfaces as itf
-    from .. import __interfaces as m_itf
-
-from .module_l23_base import ModuleL23
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-5G-4S-6P-CU")
-class MOdin5G4S6PCU(ModuleL23):
-    """Test module Odin-5G-4S-6P-CU"""
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin5G4S6PCU] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin5G4S6PCU,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-5G-4S-6P-CU"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-10G-5S-6P-CU")
-class MOdin10G5S6PCU(ModuleL23):
-    """Test module Odin-10G-5S-6P-CU"""
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin10G5S6PCU] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin10G5S6PCU,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-10G-5S-6P-CU"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-10G-5S-6P-CU[b]")
-class MOdin10G5S6PCU_b(ModuleL23):
-    """Test module Odin-10G-5S-6P-CU[b]"""
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin10G5S6PCU_b] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin10G5S6PCU_b,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-10G-5S-6P-CU[b]"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-10G-3S-6P-CU")
-class MOdin10G3S6PCU(ModuleL23):
-    """Test module Odin-10G-3S-6P-CU"""
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin10G3S6PCU] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin10G3S6PCU,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-10G-3S-6P-CU"""
-
-
-@typing.final
-@revisions.register_valkyrie_module(rev="Odin-10G-3S-2P-CU")
-class MOdin10G3S2PCU(ModuleL23):
-    """Test module Odin-10G-3S-2P-CU"""
-    def __init__(self, conn: "itf.IConnection", init_data: "m_itf.ModuleInitData") -> None:
-        super().__init__(conn, init_data)
-        self.ports: pm.PortsManager[ports.POdin10G3S2PCU] = pm.PortsManager(
-            conn=conn,
-            ports_type=ports.POdin10G3S2PCU,
-            module_id=self.module_id,
-            ports_count=self.ports_count
-        )
-        """Port Index Manager of Odin-10G-3S-2P-CU"""