Table Reporter

ReportTable

TableReport Generate a Table based on TestResult.

Headers dataclass

Headers(
    device: str = "Device",
    test_case: str = "Test Name",
    number_of_success: str = "# of success",
    number_of_failure: str = "# of failure",
    number_of_skipped: str = "# of skipped",
    number_of_errors: str = "# of errors",
    list_of_error_nodes: str = "List of failed or error nodes",
    list_of_error_tests: str = "List of failed or error test cases",
)

Headers for the table report.

report_all

report_all(
    manager: ResultManager, title: str = "All tests results"
) -> Table

Create a table report with all tests for one or all devices.

Create table with full output: Device | Test Name | Test Status | Message(s) | Test description | Test category

Parameters:

Name	Type	Description	Default
manager	ResultManager	A ResultManager instance.	required
title	str	Title for the report. Defaults to ‘All tests results’.	'All tests results'

Returns:

Type	Description
Table	A fully populated rich Table.

Source code in anta/reporter/__init__.py

def report_all(self, manager: ResultManager, title: str = "All tests results") -> Table:
    """Create a table report with all tests for one or all devices.

    Create table with full output: Device | Test Name | Test Status | Message(s) | Test description | Test category

    Parameters
    ----------
    manager
        A ResultManager instance.
    title
        Title for the report. Defaults to 'All tests results'.

    Returns
    -------
    Table
        A fully populated rich `Table`.
    """
    table = Table(title=title, show_lines=True)
    headers = ["Device", "Test Name", "Test Status", "Message(s)", "Test description", "Test category"]
    table = self._build_headers(headers=headers, table=table)

    def add_line(result: TestResult) -> None:
        state = self._color_result(result.result)
        message = self._split_list_to_txt_list(result.messages) if len(result.messages) > 0 else ""
        categories = ", ".join(convert_categories(result.categories))
        table.add_row(str(result.name), result.test, state, message, result.description, categories)

    for result in manager.results:
        add_line(result)
    return table

report_summary_devices

report_summary_devices(
    manager: ResultManager,
    devices: list[str] | None = None,
    title: str = "Summary per device",
) -> Table

Create a table report with result aggregated per device.

Create table with full output: Device | # of success | # of skipped | # of failure | # of errors | List of failed or error test cases

Parameters:

Name	Type	Description	Default
manager	ResultManager	A ResultManager instance.	required
devices	list[str] | None	List of device names to include. None to select all devices.	None
title	str	Title of the report.	'Summary per device'

Returns:

Type	Description
Table	A fully populated rich Table.

Source code in anta/reporter/__init__.py

def report_summary_devices(
    self,
    manager: ResultManager,
    devices: list[str] | None = None,
    title: str = "Summary per device",
) -> Table:
    """Create a table report with result aggregated per device.

    Create table with full output: Device | # of success | # of skipped | # of failure | # of errors | List of failed or error test cases

    Parameters
    ----------
    manager
        A ResultManager instance.
    devices
        List of device names to include. None to select all devices.
    title
        Title of the report.

    Returns
    -------
    Table
        A fully populated rich `Table`.
    """
    table = Table(title=title, show_lines=True)
    headers = [
        self.Headers.device,
        self.Headers.number_of_success,
        self.Headers.number_of_skipped,
        self.Headers.number_of_failure,
        self.Headers.number_of_errors,
        self.Headers.list_of_error_tests,
    ]
    table = self._build_headers(headers=headers, table=table)
    for device, stats in manager.device_stats.items():
        if devices is None or device in devices:
            table.add_row(
                device,
                str(stats.tests_success_count),
                str(stats.tests_skipped_count),
                str(stats.tests_failure_count),
                str(stats.tests_error_count),
                ", ".join(stats.tests_failure),
            )
    return table

report_summary_tests

report_summary_tests(
    manager: ResultManager,
    tests: list[str] | None = None,
    title: str = "Summary per test",
) -> Table

Create a table report with result aggregated per test.

Create table with full output: Test Name | # of success | # of skipped | # of failure | # of errors | List of failed or error nodes

Parameters:

Name	Type	Description	Default
manager	ResultManager	A ResultManager instance.	required
tests	list[str] | None	List of test names to include. None to select all tests.	None
title	str	Title of the report.	'Summary per test'

Returns:

Type	Description
Table	A fully populated rich Table.

Source code in anta/reporter/__init__.py

def report_summary_tests(
    self,
    manager: ResultManager,
    tests: list[str] | None = None,
    title: str = "Summary per test",
) -> Table:
    """Create a table report with result aggregated per test.

    Create table with full output:
    Test Name | # of success | # of skipped | # of failure | # of errors | List of failed or error nodes

    Parameters
    ----------
    manager
        A ResultManager instance.
    tests
        List of test names to include. None to select all tests.
    title
        Title of the report.

    Returns
    -------
    Table
        A fully populated rich `Table`.
    """
    table = Table(title=title, show_lines=True)
    headers = [
        self.Headers.test_case,
        self.Headers.number_of_success,
        self.Headers.number_of_skipped,
        self.Headers.number_of_failure,
        self.Headers.number_of_errors,
        self.Headers.list_of_error_nodes,
    ]
    table = self._build_headers(headers=headers, table=table)
    for test, stats in manager.test_stats.items():
        if tests is None or test in tests:
            table.add_row(
                test,
                str(stats.devices_success_count),
                str(stats.devices_skipped_count),
                str(stats.devices_failure_count),
                str(stats.devices_error_count),
                ", ".join(stats.devices_failure),
            )
    return table