gavinr/ github-csv-tools
About the developer
167 Stars 
50 Forks 
MIT License 
72 Commits 
6 Opened issues 
Description
Import and export GitHub issues via CSV
Services available
Contributors list
GitHub CSV Tools
Import and export GitHub issues via CSV
Usage
Prerequisite: Install Node.js, then run this to install:
npm install -g github-csv-tools
After install,
githubCsvTools --helpfor info on how to use, or see below.
Instructions for exporting or importing:
To Import Issues
Currently imports title, body, labels, status (closed or open) and milestones.
githubCsvTools myFile.csv
To Export Issues
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, createdat, updatedat, closed_at, body | Comma-separated list of attributes (columns) in the export*. | | -c, --exportComments | n/a | Include comments in the export. If using in combination with
--exportAttributes,
idmust be included. | | -e, --exportAll | n/a | Export all possible values from the GitHub API. If not included, a subset of attributes (see
--exportAttributesabove) that are known to be compatible with GitHub *import will be included in the export. |
** List of all possible options for
exportAttributesincludes every option in the GitHub API Export. Values in child objects can be referenced using a "dot" - for example, a user's
avatar_urlcan be accessed via
user.avatar_url.
Tokens
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.
Other Options
| 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 | | -o, --organization | The User or Organization slug that the repo lives under. | | -r, --repository | The repository name (slug). | | -v, --verbose | Include additional logging information. | | -h, --help | See all the options and help. |
Development
- Clone the repo.
- Browse to repo, then run
npm install -g
Changelog
See CHANGELOG.md