Michael Still
d1e4696495
|
12 months ago | |
|---|---|---|
| doc | 5 years ago | |
| jenkins | 12 months ago | |
| tests | 1 year ago | |
| .coveragerc | 6 years ago | |
| .gitignore | 5 years ago | |
| .gitreview | 4 years ago | |
| .pre-commit-config.yaml | 5 years ago | |
| .stestr.conf | 5 years ago | |
| .zuul.yaml | 3 years ago | |
| COPYING | 12 years ago | |
| MANIFEST.in | 8 years ago | |
| README.rst | 2 years ago | |
| bindep.txt | 5 years ago | |
| requirements.txt | 5 years ago | |
| setup.cfg | 2 years ago | |
| setup.py | 9 years ago | |
| test-requirements.txt | 3 years ago | |
| tox.ini | 2 years ago | |
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
- Create/delete/reconfig views
- Put server in shutdown mode (quiet down)
- List running builds
- Delete builds
- Wipeout job workspace
- Create/delete/update folders1
- Set the next build number2
- Install plugins
- and many more..
To install:
$ sudo python setup.py installOnline documentation:
Developers
Bug report:
Repository:
Cloning:
- git clone https://opendev.org/jjb/python-jenkins
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 setup.py
Then install the required python packages using pip:
$ sudo pip install python-jenkinsFootnotes
The free Cloudbees Folders Plugin provides support for a subset of the full folders functionality. For the complete capabilities you will need the paid for version of the plugin.↩︎
The Next Build Number Plugin provides support for setting the next build number.↩︎