Trolley
Trolley syncs issues from CSVs to Github and to sync projects between Github and Trello.
Trolley is a useful tool for loading an initial set of issues, labels, and milestones on github.
Trolley was written to also help me manage a few projects where I need to selectively sync Issues and boards between Trello and Github.
By Roland zh (Own work) [CC BY-SA 3.0 (http://creativecommons.org/licenses/by-sa/3.0)], via Wikimedia Commons
Installation
$ pip install trolley
Usage
Example trolley.yml
buffer:
client_id: 'buffer client_id'
client_secret: 'buffer client_secret'
access_token: 'buffer access_token'
github:
username: 'username'
password: 'password'
org: 'github'
repo: 'gitignore'
trello:
app_key: 'get-this-from-trello'
app_secret: 'get-this-from-trello'
auth_token: 'get-this-from-trello'
board_id: 'your-board-id-sha'
default_list: 'Uncategorized'
Usage
$ trolley --conf trolley.yml --help
$ trolley --conf trolley.yml create_github_issues
Commands
bootstrap
- Sets up github with some sensible defaults.
close_existing_github_issues
- Close all existing GitHub issues.
create_github_issues
- Create GitHub issues from a CSV file.
create_github_labels
- Create GitHub labels from a CSV file.
create_github_milestones
- Create GitHub milestones from a CSV file.
create_trello_cards
- Create Trello cards from a CSV file.
create_trello_labels
- Create Trello labels from a CSV file.
create_trello_lists
- Create Trello lists from a CSV file.
delete_existing_github_labels
- Delete labels from GitHub repo.
delete_existing_github_milestones
- Delete milestones from GitHub repo.
list_trello_boards
- List your Trello boards.
list_trello_cards
- List your Trello cards for a given board.
list_trello_organizations
- List your Trello organizations.
sync_github_issues_to_trello_cards
- Convert your GitHub issues to Trello cards.
sync_trello_cards_to_github_issues
- Convert your Trello cards to GitHub issues.
Object Overview
Github | Trello | Notes |
---|---|---|
Org / Repo | Board | == |
 | Lists |  |
Issues | Cards | == |
Labels | Labels | == |
Milestones | Â | Â |
Milestones and Lists may be mapped together but they are fundamentally treated very differently.
Future features
- Needs allowed list / blocked list for handling via labels.
- This is basically "works for me" but it needs error handling.
Inspiration
This project shares ideas from the following projects:
- The CSV bits via: https://github.com/nprapps/app-template