opendev
/
infra-manual
Code Issues Proposed changes

Document tools/test-setup.sh 

Document how unit tests can be set up using tools/test-setup.sh.

Change-Id: Id156fe4f0f63c28ecd0b09ce42dd53938990db54
This commit is contained in:
Andreas Jaeger 2017-02-12 20:40:37 +01:00
parent 2e3a68253a
commit b7994abf09
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/source/drivers.rst
View File

@ -577,3 +577,19 @@ requirements for both test and runtime to the base profile::
libffi6
# A build time dependency
libffi-devel [test]
Unit Test Set up
================
Projects might need special set up for unit tests which can be done
via the script ``tools/test-setup.sh`` that needs to reside in the
repository.
Python unit tests are tests like ``coverage``, ``python27``,
``python35``, and ``pypy`` which are run using python's ``tox``
package as well as tests using the template
``gate-{name}-tox-{envlist}-{node}``. For these tests, the script
``tools/test-setup.sh`` is run if it exists in the repository and is
executable after package installation. The script has ``sudo`` access
and can set up the test environment as needed. For example, it should
be used to set up the ``openstack_citest`` databases for testing.