TEST-APPROVE(1)                   Test Manual                  TEST-APPROVE(1)

NAME
       test-approve - approve new test output

SYNOPSIS
       test approve [OPTION]…

OPTIONS
       --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.

       -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.

       -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.

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 approve 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-APPROVE(1)