NAME

repomatic show-test-matrix - Render the CI test matrix as a grid

SYNOPSIS

repomatic show-test-matrix [OPTIONS] [full|pr]

DESCRIPTION

List every job of the computed CI test matrix, one row per job.

Each row carries one column per axis and states whether that job runs stable or unstable (continue-on-error), which is the job list CI schedules. Sort it on the axes you care about with --row-axis and --col-axis. Pass "full" for the push and schedule matrix (the default), or "pr" for the reduced pull-request matrix. Respects the global --table-format option.

--grid trades that listing for a two-axis grid: the two axes head the sides and every other axis collapses into the cells. It is the compact read of the same jobs, and it is lossy, so a cell standing for several jobs states how many.

[full|pr]

OPTIONS

--emoji / --no-emoji: Decorate cells with a status emoji. Use --no-emoji for plain words.
--grid / --no-grid: Collapse the listing into a two-axis grid, one cell per intersection.
--row-axis [os|python-label|python-version|state]: Job key sorted on first, heading the grid's rows.
--col-axis [os|python-label|python-version|state]: Job key sorted on next, heading the grid's columns.
--help / -h: Show this message and exit.

ENVIRONMENT

SHOW_TEST_MATRIX_EMOJI: Decorate cells with a status emoji. Use --no-emoji for plain words.
SHOW_TEST_MATRIX_GRID: Collapse the listing into a two-axis grid, one cell per intersection.
SHOW_TEST_MATRIX_ROW_AXIS: Job key sorted on first, heading the grid's rows.
SHOW_TEST_MATRIX_COL_AXIS: Job key sorted on next, heading the grid's columns.
SHOW_TEST_MATRIX__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

EXAMPLES

One row per job

repomatic show\-test\-matrix

The PR subset, in plain words

repomatic show\-test\-matrix pr \-\-no\-emoji

Pivot columns on a custom axis

repomatic show\-test\-matrix \-\-col\-axis click\-version

The compact two-axis grid

repomatic show\-test\-matrix \-\-grid

Choose both grid axes

repomatic show\-test\-matrix \-\-grid \-\-row\-axis os \-\-col\-axis python\-version

The full matrix as a GitHub-flavored table

repomatic \-\-table\-format github show\-test\-matrix full

AUTHORS

Kevin Deldycke