Import and export GitHub issues via CSV
- Fix for UTF-8 CSV BOM(Byte Order Mark)
- Options Added
-u, --userOrOrganization Github user or organization (fork changes) -r, --repository Github repository (fork changes)
Prerequisite: Install Node.js, then run this to install:
npm install -g github-csv-tools
After install, githubCsvTools --help
for info on how to use, or see below.
Instructions for exporting or importing:
Currently imports title, description, labels, status (closed or open) and milestones.
githubCsvTools myFile.csv
githubCsvTools
Option | Default | Notes |
---|---|---|
-f, --exportFileName | YYYY-MM-DD-hh-mm-ss-issues.csv | The name of the CSV you'd like to export to. |
-a, --exportAttributes | number, title, labels, state, assignees, milestone, comments, created_at, updated_at, closed_at, body | Comma-separated list of attributes (columns) in the export**. |
-c, --exportComments | n/a | Include comments in the export. |
** List of all possible options for exportAttributes
: url
, repository_url
, labels_url
, comments_url
, events_url
, html_url
, id
, node_id
, number
, title
, user
, labels
, state
, locked
, assignee
, assignees
, milestone
, comments
, created_at
, updated_at
, closed_at
, author_association
, body
(more info)
For all actions, the tool will ask you to input a GitHub token. To obtain this token:
- Go to https://github.com/settings/tokens
- Click "Generate New Token"
- Check on
repo
- Copy/paste the token provided when the tool asks for it.
Option | Notes |
---|---|
-V, --version | output the version number |
-g, --github_enterprise | Your GitHub Enterprise URL. |
-t, --token | The GitHub token. https://github.com/settings/tokens |
-h, --help | See all the options and help. |
-u, --userOrOrganization | Github user or organization (fork changes) |
-r, --repository | Github repository (fork changes) |
- Clone the repo.
- Browse to repo, then run
npm install -g
See CHANGELOG.md