asterisk-tests-run(1)

asterisk-tests-run1

Run tests for the asterisk-testsuite

Usage

asterisk-tests-run [options]

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

Releases

Unchanged in 2 releases since Debian 8 (Jessie).

  1. 8–9

From asterisk-testsuite 0.0.0+svn.5781-2 in Debian 9 (Stretch). Parsed by carta from the page's man source.