github-project-to-csv

Simple cli to export github v2 projects to csv

Usage

./github-project-to-csv.rb --project https://github.com/users/fiedl/projects/2 --output project.csv

If you do encounter errors here, please check the troubleshooting section to make sure you have the correct ruby version and gems installed.

Installation

1. Install the github cli: brew install gh
2. Clone this repo: git clone https://github.com/fiedl/github-project-to-csv.git

Using github personal access tokens

Instead of using the gh command-line client, this tool also supports github personal access tokens. However, github does only support classic personal access tokens for now; fine-grained tokens do not work, yet.

Create a classic token xxx at https://github.com/settings/tokens. Then:

./github-project-to-csv.rb --project https://github.com/users/fiedl/projects/2 --output project.csv --token xxx

Troubleshooting

This script requires ruby version 3.2 or higher

Your local ruby version is too old. Please update according to the ruby documentation.

require: cannot load such file

Some gems are missing locally. Run:

gem install pry httparty

Further Resources

• Github documentation on the projects api
• Introduction to GraphQL
• Understanding GraphQL Queries
• Github GraphQL Object Reference
• Github GraphQL API Explorer

Author and License

(c) 2023, Sebastian Fiedlschuster

MIT License