https://github.com/atsign-company/dump_cards
Scripts to dump cards from a GitHub project column into a CSV file that can be imported into planningpoker.com
https://github.com/atsign-company/dump_cards
csv-export github hacktoberfest planning-poker projects python3
Last synced: 10 days ago
JSON representation
Scripts to dump cards from a GitHub project column into a CSV file that can be imported into planningpoker.com
- Host: GitHub
- URL: https://github.com/atsign-company/dump_cards
- Owner: atsign-company
- License: apache-2.0
- Created: 2021-05-28T10:25:29.000Z (over 4 years ago)
- Default Branch: trunk
- Last Pushed: 2025-06-24T11:46:40.000Z (7 months ago)
- Last Synced: 2025-06-24T12:46:16.917Z (7 months ago)
- Topics: csv-export, github, hacktoberfest, planning-poker, projects, python3
- Language: Python
- Homepage:
- Size: 136 KB
- Stars: 8
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: code_of_conduct.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# dump\_cards
Repo to dump cards from a project column into a CSV file that can be imported
into [planningpoker.com](https://www.planningpoker.com/).
[](https://www.apache.org/licenses/LICENSE-2.0)
## Contributions:
If you find a bug then please raise an
[issue](https://github.com/atsign-company/dump_cards/issues).
We'd also love to get [pull requests](https://github.com/atsign-company/dump_cards/pulls)
for improvements.
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
Our [code of conduct](code_of_conduct.md) is based on
[](code_of_conduct.md)
## Security token
These scripts need a security token with access to read:project.
If your project contains issues or pull requests in a private repo, you will also need to provide access to repo.
The token should be in an environment variable `GITHUB_API_TOKEN`
An easy way to do this is set it in a `.env` file:
```
# ./.env
# API keys for GitHub etc.
GITHUB_API_TOKEN=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 # <- put your token here
# ^ this token was deleted already so it needs to be replaced
```
## Interactive scripts
This project uses the
[InquirerPy](https://pypi.org/project/inquirerpy/),
[python-dotenv](https://pypi.org/project/python-dotenv/) and
[requests](https://pypi.org/project/requests/) modules, so you need to
install them:
```
pip3 install InquirerPy
pip3 install python-dotenv
pip3 install requests
```
Or, by using the `requirements.txt`:
```
pip3 install -r requirements.txt
```
Then run:
```
./dump_cards.py
```
The menus will then prompt for selection of org, project type, and column
before exporting the column to .csv.
*V2 Projects will additionally ask which field to pick the column from.
[](https://asciinema.org/a/KG4qlBbQZfiR7N8cQRw4APyIU)
## Shell script
### merge.sh
This is used to merge the latest two files (which should be .csv files) so
that the headers from the second file are stripped out in order to create
a single file that can be imported to Planning Poker.
`./merge.sh`