{ "info": { "author": "Ewen McCahon", "author_email": "ewen.m.mccahon@student.uts.edu.au", "bugtrack_url": null, "classifiers": [], "description": "# JIRAPy\nPython Library for reading JIRA Data from JSON API\n\n### What Does it Do\nWhen building apps that integrate with JIRA using its API, its often repetitive to parse and read out data from the objects you're sent. JIRAPy handles the parsing and storing of data so that you can access it with easy to use handlers like `jiraticket.summary` or `jiraticket.tags`, and since it uses native Python data formats and objects, filtering through data is as simple as `for tag in jiraticket.tags`.\n\nIt also includes a few convenience functions to make basic operations in Python more friendly, including the `add_comment()` function which when provided with a valid User/Pass combination can post comments to the remote JIRA instance for that ticket. If you need to comment on a JIRA with Self-Signed SSL, see the section 'My JIRA Uses Self-Signed Certificates'\n\nJIRAPy works with data you already have, either from the APIs or from a WebHook. If you want a complete integration with a running JIRA instance that can pull down data for you, I highly recommend the [PyContribs](https://github.com/pycontribs) Package '[Jira](https://github.com/pycontribs/jira)' which provides a fantastic, complete, drop in solution.\n\n### Why\nI was writing bots to automatically perform actions when a ticket was raised to our board and found that I was recreating the same functions every time I created a new bot. This keeps all the helpers in an easy to import class.\n\n### How Do I Install It\nFor now, you need to clone this Git repo and copy it into your project, but soon you'll be able to run `pip install jirapy` to get it anywhere.\n\n### How Do I Use It\nImport the class(es) you require from the module:\n\n`from jirapy import JiraTicket`\n\nthen create a JIRA object from data returned from the API:\n\n```\nticketdata = get_ticket(\"https://neko-design.jira.com/api/rest/2/issue/jirapy-1\")\njiraticket = JiraTicket(ticketdata)\n```\n\nand now you can read back values from the data:\n\n```\nprint jiraticket.summary\n> Ticket Summary\nprint jiraticket.reporter\n> E. Neko\njiraticket.add_comment(\"Updated System, Please Check\", \"username\", \"password\")\n> 200\n```\n\n### My JIRA Uses Self-Signed Certificates\nI've included the option to turn off SSL Verification for the comments feature. When you create the JiraTicket object, set the optional `verifyssl` parameter to `False`:\n\n```\nticketdata = get_ticket(\"https://neko-design.jira.com/api/rest/2/issue/jirapy-1\")\njiraticket = JiraTicket(ticketdata, False)\n# Or with a Named Parameter\njiraticket = JiraTicket(ticketdata, verifyssl=False)\n```\n\n### Testing\nTo run the tests, launch `tests/ticketTest.py` and it will run though the expected values, producing a report similar to the below:\n\n```\nbash-3.2$ python ticketTest.py\nWARNING:root:Ticket Has no Labels\nWARNING:root:Ticket Has no Components\n [INFO] Starting JIRAPy Tests\n [INFO] ---------------------------------------------\n [INFO] TEST Ticket Summary SUCCESS\n [INFO] TEST Ticket Description SUCCESS\n [INFO] TEST Ticket Key SUCCESS\n [INFO] TEST Ticket URL SUCCESS\n [INFO] TEST Ticket Reporter SUCCESS\n [INFO] TEST Ticket Status SUCCESS\n [INFO] TEST Ticket Labels SUCCESS\n [INFO] TEST Ticket Labels (Empty) SUCCESS\n [INFO] TEST Ticket Components SUCCESS\n [INFO] TEST Ticket Components (Empty) SUCCESS\n [INFO] ---------------------------------------------\n [INFO] 0 Tests Failed. 10 Passed.\n [INFO] TESTS PASSED. All Tests Passed\n```\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/Neko-Design/jirapy", "keywords": "jira,api,wrapper,interface,webhooks,comments", "license": "APACHE2", "maintainer": null, "maintainer_email": null, "name": "jirapy", "package_url": "https://pypi.org/project/jirapy/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/jirapy/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/Neko-Design/jirapy" }, "release_url": "https://pypi.org/project/jirapy/0.1/", "requires_dist": null, "requires_python": null, "summary": "JIRA Data Wrapper for Easy WebHook Handling", "version": "0.1" }, "last_serial": 2821359, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "02ed391ea6351558ced11c14bfc48cf8", "sha256": "de484a94df60b3880712309ca2c9e0fb352c5cf07cbe77ed035101bac4942683" }, "downloads": -1, "filename": "jirapy-0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "02ed391ea6351558ced11c14bfc48cf8", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 7241, "upload_time": "2017-04-22T08:00:24", "url": "https://files.pythonhosted.org/packages/c4/39/6c86dd8bf5461901353de0db85c77dbe3dd9464e5c10d922909733cabbf0/jirapy-0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3c2ad6ca14af8ed2327df8913377fbdd", "sha256": "864c6f9821b9749a26bb98b5981dbef103e199341ab2c8c31fcdb2af31ed19f7" }, "downloads": -1, "filename": "jirapy-0.1.tar.gz", "has_sig": false, "md5_digest": "3c2ad6ca14af8ed2327df8913377fbdd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7224, "upload_time": "2017-04-22T08:00:26", "url": "https://files.pythonhosted.org/packages/0b/41/e6d8d2ad39fa7d9d69afc02d8203dff8b5b0576469251ce260c9aad601af/jirapy-0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "02ed391ea6351558ced11c14bfc48cf8", "sha256": "de484a94df60b3880712309ca2c9e0fb352c5cf07cbe77ed035101bac4942683" }, "downloads": -1, "filename": "jirapy-0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "02ed391ea6351558ced11c14bfc48cf8", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 7241, "upload_time": "2017-04-22T08:00:24", "url": "https://files.pythonhosted.org/packages/c4/39/6c86dd8bf5461901353de0db85c77dbe3dd9464e5c10d922909733cabbf0/jirapy-0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3c2ad6ca14af8ed2327df8913377fbdd", "sha256": "864c6f9821b9749a26bb98b5981dbef103e199341ab2c8c31fcdb2af31ed19f7" }, "downloads": -1, "filename": "jirapy-0.1.tar.gz", "has_sig": false, "md5_digest": "3c2ad6ca14af8ed2327df8913377fbdd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7224, "upload_time": "2017-04-22T08:00:26", "url": "https://files.pythonhosted.org/packages/0b/41/e6d8d2ad39fa7d9d69afc02d8203dff8b5b0576469251ce260c9aad601af/jirapy-0.1.tar.gz" } ] }