pivotal-to-trello 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1c6a9c20609a5c73bcb501e1dfb7348887428e9f
+  data.tar.gz: 4de6683169e6fdfe8f0c7b91ece7e7a2d250598c
+SHA512:
+  metadata.gz: 77a57760785ef0508c3a9f4e787b6df6ebd143178e5ae1deabc56707bbfbf2023d9598bb5e65c851c0a05d9bc60f50de25a76770ab92c50c775558e672c20b1d
+  data.tar.gz: b8d99a1d6839f9c8792811d8317e251d830198ed71797dc2e3e512af41a134c9cb8b249a92d53161d2869d9d998f69c1ff1f7e6d8281993e4dff3245870e9223

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,14 @@
+source 'http://rubygems.org'
+
+gem 'highline'
+gem 'ruby-trello', '>= 1.0.0 '
+gem 'pivotal-tracker'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'rspec'
+  gem 'rdoc'
+  gem 'bundler'
+  gem 'jeweler'
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2014 Dave Perrett
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,260 @@
+pivotal-to-trello [![Build Status](https://travis-ci.org/recurser/pivotal-to-trello.png?branch=master)](https://travis-ci.org/recurser/pivotal-to-trello)
+=================
+
+This gem provides a command for exporting a [Pivotal Tracker](https://www.pivotaltracker.com/) project to [Trello](https://trello.com/).
+
+Getting started
+---------------
+
+1. Install the gem:
+
+        > gem install 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](#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](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](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](https://trello.com/docs/gettingstarted/index.html#getting-an-application-key) for more details.
+
+The Pivotal Tracker token can be found at the bottom of your [Pivotal profile page](https://www.pivotaltracker.com/profile).
+
+Change history
+--------------
+
+* **Version 0.1.0 (2014-01-13)** : Initial version.
+
+Bug Reports
+-----------
+
+If you come across any problems, please [create a ticket](https://github.com/recurser/pivotal-to-trello/issues) and I'll try to get it fixed as soon as possible.
+
+Contributing
+------------
+
+Once you've made your changes:
+
+1. [Fork](http://help.github.com/fork-a-repo/) 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](http://help.github.com/pull-requests/) from your branch
+5. That's it!
+
+
+Author
+------
+
+Dave Perrett :: hello@daveperrett.com :: [@daveperrett](http://twitter.com/daveperrett)
+
+
+Copyright
+---------
+
+Copyright (c) 2010 Dave Perrett. See [License](https://github.com/recurser/jquery-i18n/blob/master/LICENSE) for details.

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name        = "pivotal-to-trello"
+  gem.license     = "MIT"
+  gem.homepage    = "http://github.com/recurser/pivotal-to-trello"
+  gem.summary     = %Q{Pivotal Tracker to Trello exporter}
+  gem.description = %Q{Pulls stories from Pivotal Tracker and imports them into Trello}
+  gem.email       = "hello@daveperrett.com"
+  gem.authors     = ["Dave Perrett"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "pivotal-to-trello #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/pivotal-to-trello

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+file = __FILE__
+if File.lstat(file).symlink?
+  require 'pathname'
+  file = Pathname.new(file).realpath
+end
+
+require File.expand_path(File.dirname(file) + '/../lib/pivotal-to-trello')
+PivotalToTrello::Runner.execute

data/lib/pivotal-to-trello.rb

@@ -0,0 +1,16 @@
+unless defined? P2T_ROOT
+  $LOAD_PATH << File.expand_path(File.dirname(__FILE__))
+  P2T_ROOT   = File.expand_path(File.dirname(__FILE__) + '/../')
+  P2T_LIB    = File.join(P2T_ROOT, 'lib', 'pivotal_to_trello')
+end
+
+module PivotalToTrello
+  def self.version
+    File.exist?(File.join(P2T_ROOT, 'VERSION')) ? File.read(File.join(P2T_ROOT, 'VERSION')) : 'Unknown'
+  end
+
+  require 'pivotal_to_trello/core'
+  require 'pivotal_to_trello/pivotal_wrapper'
+  require 'pivotal_to_trello/runner'
+  require 'pivotal_to_trello/trello_wrapper'
+end

data/lib/pivotal_to_trello/core.rb

@@ -0,0 +1,114 @@
+require 'rubygems'
+require 'highline/import'
+
+module PivotalToTrello
+  # The core entry point of the gem, which handles the import process.
+  class Core
+
+    # Constructor
+    def initialize(options = OpenStruct.new)
+      @options = options
+    end
+
+    # Generates a film clip based on the given input audio file, and saves it
+    # to the given output path.
+    def import!
+      prompt_for_details
+
+      puts "\nBeginning import..."
+      pivotal.stories(options.pivotal_project_id).each do |story|
+        if story.current_state == 'accepted'
+          list_id = options.accepted_list_id
+        elsif story.current_state == 'rejected'
+          list_id = options.rejected_list_id
+        elsif story.current_state == 'finished'
+          list_id = options.finished_list_id
+        elsif story.current_state == 'delivered'
+          list_id = options.delivered_list_id
+        elsif story.current_state == 'started'
+          list_id = options.current_list_id
+        elsif story.current_state == 'unscheduled'
+          list_id = options.icebox_list_id
+        elsif story.current_state == 'unstarted' && story.story_type == 'feature'
+          list_id = options.feature_list_id
+        elsif story.current_state == 'unstarted' && story.story_type == 'chore'
+          list_id = options.chore_list_id
+        elsif story.current_state == 'unstarted' && story.story_type == 'bug'
+          list_id = options.bug_list_id
+        elsif story.current_state == 'unstarted' && story.story_type == 'release'
+          list_id = options.release_list_id
+        else
+          puts "Ignoring story #{story.id} - type is '#{story.story_type}', state is '#{story.current_state}'"
+        end
+
+        if story.story_type == 'bug' && options.bug_label
+          label = options.bug_label
+        elsif story.story_type == 'chore' && options.feature_label
+          label = options.feature_label
+        elsif story.story_type == 'feature' && options.chore_label
+          label = options.chore_label
+        elsif story.story_type == 'release' && options.release_label
+          label = options.release_label
+        end
+
+        if list_id
+          card = trello.create_card(list_id, story)
+          trello.add_label(card, label)
+        end
+      end
+    end
+
+    # Returns the options struct.
+    def options
+      @options
+    end
+
+    private
+
+      # Prompts the user for details about the imort/export.
+      def prompt_for_details
+        options.pivotal_project_id = prompt_selection('Which Pivotal project would you like to export?', pivotal.project_choices)
+        options.trello_board_id    = prompt_selection('Which Trello board would you like to import into?', trello.board_choices)
+        options.icebox_list_id     = prompt_selection("Which Trello list would you like to put 'icebox' stories into?", trello.list_choices(options.trello_board_id))
+        options.current_list_id    = prompt_selection("Which Trello list would you like to put 'current' stories into?", trello.list_choices(options.trello_board_id))
+        options.finished_list_id   = prompt_selection("Which Trello list would you like to put 'finished' stories into?", trello.list_choices(options.trello_board_id))
+        options.delivered_list_id  = prompt_selection("Which Trello list would you like to put 'delivered' stories into?", trello.list_choices(options.trello_board_id))
+        options.accepted_list_id   = prompt_selection("Which Trello list would you like to put 'accepted' stories into?", trello.list_choices(options.trello_board_id))
+        options.rejected_list_id   = prompt_selection("Which Trello list would you like to put 'rejected' stories into?", trello.list_choices(options.trello_board_id))
+        options.bug_list_id        = prompt_selection("Which Trello list would you like to put 'backlog' bugs into?", trello.list_choices(options.trello_board_id))
+        options.chore_list_id      = prompt_selection("Which Trello list would you like to put 'backlog' chores into?", trello.list_choices(options.trello_board_id))
+        options.feature_list_id    = prompt_selection("Which Trello list would you like to put 'backlog' features into?", trello.list_choices(options.trello_board_id))
+        options.release_list_id    = prompt_selection("Which Trello list would you like to put 'backlog' releases into?", trello.list_choices(options.trello_board_id))
+        options.bug_label          = prompt_selection('What color would you like to label bugs with?', trello.label_choices)
+        options.feature_label      = prompt_selection('What color would you like to label features with?', trello.label_choices)
+        options.chore_label        = prompt_selection('What color would you like to label chores with?', trello.label_choices)
+        options.release_label      = prompt_selection('What color would you like to label releases with?', trello.label_choices)
+      end
+
+      # Prompts the user to select an option from the given list of choices.
+      def prompt_selection(question, choices)
+        say("\n#{question}")
+        choose do |menu|
+          menu.prompt = "Please select an option : "
+
+          choices.each do |key, value|
+            menu.choice value do
+              return key
+            end
+          end
+        end
+
+      end
+
+      # Returns an instance of the pivotal wrapper.
+      def pivotal
+        @pivotal ||= PivotalToTrello::PivotalWrapper.new(options.pivotal_token)
+      end
+
+      # Returns an instance of the trello wrapper.
+      def trello
+        @trello ||= PivotalToTrello::TrelloWrapper.new(options.trello_key, options.trello_token)
+      end
+
+  end
+end

data/lib/pivotal_to_trello/pivotal_wrapper.rb

@@ -0,0 +1,34 @@
+require 'pivotal-tracker'
+
+module PivotalToTrello
+  # Interface to the Pivotal Tracker API.
+  class PivotalWrapper
+
+    # Constructor
+    def initialize(token)
+      ::PivotalTracker::Client.token = token
+    end
+
+    # Returns a hash of available projects keyed on project ID.
+    def project_choices
+      ::PivotalTracker::Project.all.inject({}) do |hash, project|
+        hash[project.id] = project.name
+        hash
+      end
+    end
+
+    # Returns all stories for the given project.
+    def stories(project_id)
+      project(project_id).stories.all
+    end
+
+    private
+
+      # Returns the Pivotal project that we're exporting.
+      def project(project_id)
+        @projects             ||= {}
+        @projects[project_id] ||= ::PivotalTracker::Project.find(project_id)
+      end
+
+  end
+end

data/lib/pivotal_to_trello/runner.rb

@@ -0,0 +1,108 @@
+require 'optparse'
+require 'ostruct'
+
+module PivotalToTrello
+  # Utility class to handle the different commands that the 'pivotal-to-trello'
+  # command offers.
+  class Runner
+    # Start running a pivotal-to-trello command from the passed-in arguments.
+    def self.execute
+      runner  = new
+      options = runner.parse_options(ARGV)
+      runner.execute!(options)
+    end
+
+    # Dispatch central.
+    def execute!(options)
+      case options.action
+      when :import then import(options)
+      end
+    end
+
+    # Parses the options, and displays help messages if the options given are
+    # incorrect.
+    def parse_options(args)
+      options = OpenStruct.new
+
+      commands = {
+        'import' => OptionParser.new do |opts|
+          opts.banner = 'Usage: pivotal-to-trello import [options]'
+          opts.separator ''
+          opts.separator 'All arguments except for -v and -h are required.'
+          opts.separator ''
+          opts.separator 'Options:'
+
+          opts.on('-k', '--trello-key KEY', 'Trello application key') do |trello_key|
+            options.trello_key = trello_key
+          end
+          opts.on('-t', '--trello-token TOKEN', 'Trello member token') do |trello_token|
+            options.trello_token = trello_token
+          end
+          opts.on('-p', '--pivotal-token TOKEN', 'Pivotal Tracker API token') do |pivotal_token|
+            options.pivotal_token = pivotal_token
+          end
+
+          # Miscellaneous.
+          opts.on_tail('-v', '--version', 'Show version information') { show_version }
+          opts.on_tail('-h', '--help', 'Show this message') do
+            STDOUT.write opts
+            exit
+          end
+
+          opts.on do
+            if options.trello_key && \
+               options.trello_token && \
+               options.pivotal_token
+              options.action = :import
+            else
+              # Output a help message unless the required options have been specified.
+              options.action = :error
+              STDOUT.write commands['import']
+            end
+          end
+        end,
+      }
+
+      global = OptionParser.new do |opts|
+        opts.banner = "Usage: pivotal-to-trello [#{commands.keys.join(', ')}] [options]"
+
+        opts.separator ''
+        opts.separator 'pivotal-to-trello is a library for importing stories from Pivotal Tracker into Trello.'
+        opts.separator ''
+        opts.separator "Use pivotal-to-trello [#{commands.keys.join(', ')}] -h to find out more about a specific command"
+        opts.separator ''
+        opts.separator 'Other options:'
+
+        opts.on_tail('-v', '--version', 'Show version information') do
+          show_version
+          exit
+        end
+
+        opts.on_tail('-h', '--help', 'Show this message') do
+          STDOUT.write opts
+          exit
+        end
+      end
+
+      global.order!
+      command = args.shift
+      commands[command].order! if commands[command]
+
+      # Output a help message unless a command has been specified.
+      STDOUT.write global unless options.action
+
+      options
+    end
+
+    # Generates a film clip for the given input file, and saves it to the given
+    # output path.
+    def import(options)
+      PivotalToTrello::Core.new(options).import!
+    end
+
+    # Display the current version of Ruby-Processing.
+    def show_version
+      STDOUT.write "pivotal-to-trello version #{PivotalToTrello.version}"
+    end
+  end # class Runner
+end # module PivotalToTrello

data/lib/pivotal_to_trello/trello_wrapper.rb

@@ -0,0 +1,107 @@
+require 'trello'
+
+module PivotalToTrello
+  # Interface to the Trello API.
+  class TrelloWrapper
+
+    # Constructor
+    def initialize(key, token)
+      Trello.configure do |config|
+        config.developer_public_key = key
+        config.member_token         = token
+      end
+    end
+
+    # Creates a card in the given list if one with the same name doesn't already exist.
+    def create_card(list_id, pivotal_story)
+      card   = get_card(list_id, pivotal_story.name, pivotal_story.description)
+      card ||= begin
+        puts "Creating a card for #{pivotal_story.story_type} '#{pivotal_story.name}'."
+        card = Trello::Card.create(
+          :name    => pivotal_story.name,
+          :desc    => pivotal_story.description,
+          :list_id => list_id
+        )
+
+        pivotal_story.notes.all.each do |note|
+          card.add_comment("[#{note.author}] #{note.text.to_s.strip}") unless note.text.to_s.strip.empty?
+        end
+
+        card
+      end
+
+      key                  = card_hash(card.name, card.desc)
+      @cards             ||= {}
+      @cards[list_id]    ||= {}
+      @cards[list_id][key] = card
+    end
+
+    # Returns a hash of available boards, keyed on board ID.
+    def board_choices
+      Trello::Board.all.inject({}) do |hash, board|
+        hash[board.id] = board.name
+        hash
+      end
+    end
+
+    # Returns a hash of available lists for the given board, keyed on board ID.
+    def list_choices(board_id)
+      # Cache the list to improve performance.
+      @lists           ||= {}
+      @lists[board_id] ||= begin
+        choices = Trello::Board.find(board_id).lists.inject({}) do |hash, list|
+          hash[list.id] = list.name
+          hash
+        end
+        choices        = Hash[choices.sort_by { |_, v| v }]
+        choices[false] = "[don't import these stories]"
+        choices
+      end
+
+      @lists[board_id]
+    end
+
+    # Returns a list of all cards in the given list, keyed on name.
+    def cards_for_list(list_id)
+      @cards          ||= {}
+      @cards[list_id] ||= Trello::List.find(list_id).cards.inject({}) do |hash, card|
+        hash[card_hash(card.name, card.desc)] = card
+        hash
+      end
+
+      @cards[list_id]
+    end
+
+    # Adds the given label to the card.
+    def add_label(card, label)
+      card.add_label(label) unless card.labels.collect { |label| label.color }.include?(label)
+    end
+
+    # Returns a list of colors that can be used to label cards.
+    def label_choices
+      {
+        'blue'   => 'Blue',
+        'green'  => 'Green',
+        'orange' => 'Orange',
+        'purple' => 'Purple',
+        'red'    => 'Red',
+        'yellow' => 'Yellow',
+        false    => '[none]'
+      }
+    end
+
+    private
+
+      # Returns a unique identifier for this list/name/description combination.
+      def card_hash(name, description)
+        Digest::SHA1.hexdigest("#{name}_#{description}")
+      end
+
+      # Returns a card with the given name and description if it exists in the given list, nil otherwise.
+      def get_card(list_id, name, description)
+        key = card_hash(name, description)
+        cards_for_list(list_id)[key] if !cards_for_list(list_id)[key].nil?
+      end
+
+  end
+end

data/pivotal-to-trello.gemspec

@@ -0,0 +1,76 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: pivotal-to-trello 0.1.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "pivotal-to-trello"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Dave Perrett"]
+  s.date = "2014-01-13"
+  s.description = "Pulls stories from Pivotal Tracker and imports them into Trello"
+  s.email = "hello@daveperrett.com"
+  s.executables = ["pivotal-to-trello"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.markdown"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "bin/pivotal-to-trello",
+    "lib/pivotal-to-trello.rb",
+    "lib/pivotal_to_trello/core.rb",
+    "lib/pivotal_to_trello/pivotal_wrapper.rb",
+    "lib/pivotal_to_trello/runner.rb",
+    "lib/pivotal_to_trello/trello_wrapper.rb",
+    "pivotal-to-trello.gemspec",
+    "spec/pivotal_to_trello/core_spec.rb",
+    "spec/pivotal_to_trello/pivotal_wrapper_spec.rb",
+    "spec/pivotal_to_trello/trello_wrapper_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/recurser/pivotal-to-trello"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.2.1"
+  s.summary = "Pivotal Tracker to Trello exporter"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<highline>, [">= 0"])
+      s.add_runtime_dependency(%q<ruby-trello>, [">= 1.0.0"])
+      s.add_runtime_dependency(%q<pivotal-tracker>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+    else
+      s.add_dependency(%q<highline>, [">= 0"])
+      s.add_dependency(%q<ruby-trello>, [">= 1.0.0"])
+      s.add_dependency(%q<pivotal-tracker>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<highline>, [">= 0"])
+    s.add_dependency(%q<ruby-trello>, [">= 1.0.0"])
+    s.add_dependency(%q<pivotal-tracker>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+  end
+end
+

data/spec/pivotal_to_trello/core_spec.rb

@@ -0,0 +1,101 @@
+require File.expand_path(File.dirname(File.dirname(__FILE__)) + '/spec_helper')
+
+describe 'Core' do
+  let(:core)    { PivotalToTrello::Core.new(mock_options) }
+  let(:pivotal) { mock_pivotal_wrapper }
+  let(:trello)  { mock_trello_wrapper }
+
+  before(:each) do
+    IO.any_instance.stub(:puts)
+    core.stub(:pivotal => pivotal)
+    core.stub(:trello  => trello)
+
+    core.stub(:prompt_selection).with('Which Pivotal project would you like to export?', pivotal.project_choices).and_return('pivotal_project_id')
+    core.stub(:prompt_selection).with('Which Trello board would you like to import into?', trello.board_choices).and_return('trello_board_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'icebox' stories into?", trello.list_choices).and_return('icebox_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'current' stories into?", trello.list_choices).and_return('current_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'finished' stories into?", trello.list_choices).and_return('finished_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'delivered' stories into?", trello.list_choices).and_return('delivered_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'accepted' stories into?", trello.list_choices).and_return('accepted_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'rejected' stories into?", trello.list_choices).and_return('rejected_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'backlog' bugs into?", trello.list_choices).and_return('bug_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'backlog' chores into?", trello.list_choices).and_return('chore_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'backlog' features into?", trello.list_choices).and_return('feature_list_id')
+    core.stub(:prompt_selection).with("Which Trello list would you like to put 'backlog' releases into?", trello.list_choices).and_return('release_list_id')
+    core.stub(:prompt_selection).with('What color would you like to label bugs with?', trello.label_choices).and_return('bug_label')
+    core.stub(:prompt_selection).with('What color would you like to label features with?', trello.label_choices).and_return('feature_label')
+    core.stub(:prompt_selection).with('What color would you like to label chores with?', trello.label_choices).and_return('chore_label')
+    core.stub(:prompt_selection).with('What color would you like to label releases with?', trello.label_choices).and_return('release_label')
+  end
+
+  context '#import!' do
+    it 'prompts the user for details' do
+      core.import!
+      core.options.should == mock_options
+    end
+
+    describe 'story handling' do
+      let(:card)  { mock_trello_card }
+      let(:story) { mock_pivotal_story }
+
+      before(:each) do
+        pivotal.should_receive(:stories).and_return([story])
+        trello.stub(:add_label => true, :create_card => card)
+      end
+
+      it 'handles accepted stories' do
+        story.stub(:current_state => 'accepted')
+        trello.should_receive(:create_card).with(core.options.accepted_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles rejected stories' do
+        story.stub(:current_state => 'rejected')
+        trello.should_receive(:create_card).with(core.options.rejected_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles finished stories' do
+        story.stub(:current_state => 'finished')
+        trello.should_receive(:create_card).with(core.options.finished_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles delivered stories' do
+        story.stub(:current_state => 'delivered')
+        trello.should_receive(:create_card).with(core.options.delivered_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles unstarted features' do
+        story.stub(:current_state => 'unstarted', :story_type => 'feature')
+        trello.should_receive(:create_card).with(core.options.feature_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles unstarted chores' do
+        story.stub(:current_state => 'unstarted', :story_type => 'chore')
+        trello.should_receive(:create_card).with(core.options.chore_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles unstarted bugs' do
+        story.stub(:current_state => 'unstarted', :story_type => 'bug')
+        trello.should_receive(:create_card).with(core.options.bug_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'handles unstarted releases' do
+        story.stub(:current_state => 'unstarted', :story_type => 'release')
+        trello.should_receive(:create_card).with(core.options.release_list_id, story).and_return(card)
+        core.import!
+      end
+
+      it 'labels stories' do
+        story.stub(:story_type => 'bug')
+        trello.should_receive(:add_label).with(card, core.options.bug_label)
+        core.import!
+      end
+    end
+  end
+end

data/spec/pivotal_to_trello/pivotal_wrapper_spec.rb

@@ -0,0 +1,30 @@
+require File.expand_path(File.dirname(File.dirname(__FILE__)) + '/spec_helper')
+
+describe 'PivotalWrapper' do
+  let(:wrapper) { PivotalToTrello::PivotalWrapper.new('token') }
+
+  context '#initialize' do
+    it 'sets the pivotal token' do
+      ::PivotalTracker::Client.should_receive(:token=).with('token')
+      PivotalToTrello::PivotalWrapper.new('token')
+    end
+  end
+
+  context '#project_choices' do
+    it 'returns a hash of pivotal projects' do
+      project = OpenStruct.new(:id => 'id', :name => 'My Project')
+      ::PivotalTracker::Project.should_receive(:all).and_return([project])
+      wrapper.project_choices.should == { 'id' => 'My Project'}
+    end
+  end
+
+  context '#stories' do
+    it 'returns an array of pivotal stories' do
+      story   = mock_pivotal_story
+      project = double(PivotalTracker::Project)
+      ::PivotalTracker::Project.should_receive(:find).with('project_id').and_return(project)
+      project.stub_chain(:stories, :all).and_return([story])
+      wrapper.stories('project_id').should == [story]
+    end
+  end
+end

data/spec/pivotal_to_trello/trello_wrapper_spec.rb

@@ -0,0 +1,114 @@
+require File.expand_path(File.dirname(File.dirname(__FILE__)) + '/spec_helper')
+
+describe 'TrelloWrapper' do
+  let(:wrapper) { PivotalToTrello::TrelloWrapper.new('key', 'token') }
+
+  before(:each) do
+    IO.any_instance.stub(:puts)
+  end
+
+  context '#initialize' do
+    it 'sets the auth credentials' do
+      config = double
+      Trello.should_receive(:configure).and_yield(config)
+      config.should_receive(:developer_public_key=).with('key')
+      config.should_receive(:member_token=).with('token')
+      PivotalToTrello::TrelloWrapper.new('key', 'token')
+    end
+  end
+
+  context '#create_card' do
+    let(:card) { mock_trello_card }
+
+    it 'creates a new card if none exists' do
+      story = mock_pivotal_story
+      wrapper.should_receive(:get_card).and_return(nil)
+      Trello::Card.should_receive(:create).with(
+        :name    => story.name,
+        :desc    => story.description,
+        :list_id => 'list_id'
+      ).and_return(card)
+      wrapper.create_card('list_id', story).should == card
+    end
+
+    it 'does not create a new card if one exists with the same name' do
+      story = mock_pivotal_story(:name => 'My Card')
+      Trello::List.stub_chain(:find, :cards).and_return([card])
+      Trello::Card.should_not_receive(:create)
+      wrapper.create_card('list_id', story).should == card
+    end
+
+    it 'creates a new card if one exists with a different name' do
+      story = mock_pivotal_story(:name => 'My Foo')
+      Trello::List.stub_chain(:find, :cards).and_return([card])
+      Trello::Card.should_receive(:create).with(
+        :name    => story.name,
+        :desc    => story.description,
+        :list_id => 'list_id'
+      ).and_return(card)
+      wrapper.create_card('list_id', story).should == card
+    end
+
+    it 'adds comments' do
+      note  = OpenStruct.new(:text => 'My Note', :author => 'John Smith')
+      story = mock_pivotal_story
+      story.stub_chain(:notes, :all).and_return([note])
+      wrapper.should_receive(:get_card).and_return(nil)
+      Trello::Card.should_receive(:create).and_return(card)
+      card.should_receive(:add_comment).with('[John Smith] My Note')
+      wrapper.create_card('list_id', story).should == card
+    end
+  end
+
+  context '#board_choices' do
+    it 'returns a hash of Trello boards' do
+      board = OpenStruct.new(:id => 'id', :name => 'My Board')
+      Trello::Board.should_receive(:all).and_return([board])
+      wrapper.board_choices.should == { 'id' => 'My Board'}
+    end
+  end
+
+  context '#list_choices' do
+    it 'returns a hash of Trello lists' do
+      board = double(Trello::Board)
+      list  = OpenStruct.new(:id => 'id', :name => 'My List')
+      Trello::Board.should_receive(:find).with('board_id').and_return(board)
+      board.should_receive(:lists).and_return([list])
+      wrapper.list_choices('board_id').should == {
+        'id'  => 'My List',
+        false => "[don't import these stories]",
+      }
+    end
+  end
+
+  context '#cards_for_list' do
+    it 'returns a hash of Trello lists' do
+      list = double(Trello::List)
+      card  = OpenStruct.new(:name => 'My Card', :desc => 'My Description')
+      Trello::List.should_receive(:find).with('list_id').and_return(list)
+      list.should_receive(:cards).and_return([card])
+      expected = {'193060beddd00d64259bdc1271d6c5a330e92e7d' => card}
+      wrapper.cards_for_list('list_id').should == expected
+      # Test caching.
+      Trello::List.should_not_receive(:find)
+      wrapper.cards_for_list('list_id').should == expected
+    end
+  end
+
+  context '#add_label' do
+    it 'adds a label if it does not already exist' do
+      card = mock_trello_card
+      card.stub(:labels => [])
+      card.should_receive(:add_label).with('red')
+      wrapper.add_label(card, 'red')
+    end
+
+    it 'does not add a label if it already exists' do
+      card = mock_trello_card
+      card.stub(:labels => [OpenStruct.new(:color => 'red')])
+      card.should_not_receive(:add_label)
+      wrapper.add_label(card, 'red')
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,70 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'pivotal-to-trello'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+end
+
+def mock_pivotal_wrapper
+  pivotal = double(PivotalToTrello::PivotalWrapper)
+  pivotal.stub(:project_choices => {})
+  pivotal.stub(:stories         => [])
+  pivotal
+end
+
+def mock_trello_wrapper
+  trello = double(PivotalToTrello::TrelloWrapper)
+  trello.stub(:board_choices => {})
+  trello.stub(:list_choices  => {})
+  trello.stub(:label_choices => {})
+  trello
+end
+
+def mock_pivotal_story(options = {})
+  options = {
+    :name          => 'My Story',
+    :description   => 'My Description',
+    :current_state => 'unstarted',
+    :story_type    => 'feature',
+  }.merge(options)
+  story = double(PivotalTracker::Story)
+  story.stub_chain(:notes, :all).and_return([])
+  options.each { |k, v| story.stub(k => v) }
+  story
+end
+
+def mock_trello_card(options = {})
+  options = {
+    :name => 'My Card',
+    :desc => 'My Description',
+  }.merge(options)
+  card = double(Trello::Card)
+  options.each { |k, v| card.stub(k => v) }
+  card
+end
+
+def mock_options
+  OpenStruct.new({
+    :pivotal_project_id => 'pivotal_project_id',
+    :trello_board_id    => 'trello_board_id',
+    :icebox_list_id     => 'icebox_list_id',
+    :current_list_id    => 'current_list_id',
+    :finished_list_id   => 'finished_list_id',
+    :delivered_list_id  => 'delivered_list_id',
+    :accepted_list_id   => 'accepted_list_id',
+    :rejected_list_id   => 'rejected_list_id',
+    :bug_list_id        => 'bug_list_id',
+    :chore_list_id      => 'chore_list_id',
+    :feature_list_id    => 'feature_list_id',
+    :release_list_id    => 'release_list_id',
+    :bug_label          => 'bug_label',
+    :feature_label      => 'feature_label',
+    :chore_label        => 'chore_label',
+    :release_label      => 'release_label',
+  })
+end

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: pivotal-to-trello
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dave Perrett
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-trello
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: pivotal-tracker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Pulls stories from Pivotal Tracker and imports them into Trello
+email: hello@daveperrett.com
+executables:
+- pivotal-to-trello
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.markdown
+files:
+- ".document"
+- Gemfile
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- VERSION
+- bin/pivotal-to-trello
+- lib/pivotal-to-trello.rb
+- lib/pivotal_to_trello/core.rb
+- lib/pivotal_to_trello/pivotal_wrapper.rb
+- lib/pivotal_to_trello/runner.rb
+- lib/pivotal_to_trello/trello_wrapper.rb
+- pivotal-to-trello.gemspec
+- spec/pivotal_to_trello/core_spec.rb
+- spec/pivotal_to_trello/pivotal_wrapper_spec.rb
+- spec/pivotal_to_trello/trello_wrapper_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/recurser/pivotal-to-trello
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.1
+signing_key: 
+specification_version: 4
+summary: Pivotal Tracker to Trello exporter
+test_files: []