NAME

       asterisk-tests-run - run tests for the asterisk-testsuite

SYNOPSIS

       asterisk-tests-run [options]

       The  Asterisk  test  suite is a set of tests to check various versions of the Asterisk PBX
       software. The command asterisk-tests-run runs all the tests, some of them  (selectable  by
       tags), or just a single test.

       The  test  suite  will  detect  if  the test can run on the system (if it has the required
       software to run the test, if it has the required version of Asterisk and  if  Asterisk  is
       built with the required configuration) and if so, will run it.

       This  command  is  mostly a wrapper around runtests.py of the asterisk-testsuite. This man
       page documents runtests.py itself except where explicitly mentioned.

OPTIONS

   Test Selection
       By default all the tests are selected.

       -t, --test=test
              Only run the selected test. The name of the test is the name  of  the  subdirectory
              including the leading "tests/".

       -g, --tag=tag
              Specify  tag  by which to select tests. If option is used more than once, all tests
              matching any of the tags will be selected.

       -l, --list
              Don't run any test. Just list all of them. Note: the list is long.

       -L, --list-tags
              Don't run any test. Just list all the tags.

       -h, --help
              Show summary of options without emitting an error message.

   Other Options
       -v, --version=version-string
              Provide an explicit version of Asterisk to be tested, in case it cannot  be  probed
              successfully.

       -n, --dry-run
              Don't run. Just print the test should be run (or why tests would not be run).

       -H --hide-skipped
              Don't print tests that were not run.

       -o --output-dir=directory
              An  internal  option. Please don't use explicitly with asterisk-tests-run.  Directs
              runtests where to  write  its  output  file  (asterisk-test-suite-report.xml).  The
              script directs it to /var/lib/asterisk-testsuite .

       -c --extra-config=directory
              Pass  extra  configuration  settings from directory/config.yaml.  Most settings are
              not read from that file. Only  test  exclusions  (in  additions  to  tests  getting
              excluded in the the main config.yaml of the tests directory).

EXAMPLES

       asterisk-tests-run
              Just run all the tests.

       asterisk-tests-run -g SIP -g AGI
              Run both SIP and AGI tests.

       asterisk-tests-run -t tests/agi/exit_status
              Run one specific test.

       asterisk-tests-run --list
              List all the tests.

       asterisk-tests-run --dry-run
              An even more verbose list

       asterisk-tests-run --extra-config /usr/share/asterisk/test
              Takes extra settings from file /usr/share/asterisk/test/test-config.yaml

SEE ALSO

       asttest(1)

                                            2014-08-29                                ASTERISK(1)