This document describes how to:
There are no special requirements for running
ansible-test on Python 2.7 or later.
argparse package is required for Python 2.6.
The requirements for each
ansible-test command are covered later.
ansible-test commands support running in one or more isolated test environments to simplify testing.
ansible-test shell command to get an interactive shell in the same environment used to run tests. Examples:
ansible-test shell --docker- Open a shell in the default docker container.
ansible-test shell --tox --python 3.6- Open a shell in the Python 3.6
Code coverage reports make it easy to identify untested code for which more tests should
be written. Online reports are available but only cover the
devel branch (see
Testing Ansible). For new code local reports are needed.
--coverage option to any test command to collect code coverage data. If you
aren’t using the
--docker options which create an isolated python
environment then you may have to use the
--requirements option to ensure that the
correct version of the coverage module is installed
ansible-test units –coverage apt ansible-test integration –coverage aws_lambda –tox –requirements ansible-test coverage html
Reports can be generated in several different formats:
ansible-test coverage report- Console report.
ansible-test coverage html- HTML report.
ansible-test coverage xml- XML report.
To clear data between test runs, use the
ansible-test coverage erase command. For a full list of features see the online help:
ansible-test coverage --help