TEST-STATUS(1)                    Test Manual                   TEST-STATUS(1)

NAME
       test-status - show test status

SYNOPSIS
       test status [OPTION]…

OPTIONS
       -a, --all
           Report  tests  in  all statuses instead of only the tests that need
           attention.

       --autoclean
           Remove test snapshots that don't match any test.

       --debug
           Log information that can be useful for debugging the Testo library.

       -e KEY=VALUE, --env=KEY=VALUE
           Pass a key/value pair to the function that creates the test  suite.
           KEY    must   be   an   alphanumeric   identifier   of   the   form
           [A-Za-z_][A-Za-z_0-9]*. VALUE can be any string. This mechanism for
           passing arbitrary runtime settings to the test suite is offered  as
           a  safer  alternative  to  environment variables. Multiple -e/--env
           options are supported  in  the  same  command,  each  defining  one
           key/value pair.

       --expert
           Assume the user is familiar with Testo and don't show non-essential
           messages or tips targeted at new users.

       -l, --long
           Print details instead of just a one-line summary for each test.

       --max-inline-log-bytes=LIMIT (absent=1000000)
           When  displaying  logs (unchecked stdout or stderr output), show at
           most that many bytes for each test. The default  limit  is  1000000
           bytes. To remove the default limit, specify 'unlimited'.

       -s SUBSTRING, --filter-substring=SUBSTRING
           Select  tests  whose  description contains SUBSTRING. Multiple '-s'
           search queries can be specified in which  case  only  one  of  them
           needs to match.

       --strict
           Treat  broken  tests  as  ordinary tests. This disables the default
           behavior of ignoring failing tests that were marked  as  broken  by
           the  programmer  when  determining  the overall success of the test
           run.

       -t QUERY, --filter-tag=QUERY
           Select tests whose tags match QUERY. Filtering by tag is  generally
           more  robust  than  selecting tests by text contained in their name
           with '-s'. QUERY is a boolean  query  combining  tags  with  'and',
           'or',  'not',  and  parentheses  using  the usual precedence rules.
           Tag-like  selectors  'all'  and  'none'  are  also  supported.  For
           example,  '(foo  or bar) and not e2e' will select any test with the
           tag 'foo' or the tag 'bar' but not if it has  the  tag  'e2e'.  Run
           './test  show-tags' to see the list of tags defined for the current
           test suite.

       -v, --verbose
           Report the status of the tests  with  maximum  verbosity.  This  is
           currently equivalent to '-alw'.

       -w, --show-output
           Show the output of all tests rather than only showing the output of
           the  failed  tests.  This  excludes  the output (stdout, stderr, or
           both) that may  be  captured  explicitly  to  be  compared  against
           expectations.

COMMON OPTIONS
       --help[=FMT] (default=auto)
           Show  this  help  in format FMT. The value FMT must be one of auto,
           pager, groff or plain. With auto, the  format  is  pager  or  plain
           whenever the TERM env var is dumb or undefined.

EXIT STATUS
       test status exits with:

       0   on success.

       123 on indiscriminate errors reported on standard error.

       124 on command line parsing errors.

       125 on unexpected internal errors (bugs).

SEE ALSO
       test(1)

Test                                                            TEST-STATUS(1)