Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.markdown

pivotal-to-trello Build Status Gem Version

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

  1. 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

  2. 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:

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

Author

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

Copyright

Copyright (c) 2017 Dave Perrett. See License for details.

About

Pivotal Tracker to Trello exporter

Resources

License

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
You can’t perform that action at this time.