docs: how to run the testsuite using the dist package

This commit is contained in:
Thomas Waldmann 2024-02-08 17:23:52 +01:00
parent ca7338f5b6
commit 33393946b5
No known key found for this signature in database
GPG Key ID: 243ACFA951F78E01
1 changed files with 31 additions and 0 deletions

View File

@ -308,6 +308,37 @@ Important notes:
- When using ``--`` to give options to py.test, you MUST also give ``borg.testsuite[.module]``.
Running the tests (using the pypi package)
------------------------------------------
Since borg 1.4, it is also possible to run the tests without a development
environment, using the borgbackup dist package (downloaded from pypi.org or
github releases page)::
# optional: create and use a virtual env:
python3 -m venv env
. env/bin/activate
# install packages
pip install borgbackup
pip install pytest pytest-benchmark
# method A: use a pytest.ini
cat >pytest.ini <<<EOF
[pytest]
python_files = testsuite/*.py
markers = allow_cache_wipe
addopts = -rs --benchmark-skip
EOF
pytest --pyargs borg.testsuite
# method B: give the options via the cmdline (each time you invoke the tests):
pytest -rs --benchmark-skip -o 'python_files=testsuite/*.py' -o 'markers=allow_cache_wipe' --pyargs borg.testsuite
Adding a compression algorithm
------------------------------