Running Sanity Tests, Unit Tests, and Coverage Report Generation

Prerequisites

• Install the collection version to be tested.

• Install Docker if you wish to use the "docker" method. For Ubuntu, you can use the following instructions for this: https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-20-04

• For OpenSuse (Leap 15), the following instructions can be used: https://www.linuxtechi.com/install-docker-on-opensuse-leap/

• cd to the ansible collection installation root directory (e.g. "cd ~/.ansible/collections/ansible_collections/dellemc/enterprise_sonic")

Running sanity tests

• ansible-tests sanity [--docker]

Running Unit and Coverage tests: Execution method 1 (using docker)

• ansible-test units --python python version --coverage --docker
• ansible-test coverage combine --export tests/output/coverage/
• ansible-test coverage report | tee <output file name>

Running Unit and Coverage tests: Execution method 2 (native package installation):

• ansible-test units --python python version --coverage --requirements
• ansible-test coverage report | tee <output file name>

---

NOTE: An example value for the python version value in the above execution methods is "3.10"

Additional information on running Unit Tests

https://docs.ansible.com/ansible/latest/dev_guide/testing_units.html#running-tests