The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

App::Yath::Command::replay - Replay a test run from an event log

DESCRIPTION

This yath command will re-run the harness against an event log produced by a previous test run. The only required argument is the path to the log file, which maybe compressed. Any extra arguments are assumed to be job id's. If you list any jobs, only listed jobs will be processed.

This command accepts all the same renderer/formatter options that the 'test' command accepts.

USAGE

    $ yath [YATH OPTIONS] replay [COMMAND OPTIONS] [COMMAND ARGUMENTS]

OPTIONS

Renderer Options

--hide-runner-output
--no-hide-runner-output

Hide output from the runner, showing only test output. (See Also truncate_runner_output)

-q
--quiet
--no-quiet

Be very quiet.

--qvf
--no-qvf

Replaces App::Yath::Theme::Default with App::Yath::Theme::QVF which is quiet for passing tests and verbose for failing ones.

--renderer +My::Renderer
--renderers +My::Renderer
--renderer MyRenderer=opt1,opt2
--renderers MyRenderer=opt1,opt2
--renderer MyRenderer,MyOtherRenderer
--renderers MyRenderer,MyOtherRenderer
--renderer=:{ MyRenderer opt1,opt2,... }:
--renderers=:{ MyRenderer opt1,opt2,... }:
--renderer :{ MyRenderer :{ opt1 opt2 }: }:
--renderers :{ MyRenderer :{ opt1 opt2 }: }:
--no-renderers

Specify renderers. Use "+" to give a fully qualified module name. Without "+" "App::Yath::Renderer::" will be prepended to your argument.

Note: Can be specified multiple times

--server
--server=ARG
--no-server

Start an ephemeral yath database and web server to view results

--show-job-end
--no-show-job-end

Show output when a job ends. (Default: on)

--show-job-info
--no-show-job-info

Show the job configuration when a job starts. (Default: off, unless -vv)

--show-job-launch
--no-show-job-launch

Show output for the start of a job. (Default: off unless -v)

--show-run-fields
--no-show-run-fields

Show run fields. (Default: off, unless -vv)

--show-run-info
--no-show-run-info

Show the run configuration when a run starts. (Default: off, unless -vv)

-T
--show-times
--no-show-times

Show the timing data for each job.

-tARG
-t ARG
-t=ARG
--theme ARG
--theme=ARG
--no-theme

Select a theme for the renderer (not all renderers use this)

--truncate-runner-output
--no-truncate-runner-output

Only show runner output that was generated after the current command. This is only useful with a persistent runner.

-v
-vv
-vvv..
-v=COUNT
--verbose
--verbose=COUNT
--no-verbose

Be more verbose

The following environment variables will be set after arguments are processed: T2_HARNESS_IS_VERBOSE, HARNESS_IS_VERBOSE

Note: Can be specified multiple times, counter bumps each time it is used.

--wrap
--no-wrap

When active (default) renderers should try to wrap text in a human-friendly way. When this is turned off they should just throw text at the terminal.

Run Options

--run-auditor ARG
--run-auditor=ARG
--no-run-auditor

Auditor class to use when auditing the overall test run

Terminal Options

-c
--color
--no-color

Turn color on, default is true if STDOUT is a TTY.

Can also be set with the following environment variables: YATH_COLOR, CLICOLOR_FORCE

The following environment variables will be set after arguments are processed: YATH_COLOR

--progress
--no-progress

Toggle progress indicators. On by default if STDOUT is a TTY. You can use --no-progress to disable the 'events seen' counter and buffered event pre-display

--term-size 80
--term-width 80
--term-size 200
--term-width 200
--no-term-width

Alternative to setting $TABLE_TERM_SIZE. Setting this will override the terminal width detection to the number of characters specified.

Can also be set with the following environment variables: TABLE_TERM_SIZE

The following environment variables will be set after arguments are processed: TABLE_TERM_SIZE

SOURCE

The source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright Chad Granum <exodist7@gmail.com>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/