{ "info": { "author": "Brad Brown", "author_email": "brad@bradsbrown.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "GitHub Tools\n============\n\nA collection of tools around Git and GitHub to make developers' lives easier.\n\n- `gt-assign-pr`_\n- `gt-pr-doc-link`_\n\ngt-assign-pr\n------------\n\nA simple helper to assign a given PR to as set of users from the CLI.\n\nUsage\n~~~~~\n\nThis tool requires the use of a token (see `Using Tokens`_).\nBy simply providing a ``owner``, ``repository``, ``pr_number``\nand as many users as desired,\nyou can assign the given PR to those users.\nBy default, currently assigned users are kept,\nbut they can be removed using the ``--clear-current`` flag.\n\ngt-pr-doc-link\n--------------\n\nA simple helper to post a link to docs back to a PR when run in a Jenkins job.\n\nUsage\n~~~~~\n\nThis tool requires the use of a token (see `Using Tokens`_).\nIn addition,\nthis tool requires a ``BUILD_URL`` environment variable to be present\n(present automatically in a Jenkins job),\nand to have the docs already built\nand available via a URL subpath from the job URL,\nas would be generated by the `Jenkins HTML Publisher`_ plugin.\n\nUsing Tokens\n------------\n\nIn order to provide for maximum flexibility,\nthese tools are designed to work with GitHub Personal Access Tokens,\nwhich are needed for people using two-factor authentication\nor have access protected by SAML single sign on (SSO).\nGitHub provides instruction to `obtain a token`_.\nThe token can be provided to all commands\neither via the ``--token TOKEN`` flag,\nor by setting ``GH_TOKEN`` in your environment.\n\nCustom GitHub URL\n-----------------\n\nBy default, this project works with https://github.com.\nIn order to use an alternate URL, such as an enterprise install,\nyou can provide the URL via an environment variable: ``GT_GH_URL``.\n\npre-commit hooks\n================\n\nThis repository also provides three hooks, documented below,\nthat can be installed by hand or via `pre-commit`_:\n\ngt-commit-msg\n-------------\n\nEnsure that a commit message conforms to some best practices:\n\n#. Subject lines should not be longer than 50 characters\n#. Wrap the body at 72 characters\n#. Separate the subject from body with a blank line.\n\nThese are taken from `A Note About Git Commit Messages`_.\n\ngt-self-check\n-------------\n\nCan perform validations before making a commit.\nIf an executable file named ``self-check.sh`` exists\nin the root of the repository and a Python, Ruby, or Gherkin file was changed,\nthe checker is executed\nand the return status serves as a gate for the commit to occur.\nThe check can be bypassed via ``git commit -n``.\n\ngt-prepare-commit-msg\n---------------------\n\nPrepare a commit message by including an appropriate prefix,\nwhen possible, based on the branch name.\nIf the branch name contains a JIRA ID, that is included in the prefix.\nIf the branch name also contains either \"FF\" or \"Spike\",\nthat is appended to the prefix.\nIf a branch name, without including a JIRA ID,\ncontains \"FF\", \"Spike\", \"Enhancement\" or \"Fix\",\nthose phrases are set as the prefix.\nAll searches are case-insensitive.\n\n\n.. _`Jenkins HTML Publisher`: https://plugins.jenkins.io/htmlpublisher\n.. _`pre-commit`: https://pre-commit.com\n.. _`A Note About Git Commit Messages`: https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html\n.. _`obtain a token`: https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://jolly-good-toolbelt.github.io/jolly_github_toolbelt/", "keywords": "", "license": "MIT", "maintainer": "Brad Brown", "maintainer_email": "brad@bradsbrown.com", "name": "jolly-github-toolbelt", "package_url": "https://pypi.org/project/jolly-github-toolbelt/", "platform": "", "project_url": "https://pypi.org/project/jolly-github-toolbelt/", "project_urls": { "Documentation": "https://jolly-good-toolbelt.github.io/jolly_github_toolbelt/", "Homepage": "https://jolly-good-toolbelt.github.io/jolly_github_toolbelt/", "Repository": "https://github.com/jolly-good-toolbelt/jolly_github_toolbelt" }, "release_url": "https://pypi.org/project/jolly-github-toolbelt/2.1.0/", "requires_dist": [ "requests (>=2.10,<3.0)", "github3.py (>=1.1.0,<2.0.0)", "tomlkit (>=0.5.3,<0.6.0)" ], "requires_python": ">=3.6,<4.0", "summary": "A collection of tools around Git and GitHub to make developers' lives easier.", "version": "2.1.0" }, "last_serial": 5574601, "releases": { "2.1.0": [ { "comment_text": "", "digests": { "md5": "575ebb82df60d6c21943a15d18affa97", "sha256": "9467157870f4bec1d52887bcf8b9cb3885f02fcbbe8a2f8b798eb67c4f019d9b" }, "downloads": -1, "filename": "jolly_github_toolbelt-2.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "575ebb82df60d6c21943a15d18affa97", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 7663, "upload_time": "2019-07-17T23:31:47", "url": "https://files.pythonhosted.org/packages/27/7d/cb10a12db16cfd74a7621ee275f8b05c34a3a110e6bf5391104f4c6a4b34/jolly_github_toolbelt-2.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "22eadaf159c3b5a160ab7d4823bb5ad2", "sha256": "507d976df91da159071c56d59d3e3237f9e5bf3e3cc42f918e8e1c727cdd0030" }, "downloads": -1, "filename": "jolly_github_toolbelt-2.1.0.tar.gz", "has_sig": false, "md5_digest": "22eadaf159c3b5a160ab7d4823bb5ad2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 6941, "upload_time": "2019-07-17T23:31:49", "url": "https://files.pythonhosted.org/packages/1d/e5/15be43b22ce4dd8ec10a4a9efee0356eb042cc3a4bfa64254645dd569f90/jolly_github_toolbelt-2.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "575ebb82df60d6c21943a15d18affa97", "sha256": "9467157870f4bec1d52887bcf8b9cb3885f02fcbbe8a2f8b798eb67c4f019d9b" }, "downloads": -1, "filename": "jolly_github_toolbelt-2.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "575ebb82df60d6c21943a15d18affa97", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 7663, "upload_time": "2019-07-17T23:31:47", "url": "https://files.pythonhosted.org/packages/27/7d/cb10a12db16cfd74a7621ee275f8b05c34a3a110e6bf5391104f4c6a4b34/jolly_github_toolbelt-2.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "22eadaf159c3b5a160ab7d4823bb5ad2", "sha256": "507d976df91da159071c56d59d3e3237f9e5bf3e3cc42f918e8e1c727cdd0030" }, "downloads": -1, "filename": "jolly_github_toolbelt-2.1.0.tar.gz", "has_sig": false, "md5_digest": "22eadaf159c3b5a160ab7d4823bb5ad2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 6941, "upload_time": "2019-07-17T23:31:49", "url": "https://files.pythonhosted.org/packages/1d/e5/15be43b22ce4dd8ec10a4a9efee0356eb042cc3a4bfa64254645dd569f90/jolly_github_toolbelt-2.1.0.tar.gz" } ] }