Need help with github-csv-tools?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

gavinr
167 Stars 50 Forks MIT License 72 Commits 6 Opened issues

Description

Import and export GitHub issues via CSV

Services available

!
?

Need anything else?

Contributors list

# 88,969
arcgis
HTML
leaflet...
Angular
47 commits
# 143,918
Shell
C++
C
importe...
5 commits
# 1,606
ugui
graysca...
fish-sh...
cypress
3 commits
# 5,221
PureScr...
Electro...
plainte...
osx
1 commit
# 447,580
HTML
Shell
CSS
importe...
1 commit

GitHub CSV Tools

Import and export GitHub issues via CSV

Build Release npm latest version

Usage

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:

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
,
id
must be included. | | -e, --exportAll | n/a | Export all possible values from the GitHub API. If not included, a subset of attributes (see
--exportAttributes
above) that are known to be compatible with GitHub *import
will be included in the export. |

** List of all possible options for

exportAttributes
includes every option in the GitHub API Export. Values in child objects can be referenced using a "dot" - for example, a user's
avatar_url
can be accessed via
user.avatar_url
.

Tokens

For all actions, the tool will ask you to input a GitHub token. To obtain this token:

  1. Go to https://github.com/settings/tokens
  2. Click "Generate New Token"
  3. Check on
    repo
  4. 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

  1. Clone the repo.
  2. Browse to repo, then run
    npm install -g

Changelog

See CHANGELOG.md

Thanks

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.