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
258 Stars 66 Forks MIT License 76 Commits 13 Opened issues

Description

Import and export GitHub issues via CSV

Services available

!
?

Need anything else?

Contributors list

# 82,118
arcgis
HTML
leaflet...
Angular
48 commits
# 140,925
Shell
importe...
GitHub
github-...
5 commits
# 1,169
React N...
ugui
graysca...
fish-sh...
4 commits
# 5,360
PureScr...
node
plainte...
osx
1 commit
# 334,709
HTML
Shell
importe...
GitHub
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. https://your-internal-githubenterprise.com/api/v3 | | -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.