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.

Any non-zero integer denotes a configurable connection; the integer encodes the mux input position (higher = earlier, i.e. rightmost .list entry → A0, MSB-first). Sort by (-value, column) so all-1 rows fall back to CSV-column order via the column-index secondary key.

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, or a non-integer cell value in a row.

Returns:

Dictionary from destination to a list of sources.