Metadata-Version: 2.1
Name: jenkins-python-lib
Version: 0.0.1.dev2
Summary: Python bindings for the remote Jenkins API
Home-page: https://opendev.org/jjb/python-jenkins
Author: Ken Conley
Author-email: kwc@willowgarage.com
Maintainer: Python-Jenkins Developers
Maintainer-email: python-jenkins-developers@lists.launchpad.net
License: BSD
Project-URL: Documentation, https://python-jenkins.readthedocs.io/
Platform: UNKNOWN
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
License-File: COPYING
License-File: AUTHORS

README
======

Python Jenkins is a python wrapper for the `Jenkins <http://jenkins-ci.org/>`_
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 [#f1]_
* Set the next build number [#f2]_
* Install plugins
* and many more..

To install::

    $ sudo python setup.py install

Online documentation:

* http://python-jenkins.readthedocs.org/en/latest/

Developers
----------
Bug report:

* https://bugs.launchpad.net/python-jenkins

Repository:

* https://opendev.org/jjb/python-jenkins

Cloning:

* git clone https://opendev.org/jjb/python-jenkins

Patches are submitted via Gerrit at:

* https://review.opendev.org/#/q/project:jjb/python-jenkins

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:

* https://docs.opendev.org/opendev/infra-manual/latest/developers.html

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 jenkins-python-lib

.. _tox: https://testrun.org/tox
.. _pip: https://pypi.org/project/pip
.. _pre-commit: https://pre-commit.com/#install


.. rubric:: Footnotes

.. [#f1] The free `Cloudbees Folders Plugin
    <https://wiki.jenkins-ci.org/display/JENKINS/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.

.. [#f2] The `Next Build Number Plugin
   <https://wiki.jenkins-ci.org/display/JENKINS/Next+Build+Number+Plugin>`_
   provides support for setting the next build number.



