jefftriplett / trolley

:trolleybus: Trolley syncs issues between CSV, Github, and Trello

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