pivotal-to-trello

This repo provides a command for exporting a Pivotal Tracker project to Trello. The command is available as a gem or a docker container.

Getting started

Install the gem:
```
 > gem install pivotal-to-trello
```
Or pull the container down using Docker:
```
 > docker pull ronawilliams/pivotal-to-trello
```
When using the docker container, substitute pivotal-to-trello with docker run -i ronawilliams/pivotal-to-trello

Run the importer:

 > pivotal-to-trello import --trello-key TRELLO_API_KEY --trello-token TRELLO_TOKEN --pivotal-token PIVOTAL_TOKEN

See the Obtaining API credentials section for details on how to obtain these credentials.

The importer will ask you a series of questions to identify which Trello lists you want to import certain classes of stories into. It will then import the stories into Trello, along with any associated comments. It does not currently have the ability to import attachments.

For example :

    > pivotal-to-trello import --trello-key TRELLO_API_KEY --trello-token TRELLO_TOKEN --pivotal-token PIVOTAL_TOKEN

    Which Pivotal project would you like to export?
    1. Android App
    2. IOS App
    3. Tech Support
    4. Web App
    Please select an option : 4

    Which Trello board would you like to import into?
    1. Development
    2. Welcome Board
    3. Wish List
    Please select an option : 1

    Which Trello list would you like to put 'icebox' stories into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 6

    Which Trello list would you like to put 'current' stories into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 7

    Which Trello list would you like to put 'finished' stories into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 5

    Which Trello list would you like to put 'delivered' stories into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 4

    Which Trello list would you like to put 'accepted' stories into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 10

    Which Trello list would you like to put 'rejected' stories into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 10

    Which Trello list would you like to put 'backlog' bugs into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 2

    Which Trello list would you like to put 'backlog' chores into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 2

    Which Trello list would you like to put 'backlog' features into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 2

    Which Trello list would you like to put 'backlog' releases into?
    1. Accepted
    2. Backlog
    3. Bugs
    4. Delivered
    5. Finished
    6. Icebox
    7. In Progress
    8. Rejected
    9. Releases
    10. [don't import these stories]
    Please select an option : 2

    What color would you like to label bugs with?
    1. Blue
    2. Green
    3. Orange
    4. Purple
    5. Red
    6. Yellow
    7. [none]
    Please select an option : 5

    What color would you like to label features with?
    1. Blue
    2. Green
    3. Orange
    4. Purple
    5. Red
    6. Yellow
    7. [none]
    Please select an option : 2

    What color would you like to label chores with?
    1. Blue
    2. Green
    3. Orange
    4. Purple
    5. Red
    6. Yellow
    7. [none]
    Please select an option : 6

    What color would you like to label releases with?
    1. Blue
    2. Green
    3. Orange
    4. Purple
    5. Red
    6. Yellow
    7. [none]
    Please select an option : 4

    Beginning import...
    Creating a card for chore 'My example chore'.
    ...

Obtaining API credentials

You can get your Trello application key by logging into Trello, and then visiting https://trello.com/1/appKey/generate

Your 32-character application key will be listed in the first box.

To obtain your Trello member token, visit the following URL, substuting your Trello application key for APP_KEY:

https://trello.com/1/authorize?key=APP_KEY&name=Pivotal%20To%20Trello&response_type=token&scope=read,write

Click the Allow button, and you will be presented with a 64-character token.

See the Trello documentation for more details.

The Pivotal Tracker token can be found at the bottom of your Pivotal profile page.

Change history

Version 0.3.1 (2019-12-20) : Added Ron Williams as an author in the gemspec again after rake release removed him.
Version 0.3.0 (2019-12-04) : Update to the maintained tracker_api gem (thanks @rwilliams!).
Version 0.2.0 (2017-08-10) : Fix label creation, update gem dependencies, add checklist support (thanks @rikthevik!), add docker support (thanks @kennethkalmer!).
Version 0.1.2 (2014-01-13) : Update version number in the gemspec.
Version 0.1.1 (2014-01-13) : Specify gem dependencies.
Version 0.1.0 (2014-01-13) : Initial version.

Bug Reports

If you come across any problems, please create a ticket and I'll try to get it fixed as soon as possible.

Contributing

Once you've made your changes:

Fork pivotal-to-trello
Create a topic branch - git checkout -b my_branch
Push to your branch - git push origin my_branch
Create a Pull Request from your branch
That's it!

Author

Dave Perrett :: hello@daveperrett.com :: @daveperrett