Skip to main content

Python bindings for the remote Jenkins API

Project description

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

  • Create/delete/reconfig views

  • Put server in shutdown mode (quiet down)

  • List running builds

  • Delete builds

  • Wipeout job workspace

  • Create/delete/update folders [1]

  • Set the next build number [2]

  • Install plugins

  • and many more..

To install:

$ sudo python install

Online documentation:


Bug report:



Patches are submitted via Gerrit at:

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

The python-jenkins developers communicate in the #openstack-jjb channel on Freenode’s IRC network.

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

Writing a patch

Be sure that you lint code before created an code review. The easiest way to do this is to install git pre-commit hooks.

Installing without

Then install the required python packages using pip:

$ sudo pip install python-jenkins


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-jenkins-1.3.0.tar.gz (59.7 kB view hashes)

Uploaded Source

Built Distribution

python_jenkins-1.3.0-py2-none-any.whl (26.9 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page