Testing¶
The jenkins-autojobs test suite needs a running Jenkins instance,
pre-configured with the git, hg and svn plugins. To save you some of
the trouble of doing that, there is an all-in-one script that will
download jenkins.war, bundle all necessary plugins and start a
local server on http://localhost:60888
.
$ cd jenkins-autojobs/tests
# start a jenkins server
$ bin/start-jenkins.sh
# if you want to gracefully shutdown the jenkins instance, either
# kill the start-jenkins.sh process or send a 0 to localhost:60887
# (60887 is the winstone control port)
$ killall start-jenkins.sh
$ echo 0 | nc 127.0.0.1 60887
$ cd jenkins-autojobs
# make sure that the jenkins_autojobs package is available on
# sys.path (python setup.py develop in a virtualenv)
# run all tests
$ py.test tests
# run only git tests
$ py.test tests/test_git.py
# run all tests for all supported versions of python
$ tox
Warning
The test suite removes all jobs on the Jenkins server prior to running any tests.
Todo¶
- The documentation still needs a lot of work.