Test2::EventFacet::Info::Table(3p)

Test2::EventFacet::Info::Table3p

Intermediary representation of a table.

Usage

    use Test2::EventFacet::Info::Table;
    use Test2::API qw/context/;
    sub my_tool {
        my $ctx = context();
        ...
        $ctx->fail(
            $name,
            "failure diag message",
            Test2::EventFacet::Info::Table->new(
                # Required
                rows => [['a', 'b'], ['c', 'd'], ...],
                # Strongly Recommended
                as_string => "... string to print when table cannot be rendered ...",
                # Optional
                header => ['col1', 'col2'],
                collapse => $bool,
                no_collapse => ['col1', ...],
            ),
        );
        ...
        $ctx->release;
    }
    my_tool();

Overview

Intermediary representation of a table for use in specialized Test::API::Context methods which generate Test2::EventFacet::Info facets.

Attributes

$header_aref = $t->header()
$rows_aref = $t->rows()
$bool = $t->collapse()
$aref = $t->no_collapse()

The above are all directly tied to the table hashref structure described in Test2::EventFacet::Info.

$str = $t->as_string()

This returns the string form of the table if it was set, otherwise it returns the string "<TABLE NOT DISPLAYED>".

$href = $t->as_hash()

This returns the data structure used for tables by Test2::EventFacet::Info.

%args = $t->info_args()

This returns the arguments that should be used to construct the proper Test2::EventFacet::Info structure.

    return (table => $t->as_hash(), details => $t->as_string());

Source

The source code repository for Test2 can be found at <https://github.com/Test-More/test-more/>.

Maintainers

Chad Granum <[email protected]>

Releases

15 releases since OpenBSD 6.7; the text changed 9 times.

  1. 6.7
  2. 6.8
  3. 6.9–7.2
  4. 7.3
  5. 7.4
  6. 7.5
  7. 7.6
  8. 7.7–7.8
  9. 7.9
  10. 8.0

Authors

Chad Granum <[email protected]>

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's man source.