{"id":15586645,"url":"https://github.com/fiedl/github-project-to-csv","last_synced_at":"2025-04-24T04:43:52.479Z","repository":{"id":146300159,"uuid":"594085383","full_name":"fiedl/github-project-to-csv","owner":"fiedl","description":"Simple cli to export github v2 projects to csv","archived":false,"fork":false,"pushed_at":"2023-07-13T20:06:04.000Z","size":38,"stargazers_count":22,"open_issues_count":2,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-24T04:43:45.635Z","etag":null,"topics":["github-projects"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fiedl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-27T15:10:00.000Z","updated_at":"2025-03-19T07:34:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"6b0b84d4-5705-42fe-92cb-71f63b131798","html_url":"https://github.com/fiedl/github-project-to-csv","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiedl%2Fgithub-project-to-csv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiedl%2Fgithub-project-to-csv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiedl%2Fgithub-project-to-csv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiedl%2Fgithub-project-to-csv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fiedl","download_url":"https://codeload.github.com/fiedl/github-project-to-csv/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250566441,"owners_count":21451229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-projects"],"created_at":"2024-10-02T21:40:50.994Z","updated_at":"2025-04-24T04:43:52.462Z","avatar_url":"https://github.com/fiedl.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# github-project-to-csv\n\nSimple cli to export github v2 projects to csv\n\n![Screenshot](https://user-images.githubusercontent.com/1679688/215134233-80bbbaab-c026-4937-b0d8-a42b11ab4e4b.png)\n\n## Usage\n\n```shell\n./github-project-to-csv.rb --project https://github.com/users/fiedl/projects/2 --output project.csv\n```\n\nIf you do encounter errors here, please check the [troubleshooting section](#troubleshooting) to make sure you have the correct ruby version and gems installed, or [run the script via docker](#running-with-docker).\n\n## Installation\n\n1. Install the [github cli](https://cli.github.com): `brew install gh`\n2. Clone this repo: `git clone https://github.com/fiedl/github-project-to-csv.git`\n\n## Using github personal access tokens\n\nInstead of using the `gh` command-line client, this tool also supports [github personal access tokens](https://github.com/settings/tokens). However, github does only support classic personal access tokens for now; fine-grained tokens do not work, yet.\n\nCreate a classic token `xxx` at https://github.com/settings/tokens. Then:\n\n```shell\n./github-project-to-csv.rb --project https://github.com/users/fiedl/projects/2 --output project.csv --token xxx\n```\n\n## Running with docker\n\nIf you don't have a local ruby environment, it might be easiest to run this script via docker.\n\nInstall docker including the compose plugin: https://docs.docker.com/compose/install/\n\nThen run this from the repository directory:\n\n```shell\ndocker compose run app bundle exec ruby github-project-to-csv.rb --project https://github.com/users/fiedl/projects/2 --output project.csv --token xxx\n```\n\nWhen not using an access token, this might ask you to manually open a web browser and copy an authentication code in order to authenticate with github.\n\n## Troubleshooting\n\n### This script requires ruby version 3.2 or higher\n\nYour local ruby version is too old. Please update according to the [ruby documentation](https://www.ruby-lang.org/en/documentation/installation/) or [run the script via docker](#running-with-docker).\n\n### require: cannot load such file\n\nSome gems are missing locally. Run:\n\n    gem install pry httparty\n\nOr [run the script via docker](#running-with-docker).\n\n## Further Resources\n\n- [Github documentation on the projects api](https://docs.github.com/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)\n- [Introduction to GraphQL](https://docs.github.com/en/graphql/guides/introduction-to-graphql)\n- [Understanding GraphQL Queries](https://graphql.org/learn/queries/)\n- [Github GraphQL Object Reference](https://docs.github.com/en/graphql/reference/objects)\n- [Github GraphQL API Explorer](https://docs.github.com/en/graphql/overview/explorer)\n\n## Author and License\n\n(c) 2023, Sebastian Fiedlschuster\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiedl%2Fgithub-project-to-csv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiedl%2Fgithub-project-to-csv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiedl%2Fgithub-project-to-csv/lists"}