python-jenkins


Namepython-jenkins JSON
Version 1.8.2 PyPI version JSON
download
home_pagehttps://opendev.org/jjb/python-jenkins
SummaryPython bindings for the remote Jenkins API
upload_time2023-11-09 10:20:09
maintainerPython-Jenkins Developers
docs_urlhttps://pythonhosted.org/python-jenkins/
authorKen Conley
requires_python
licenseBSD
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            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 python-jenkins

.. _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.




            

Raw data

            {
    "_id": null,
    "home_page": "https://opendev.org/jjb/python-jenkins",
    "name": "python-jenkins",
    "maintainer": "Python-Jenkins Developers",
    "docs_url": "https://pythonhosted.org/python-jenkins/",
    "requires_python": "",
    "maintainer_email": "python-jenkins-developers@lists.launchpad.net",
    "keywords": "",
    "author": "Ken Conley",
    "author_email": "kwc@willowgarage.com",
    "download_url": "https://files.pythonhosted.org/packages/45/ac/2bc1d844609302f7f907594961ffba7d6edd5848705f958683a9c2d87901/python-jenkins-1.8.2.tar.gz",
    "platform": null,
    "description": "README\n======\n\nPython Jenkins is a python wrapper for the `Jenkins <http://jenkins-ci.org/>`_\nREST API which aims to provide a more conventionally pythonic way of controlling\na Jenkins server.  It provides a higher-level API containing a number of\nconvenience functions.\n\nWe like to use python-jenkins to automate our Jenkins servers. Here are some of\nthe things you can use it for:\n\n* Create new jobs\n* Copy existing jobs\n* Delete jobs\n* Update jobs\n* Get a job's build information\n* Get Jenkins master version information\n* Get Jenkins plugin information\n* Start a build on a job\n* Create nodes\n* Enable/Disable nodes\n* Get information on nodes\n* Create/delete/reconfig views\n* Put server in shutdown mode (quiet down)\n* List running builds\n* Delete builds\n* Wipeout job workspace\n* Create/delete/update folders [#f1]_\n* Set the next build number [#f2]_\n* Install plugins\n* and many more..\n\nTo install::\n\n    $ sudo python setup.py install\n\nOnline documentation:\n\n* http://python-jenkins.readthedocs.org/en/latest/\n\nDevelopers\n----------\nBug report:\n\n* https://bugs.launchpad.net/python-jenkins\n\nRepository:\n\n* https://opendev.org/jjb/python-jenkins\n\nCloning:\n\n* git clone https://opendev.org/jjb/python-jenkins\n\nPatches are submitted via Gerrit at:\n\n* https://review.opendev.org/#/q/project:jjb/python-jenkins\n\nPlease do not submit GitHub pull requests, they will be automatically closed.\n\nThe python-jenkins developers communicate in the ``#openstack-jjb`` channel\non Freenode's IRC network.\n\nMore details on how you can contribute is available on our wiki at:\n\n* https://docs.opendev.org/opendev/infra-manual/latest/developers.html\n\nWriting a patch\n---------------\n\nBe sure that you lint code before created an code review.\nThe easiest way to do this is to install git pre-commit_ hooks.\n\nInstalling without setup.py\n---------------------------\n\nThen install the required python packages using pip_::\n\n    $ sudo pip install python-jenkins\n\n.. _tox: https://testrun.org/tox\n.. _pip: https://pypi.org/project/pip\n.. _pre-commit: https://pre-commit.com/#install\n\n\n.. rubric:: Footnotes\n\n.. [#f1] The free `Cloudbees Folders Plugin\n    <https://wiki.jenkins-ci.org/display/JENKINS/CloudBees+Folders+Plugin>`_\n    provides support for a subset of the full folders functionality. For the\n    complete capabilities you will need the paid for version of the plugin.\n\n.. [#f2] The `Next Build Number Plugin\n   <https://wiki.jenkins-ci.org/display/JENKINS/Next+Build+Number+Plugin>`_\n   provides support for setting the next build number.\n\n\n\n",
    "bugtrack_url": null,
    "license": "BSD",
    "summary": "Python bindings for the remote Jenkins API",
    "version": "1.8.2",
    "project_urls": {
        "Documentation": "https://python-jenkins.readthedocs.io/",
        "Homepage": "https://opendev.org/jjb/python-jenkins"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f98fba846ae570e6d8a3830e9755e7cbb9bc67332bdc2da502bcac4d35f97ed3",
                "md5": "7bbd1f459926e6d946eb8e198110f474",
                "sha256": "585c9a25042892ce224dcddb1d4b9ff29755ca63da03ac2ce96537d373c0233e"
            },
            "downloads": -1,
            "filename": "python_jenkins-1.8.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7bbd1f459926e6d946eb8e198110f474",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 29091,
            "upload_time": "2023-11-09T10:20:07",
            "upload_time_iso_8601": "2023-11-09T10:20:07.826208Z",
            "url": "https://files.pythonhosted.org/packages/f9/8f/ba846ae570e6d8a3830e9755e7cbb9bc67332bdc2da502bcac4d35f97ed3/python_jenkins-1.8.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "45ac2bc1d844609302f7f907594961ffba7d6edd5848705f958683a9c2d87901",
                "md5": "fc0ea3ebb5b4da6ee018c2d3c8fd89fa",
                "sha256": "56e7dabb0607bdb8e1d6fc6d2d4301abedbed9165da2b206facbd3071cb6eecb"
            },
            "downloads": -1,
            "filename": "python-jenkins-1.8.2.tar.gz",
            "has_sig": false,
            "md5_digest": "fc0ea3ebb5b4da6ee018c2d3c8fd89fa",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 66548,
            "upload_time": "2023-11-09T10:20:09",
            "upload_time_iso_8601": "2023-11-09T10:20:09.366625Z",
            "url": "https://files.pythonhosted.org/packages/45/ac/2bc1d844609302f7f907594961ffba7d6edd5848705f958683a9c2d87901/python-jenkins-1.8.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-11-09 10:20:09",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "python-jenkins"
}
        
Elapsed time: 0.14078s