diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/example/hudson.txt | 36 |
1 files changed, 27 insertions, 9 deletions
diff --git a/doc/example/hudson.txt b/doc/example/hudson.txt index fcaf272..b2af055 100644 --- a/doc/example/hudson.txt +++ b/doc/example/hudson.txt @@ -15,13 +15,14 @@ using these steps: * configure your repository so that Hudson can pull it * (optional) configure multiple nodes so that tox-runs are performed on multiple hosts -* configure ``axes`` with e.g. using :ref:`TOXENV <TOXENV>` as an axis +* configure ``axes`` by using :ref:`TOXENV <TOXENV>` as an axis name and as values provide space-separated test environment names you want Hudson/tox to execute. -* add a Python-build step with this content:: + +* add a **Python-build step** with this content:: import tox - tox.cmdline() # environment is selected by the ``TOXENV`` setting above + tox.cmdline() # environment is selected by ``TOXENV`` env variable * check ``Publish JUnit test result report`` and enter ``**/junit-*.xml`` as the pattern so that Hudson collects @@ -30,16 +31,33 @@ using these steps: The last point requires that your test command creates JunitXML files, for example with ``py.test`` it is done like this: - commands= - py.test \ - --confcutdir=.. \ - --junitxml=junit-{envname}.xml + commands=py.test --junitxml=junit-{envname}.xml + +See a real-life example in action with the `pytest Hudson job`_ + +.. _`pytest Hudson job`: http://hudson.testrun.org/view/pytest/job/pytest/ + +Using toxbootstrap, the zero-installation feature for slaves +------------------------------------------------------------- +If you manage many Hudson slaves and want to use the latest tox release +(or development version of tox) you can substitute the **Python build step** +above with this code:: -See a real-life example in action with the `py-trunk-multi Hudson job`_ + import urllib, os + url = "https://pytox.googlecode.com/hg/toxbootstrap.py" + #os.environ['USETOXDEV']="1" # use tox dev version + s = urllib.urlopen(url).read() + co = compile(s, "toxbootstrap.py", 'exec') + exec co in {'__name__': '__main__', + '__file__': 'toxbootstrap.py'} -.. _`py-trunk-multi Hudson job`: http://hudson.testrun.org/view/pytest/job/py-trunk-multi/ +The `toxbootstrap.py`_ file download all neccessary files to install +``tox`` in a virtual sub environment. If you uncomment the line +containing ``USETOXDEV`` you are going to use the latest +development-release version of tox instead of the latest released version. +.. _`toxbootstrap.py`: https://pytox.googlecode.com/hg/toxbootstrap.py Integrating "sphinx" documentation checks in a Hudson job ---------------------------------------------------------------- |