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)