README.md

ghissue

Bulk-upload GitHub Issues

About

Bulk-upload as easy as

brew install hcgatewood/ghissue/ghissue
ghissue create issues.txt

Howto

Input format

The input file contains a repo target, followed by hyphen-separated issues.

The first line of each issue contains metadata, while all following lines comprise the Issue body. Labels, assignees, and body are optional.

repo_owner/repo_name
---
Title | Labels | Assignees
Body
---
Title | Labels | Assignees
Body
---
Title | Labels | Assignees
Body

Overview

Walkthrough

Prerequisites

• Install ghissue brew install hcgatewood/ghissue/ghissue
• Create a GitHub personal access token and save its contents to the GITHUB_TOKEN environment variable
• Replace hcgatewood23/test below with a repo to which you have write access

We'll create two issues: a self-assigned feature request and a bug report. Place the following into a file named issues.txt

hcgatewood23/test
---
Update the README | feature,milestone4 | hcgatewood23
Update readme with examples.

Add note that Issue body can contain multiple lines.
---
Fix CLI bug | bug
Bug report: CLI needs to be fixed. Someone please claim.

Now bulk-create the Issues

$ ghissue create issues.txt --open

22,23

Notes

Install

Preferred installation method via Homebrew

brew install hcgatewood/ghissue/ghissue

If you can't or don't want to use Homebrew, consider these additional install methods

• go get -u github.com/hcgatewood/ghissue install via Go
• go run github.com/hcgatewood/ghissue don't install, run directly via Go
• Check out the per-release assets
• Compile from source

More examples

See testdata/ for more examples.

CLI

CLI flags for the create command

--byline   Append hcgatewood/ghissue byline to Issue body (default true)
--dryrun   Don't actually create the Issues
--help     help for create
--info     Print more info about the Issues
--open     Open browser to view new Issues

Note: can disable the byline with --byline=false.