parse_switchmatrix

Parser functions for switch matrix and list file configurations.

This module provides utilities for parsing switch matrix CSV files and list files used in fabric definition. It handles expansion of port definitions, connection mappings, and validation of port configurations.

Functions

expandListPorts(port)

Expand the .list file entry into a list of port strings.

parseList(…)

Parse a list file and expand the list file information into a list of tuples.

parseMatrix(fileName, tileName)

Parse the matrix CSV into a dictionary from destination to source.

Module Contents

expandListPorts(port) → list[str][source]

Expand the .list file entry into a list of port strings.

Parameters:

port (str) – The port entry to expand. If it contains “[”, it’s split into multiple entries based on “|”.

Raises:

ValueError – If the port entry contains “[” or “{” without matching closing bracket “]”/”}”.

Returns:

The expanded list of port strings.

parseList(filePath: Path, collect: Literal['pair'] = 'pair') → list[tuple[str, str]][source]
parseList(filePath: Path, collect: Literal['source', 'sink']) → dict[str, list[str]]

Parse a list file and expand the list file information into a list of tuples.

Parameters:

  • filePath (Path) – The path to the list file to parse.

  • collect (Literal["pair", "source", "sink"], optional) – Collect value by source, sink or just as (source, sink) pair. Defaults to “pair”.

Raises:
Returns:

Return either a list of connection pairs or a dictionary of lists which is collected by the specified option, source or sink.

parseMatrix(fileName, tileName) → dict[str, list[str]][source]

Parse the matrix CSV into a dictionary from destination to source.

Parameters:

  • fileName (Path) – Directory of the matrix CSV file.

  • tileName (str) – Name of the tile needed to be parsed.

Raises:

InvalidSwitchMatrixDefinition – Non matching matrix file content and tile name

Returns:

Dictionary from destination to a list of sources.