Python API for managing jobs and nodes in a Jenkins CI instance
Go to file
Khai Do 0459f84956 Ensure request data is in the correct format
Ensure that the parameters passed to POST requests are in the correct format.
As with change Ia6ce75958bb, this change ensures that the parameters passed to
POST requests are in the correct format so the data needed to trigger the use
of POST won't result in an exception being thrown due to use of str instead
of unicode on python 3.

Change-Id: I542d56b6c392a8390d9eea6a860c798eade3f925
2015-05-22 11:09:31 -07:00
doc Fix examples 2015-03-18 15:39:25 -07:00
jenkins Ensure request data is in the correct format 2015-05-22 11:09:31 -07:00
tests Modify tests to exercise Request on python3 2015-05-15 12:24:52 +01:00
.coveragerc Add support for measuring coverage 2014-05-21 08:25:09 -07:00
.gitignore Use pbr, pep8 checks & fixes, add "doc" tox target 2014-07-02 14:12:31 -07:00
.gitreview Add a gitreview file 2014-07-02 10:14:04 -07:00
.testr.conf Use pbr, pep8 checks & fixes, add "doc" tox target 2014-07-02 14:12:31 -07:00
COPYING Added tags 2011-06-30 17:54:54 +01:00
MANIFEST.in Add MANIFEST.in 2014-08-22 11:29:08 -05:00
README.rst Doc Update: Fix formatting for inclusion of README.rst 2015-02-13 00:24:10 +00:00
requirements.txt Setup pbr versioning for docs 2014-09-26 09:12:54 -07:00
setup.cfg Doc Change: update supported python versions 2015-02-12 16:22:47 -08:00
setup.py Use pbr, pep8 checks & fixes, add "doc" tox target 2014-07-02 14:12:31 -07:00
test-requirements.txt testtools requires unittest2 2015-01-12 11:24:23 -08:00
tox.ini generate a code coverage html report 2014-09-30 13:48:28 -07:00

README.rst

README

Python Jenkins is a python wrapper for the Jenkins REST API which aims to provide a more conventionally pythonic way of controlling a Jenkins server. It provides a higher-level API containing a number of convenience functions.

We like to use python-jenkins to automate our Jenkins servers. Here are some of the things you can use it for:

  • Create new jobs
  • Copy existing jobs
  • Delete jobs
  • Update jobs
  • Get a job's build information
  • Get Jenkins master version information
  • Get Jenkins plugin information
  • Start a build on a job
  • Create nodes
  • Enable/Disable nodes
  • Get information on nodes
  • and many more..

To install:

$ sudo python setup.py install

Online documentation:

Developers

Bug report:

Repository:

Cloning:

Patches are submitted via Gerrit at:

Please do not submit GitHub pull requests, they will be automatically closed.

More details on how you can contribute is available on our wiki at:

Writing a patch

We ask that all code submissions be flake8 clean. The easiest way to do that is to run tox before submitting code for review in Gerrit. It will run flake8 in the same manner as the automated test suite that will run on proposed patchsets.

Installing without setup.py

Then install the required python packages using pip:

$ sudo pip install python-jenkins