docs: clarify local tox setup and unit test matrix usage

Document tox 4 requirement and PATH fix for --user installs so make
targets use the correct tox binary. Describe how to use selective
unit test environments instead of running the full matrix.

Signed-off-by: Geetika Kapoor <gkapoor@redhat.com>
This commit is contained in:
Geetika Kapoor
2026-06-09 13:44:46 +01:00
parent 9eb27d287f
commit 6d85ed42f1
2 changed files with 25 additions and 4 deletions

View File

@@ -27,6 +27,16 @@ Run unit tests with `tox-ansible` like so:
make test-unit
```
`make test-unit` runs the full matrix in parallel. For local development, run
one environment instead. If you installed tox with `--user`, put `~/.local/bin`
first on `PATH` before running `tox`. See [developing.md](developing.md).
```
tox -e unit-py3.11-2.16 --ansible --conf tox-ansible.ini
```
List available unit envs with `tox -f unit --ansible --conf tox-ansible.ini -l`.
### Running tests with ansible-test
In order to test changes with `ansible-test`, it is recommended to bind mount
@@ -135,4 +145,3 @@ ansible-playbook -i examples/inventory.kubevirt.yml examples/play-delete.yml
# terminate the environment
hack/e2e-setup.sh --cleanup
```