{ "info": { "author": "alfredo deza", "author_email": "contact [at] deza [dot] pe", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "A Jenkins plugin for helga chat bot\n===================================\n\nAbout\n-----\n\nHelga is a Python chat bot. Full documentation can be found at\nhttp://helga.readthedocs.org.\n\nThis Jenkins plugin allows Helga to run Jenkins playbooks from IRC and return\ninformation when they succeed or fail.\nFor example::\n\n 03:14 < alfredodeza> !jenkins ceph version=0.80.8.1 branch=rhcs-v0.80.8 release=stable clean=true\n 03:14 < helgabot> running: ceph jop at http://jenkins.example.com/job/ceph/323\n\n\nFailed builds will report back minimal information with an optional paste of\nthe log::\n\n 03:17 < helgabot> alfredodeza: build ceph/323 failed. Details at http://jenkins.example.com/job/ceph/323/console\n\nSuccessful runs will also report back to the user::\n\n 03:19 < helgabot> alfredodeza: build ceph/323 suceeded!\n\nInstallation\n------------\nThis Jenkins plugin is `available from PyPI\n`_, so you can simply install it\nwith ``pip``::\n\n pip install helga-jenkins\n\nIf you want to hack on the helga-jenkins source code, in your virtualenv where\nyou are running Helga, clone a copy of this repository from GitHub and run\n``python setup.py develop``.\n\nConfiguration\n=============\nIn your ``settings.py`` file (or whatever you pass to ``helga --settings``),\nyou can configure a few general things like credentials and Jenkins locations.\n\nIn most cases, the plugin will only be configured for a single Jenkins\ninstance, but there is support for multiple instances if configured to do so.\n\nSingle Instance\n---------------\nA single instance can be configured as follows (listed with some defaults)::\n\n # simple authentication\n JENKINS_USERNAME = \"alfredodeza\"\n JENKINS_PASSWORD = \"ElCapitano2\"\n\n # Jenkins url\n JENKINS_URL = \"http://jenkins.example.com\"\n\n # for multiple auth/tokens, define a 'credentials' dictionary\n JENKINS_CREDENTIALS = {\n \"alfredodeza\": {\n \"username\": \"adeza\",\n \"token\": \"33b3ffadgg3v61g1bfd6fd8543df50e4\",\n }\n }\n\nFor multiple users, it is useful to map IRC nicks to usernames in Jenkins,\nallowing a user to have different usernames (often the case).\n\nMultiple Instances\n------------------\nFor multiple instances, it is required to have defined a key that holds the\ninformation for connections and users::\n\n # Multiple Jenkins\n MULTI_JENKINS = {\n \"test\": {\n # URL is always required\n 'url': 'http://test_jenkins.example.com',\n 'credentials': {\n \"alfredodeza\": {\n \"username\": \"adeza\",\n \"token\": \"33b3ffadgg3v61g1bfd6fd8543df50e4\",\n },\n \"ktdreyer\": {\n \"username\": \"kdreyer\",\n \"token\": \"44bh4gggg3dkjasdweiuhr780wer234ss\",\n }\n },\n \"prod\": {\n # if no credentials per-user is supplied, define a global one that\n # any user can use\n 'url': 'http://test_jenkins.example.com',\n 'username': 'admin',\n 'password': 'secret',\n }\n\nNote that each key in ``MULTI_JENKINS`` will equate to a supported command when\ninvoking it on IRC, for example::\n\n !ci test build test-job\n\nWhere *test* is a configured Jenkins instance. Or::\n\n !ci prod build other-job\n\nEither ``credentials`` (with IRC nicks as keys, as username and tokens) or\n``username`` and ``password`` must exist, the bot will fallback from one to the\nother depending on what is defined and available to connect.\n\nsub commands\n------------\nThere are a few commands that are allowed, you can trigger their exampe usage\nat any time with::\n\n !ci help {command}\n\nThis is a list of all the available ones with a short description of what they\ndo (most of them will require a job name argument at the very least):\n\n* `enable`: Enable a disabled job.\n* `disable`: Disable an enabled job.\n* `build`: Trigger a job build, will probably need authentication.\n* `health`: Report on the current health of a job.\n* `builds`: Report on the last builds of a job\n", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/alfredodeza/helga-jenkins", "keywords": "irc bot jenkins", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "helga-jenkins", "package_url": "https://pypi.org/project/helga-jenkins/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/helga-jenkins/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/alfredodeza/helga-jenkins" }, "release_url": "https://pypi.org/project/helga-jenkins/0.0.5/", "requires_dist": null, "requires_python": null, "summary": "jenkins plugin for helga", "version": "0.0.5" }, "last_serial": 2153641, "releases": { "0.0.2": [ { "comment_text": "", "digests": { "md5": "f2e9de0efa1d01be85d5992b98631ebf", "sha256": "28484ed69c6514e153ae78a8f1b0eb98eb65ea72c1530d7cfd3b818efda3507e" }, "downloads": -1, "filename": "helga-jenkins-0.0.2.tar.gz", "has_sig": false, "md5_digest": "f2e9de0efa1d01be85d5992b98631ebf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3803, "upload_time": "2015-09-21T14:50:34", "url": "https://files.pythonhosted.org/packages/94/7d/05281247bc1baa54e38bcc694a3cfe14fb2270bf2b56e1bc7b277b19be0a/helga-jenkins-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "d5df65c418c5e7858449a8e13a6aca9d", "sha256": "c22654696def4a3e1e104b7ade6e5afe21837882661573e23e89516a52b53d4d" }, "downloads": -1, "filename": "helga-jenkins-0.0.3.tar.gz", "has_sig": false, "md5_digest": "d5df65c418c5e7858449a8e13a6aca9d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7658, "upload_time": "2015-11-24T18:42:03", "url": "https://files.pythonhosted.org/packages/b4/88/fbbeb11e47727cd82649f01550742b9de0e0d108ad93b2b94f77c8db3f98/helga-jenkins-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "92b3ac3ffece39f036e302d0471f4e07", "sha256": "61abec7bead2ba16ce7d1896f5e68198bfe2a51300e90e22ee5b4ae214e6a716" }, "downloads": -1, "filename": "helga-jenkins-0.0.4.tar.gz", "has_sig": false, "md5_digest": "92b3ac3ffece39f036e302d0471f4e07", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3985, "upload_time": "2015-11-25T20:31:31", "url": "https://files.pythonhosted.org/packages/bb/d2/6d89b88f118617d25a6a8808603cdff27bb15c099bb14eff3e3c8719e0c1/helga-jenkins-0.0.4.tar.gz" } ], "0.0.5": [ { "comment_text": "", "digests": { "md5": "c6162610f66eca8f600a55467c830fa8", "sha256": "beafdddcb656d90a079d19f731407e63aa2fc987a8eae9fd2fadc78e84eb0624" }, "downloads": -1, "filename": "helga-jenkins-0.0.5.tar.gz", "has_sig": false, "md5_digest": "c6162610f66eca8f600a55467c830fa8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3995, "upload_time": "2016-06-06T19:21:27", "url": "https://files.pythonhosted.org/packages/9e/cc/111453b83bfb9eecd0f73cae41dc5cdbe50b790f71eba97918ab47b5ae48/helga-jenkins-0.0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c6162610f66eca8f600a55467c830fa8", "sha256": "beafdddcb656d90a079d19f731407e63aa2fc987a8eae9fd2fadc78e84eb0624" }, "downloads": -1, "filename": "helga-jenkins-0.0.5.tar.gz", "has_sig": false, "md5_digest": "c6162610f66eca8f600a55467c830fa8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3995, "upload_time": "2016-06-06T19:21:27", "url": "https://files.pythonhosted.org/packages/9e/cc/111453b83bfb9eecd0f73cae41dc5cdbe50b790f71eba97918ab47b5ae48/helga-jenkins-0.0.5.tar.gz" } ] }