{"id":18085051,"url":"https://github.com/jwodder/mkissues","last_synced_at":"2025-04-06T00:14:06.282Z","repository":{"id":200807087,"uuid":"706288205","full_name":"jwodder/mkissues","owner":"jwodder","description":"Create GitHub issues from text files","archived":false,"fork":false,"pushed_at":"2025-01-23T14:39:10.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-21T00:21:28.508Z","etag":null,"topics":["github","github-issues","github-repository-management","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jwodder.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-17T16:45:30.000Z","updated_at":"2025-01-23T14:39:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"52cb9c03-6b6f-4c28-81cf-78d375eebc68","html_url":"https://github.com/jwodder/mkissues","commit_stats":null,"previous_names":["jwodder/mkissues"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwodder%2Fmkissues","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwodder%2Fmkissues/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwodder%2Fmkissues/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwodder%2Fmkissues/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jwodder","download_url":"https://codeload.github.com/jwodder/mkissues/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247415966,"owners_count":20935387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","github-issues","github-repository-management","python"],"created_at":"2024-10-31T15:09:12.793Z","updated_at":"2025-04-06T00:14:06.263Z","avatar_url":"https://github.com/jwodder.png","language":"Python","readme":"|repostatus| |ci-status| |license|\n\n.. |repostatus| image:: https://www.repostatus.org/badges/latest/concept.svg\n    :target: https://www.repostatus.org/#concept\n    :alt: Project Status: Concept – Minimal or no implementation has been done\n          yet, or the repository is only intended to be a limited example,\n          demo, or proof-of-concept.\n\n.. |ci-status| image:: https://github.com/jwodder/mkissues/actions/workflows/test.yml/badge.svg\n    :target: https://github.com/jwodder/mkissues/actions/workflows/test.yml\n    :alt: CI Status\n\n.. |license| image:: https://img.shields.io/github/license/jwodder/mkissues.svg\n    :target: https://opensource.org/licenses/MIT\n    :alt: MIT License\n\n`GitHub \u003chttps://github.com/jwodder/mkissues\u003e`_\n| `Issues \u003chttps://github.com/jwodder/mkissues/issues\u003e`_\n\n``mkissues`` is a command for creating GitHub issues from local Markdown files\nformatted with special headers.\n\n\nInstallation\n============\n``mkissues`` requires Python 3.10 or higher.  Just use `pip\n\u003chttps://pip.pypa.io\u003e`_ for Python 3 (You have pip, right?) to install it::\n\n    python3 -m pip install git+https://github.com/jwodder/mkissues.git\n\n\nUsage\n=====\n\n::\n\n    mkissues [\u003coptions\u003e] [\u003cfile\u003e ...]\n\n``mkissues`` creates a GitHub issue from each file specified on the command\nline; see \"`File Format`_\" below.  Issues can be created with specific labels\nand/or milestones; if a file specifies a label or milestone that does not yet\nexist in the repository, the label or milestone is created.  After an issue is\ncreated, its file is either moved to a separate directory or deleted, depending\non the options passed to the ``mkissues`` command.\n\nBy default, ``mkissues`` creates issues in the GitHub repository listed as the\n``origin`` remote for the Git repository in the current directory; a different\nGitHub repository can be specified via the ``-R``/``--repository`` option.\n\n\nFile Format\n-----------\n\nEach input file must be a UTF-8 text file that starts with one or more \"Name:\nValue\" header lines.  The header may optionally be followed by a blank line,\neverything after which becomes the body of the new issue.\n\nThe following headers (case insensitive) are recognized.  Unknown headers are\nan error.\n\n``Title``\n    *(required)* The title for the new issue\n\n``Labels``\n    A list of comma-separated labels to apply to the new issue\n\n``Milestone``\n    The name of a milestone to set for the new issue\n\n\nOptions\n-------\n\n--delete                        Delete each input file after processing.\n\n                                This option is mutually exclusive with\n                                ``--done-dir``.\n\n--done-dir DIR                  Move each input file to the given directory\n                                after processing.  This is the default\n                                behavior.  [default directory: ``DONE/``]\n\n                                This option is mutually exclusive with\n                                ``--delete``.\n\n-l LEVEL, --log-level LEVEL     Set the log level to the given value.  Possible\n                                values are \"``CRITICAL``\", \"``ERROR``\",\n                                \"``WARNING``\", \"``INFO``\", \"``DEBUG``\" (all\n                                case-insensitive) and their Python integer\n                                equivalents.  [default: ``INFO``]\n\n-R SPEC, --repository SPEC      Operate on the specified GitHub repository.  A\n                                repository can be specified in the form\n                                ``OWNER/NAME`` (or, when ``OWNER`` is the\n                                authenticated user, just ``NAME``) or as a\n                                GitHub repository URL.\n\nAuthentication\n--------------\n\n``mkissues`` requires a GitHub access token with appropriate permissions in\norder to run.  Specify the token via the ``GH_TOKEN`` or ``GITHUB_TOKEN``\nenvironment variable (possibly in an ``.env`` file), by storing a token with\nthe ``gh`` or ``hub`` command, or by setting the ``hub.oauthtoken`` Git config\noption in your ``~/.gitconfig`` file.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwodder%2Fmkissues","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjwodder%2Fmkissues","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwodder%2Fmkissues/lists"}