c58ae7e1af
Split existing tests into separate files and classes to make it easier to select a subset to be executed when making modifications. Add some simple consolidations of test data as example improvements that can be extended by consolidating complete tests or sets of tests. Change-Id: If2380e6f4e848ba68f05868e2ef4186d7912952b
1.5 KiB
- title
-
Installing
Installing
The module is known to pip and Debian-based distributions as
python-jenkins.
pip:
pip install python-jenkinseasy_install:
easy_install python-jenkinsThe module has been packaged since Ubuntu Oneiric (11.10):
apt-get install python-jenkinsAnd on Fedora 19 and later:
yum install python-jenkinsFor development:
python setup.py developDocumentation
Documentation is included in the doc folder. To generate
docs locally execute the command:
tox -e docsThe generated documentation is then available under
doc/build/html/index.html.
Unit Tests
Unit tests have been included and are in the tests
folder. We recently started including unit tests as examples in our
documentation so to keep the examples up to date it is very important
that we include unit tests for every module. To run the unit tests,
execute the command:
tox -e py27- Note: View
tox.inito run tests on other versions of Python.
Due to how the tests are split up into a dedicated class per API
method, it is possible to execute tests against a single API at a time.
To execute the tests for the :py.Jenkins.get_version API execute the command:
tox -e py27 -- tests.test_version.JenkinsVersionTestFor further details on how to list tests available and different ways to execute them, see https://wiki.openstack.org/wiki/Testr.
Test Coverage
To measure test coverage, execute the command:
tox -e cover