tpope-pickler 0.0.1 → 0.0.2

data/README.rdoc

@@ -4,6 +4,7 @@ Synchronize user stories in Pivotal Tracker with Cucumber features.
 
 == Getting started
 
+  gem install tpope-pickler --source=http://gems.github.com
   echo "api_token: ..."  > ~/.tracker.yml
   echo "project_id: ..." > ~/my/app/features/tracker.yml
 
@@ -34,6 +35,14 @@ List all stories matching the given query.
 
 Show details for the story referenced by the id.
 
+  pickler start <id>
+
+Pull a given feature and change its state to started.
+
+  pickler finish <id>
+
+Push a given feature and change its state to finished.
+
 == Disclaimer
 
 No warranties, expressed or implied.

data/lib/pickler/feature.rb

@@ -0,0 +1,71 @@
+class Pickler
+  class Feature
+    URL_REGEX = %r{\bhttp://www\.pivotaltracker\.com/\S*/(\d+)\b}
+    attr_reader :pickler
+
+    def initialize(pickler, identifier)
+      @pickler = pickler
+      case identifier
+      when nil, /^\s+$/
+        raise Error, "No feature given"
+
+      when /^#{URL_REGEX}$/, /^(\d+)$/
+        @id = $1.to_i
+
+      when /\.feature$/
+        if File.exist?(identifier)
+          @filename = identifier
+        end
+
+      else
+        if File.exist?(path = pickler.features_path("#{identifier}.feature"))
+          @filename = path
+        end
+
+      end or raise Error, "Unrecogizable feature #{string}"
+    end
+
+    def local_body
+      File.read(@filename) if @filename
+    end
+
+    def filename
+      unless defined?(@filename)
+        @filename = Dir[pickler.features_path("**","*.feature")].detect do |f|
+          File.read(f)[/#\s*#{URL_REGEX}/,1].to_i == @id
+        end
+      end
+      @filename
+    end
+
+    def to_s
+      local_body || story.to_s
+    end
+
+    def push
+      return if story.to_s == local_body.to_s
+      story.to_s = local_body
+      story.save
+    end
+
+    def finish
+      story.current_state = "finished" unless story.complete?
+      story.to_s = local_body
+      story.save
+    end
+
+    def id
+      unless defined?(@id)
+        @id = if id = local_body.to_s[/#\s*#{URL_REGEX}/,1]
+                id.to_i
+              end
+      end
+      @id
+    end
+
+    def story
+      @story ||= @pickler.project.story(id) if id
+    end
+
+  end
+end

data/lib/pickler/tracker/story.rb

@@ -14,6 +14,22 @@ class Pickler
         super(attributes)
       end
 
+      def transition!(state)
+        raise Pickler::Tracker::Error, "Invalid state #{state}", caller unless STATES.include?(state)
+        self.current_state = state
+        if id
+          xml = "<story><current-state>#{state}</current-state></story>"
+          error = tracker.request_xml(:put, resource_url, xml).fetch("errors",{})["error"] || true
+        else
+          error = save
+        end
+        raise Pickler::Tracker::Error, Array(error).join("\n"), caller unless error == true
+      end
+
+      def complete?
+        %w(finished delivered accepted).include?(current_state)
+      end
+
       def tracker
         project.tracker
       end
@@ -64,24 +80,24 @@ class Pickler
 
       def destroy
         if id
-          request = tracker.request_xml(:delete, "/projects/#{project.id}/stories/#{id}", to_xml)
-          raise Error, request["message"], caller if request["success"] != "true"
+          response = tracker.request_xml(:delete, "/projects/#{project.id}/stories/#{id}", to_xml)
+          raise Error, response["message"], caller if response["success"] != "true"
           @attributes["id"] = nil
           self
         end
       end
 
+      def resource_url
+        ["/projects/#{project.id}/stories",id].compact.join("/")
+      end
+
       def save
-        if id
-          request = tracker.request_xml(:put, "/projects/#{project.id}/stories/#{id}", to_xml)
-        else
-          request = tracker.request_xml(:post, "/projects/#{project.id}/stories", to_xml)
-        end
-        if request["success"] == "true"
-          initialize(project, request["story"])
+        response = tracker.request_xml(id ? :put : :post,  resource_url, to_xml)
+        if response["success"] == "true"
+          initialize(project, response["story"])
           true
         else
-          Array(request["errors"]["error"])
+          Array(response["errors"]["error"])
         end
       end
 

data/lib/pickler.rb

@@ -39,8 +39,12 @@ class Pickler
       pickler.push(*argv)
     when 'pull'
       pickler.pull(*argv)
+    when 'start'
+      pickler.start(argv.first)
+    when 'finish'
+      pickler.finish(argv.first)
     when 'help', '--help', '-h', '', nil
-      puts 'pickler commands: show <id>, search <query>, push, pull'
+      puts 'pickler commands: [show|start|finish] <id>, search <query>, push, pull'
     else
       $stderr.puts "pickler: unknown command #{first}"
       exit 1
@@ -107,19 +111,33 @@ class Pickler
     Cucumber.language['scenario']
   end
 
-  def remote_features
+  def stories
     project.stories(scenario_word, :includedone => true).select do |s|
       s.to_s =~ /^\s*#{Regexp.escape(scenario_word)}:/ && parser.parse(s.to_s)
     end
   end
 
-  def local_features
-    Dir[features_path('**','*.feature')].map {|f| LocalFeature.new(self,f)}
+  def features(*args)
+    if args.any?
+      args.map {|a| feature(a)}
+    else
+      Dir[features_path('**','*.feature')].map {|f|feature(f)}.select {|f|f.id}
+    end
+  end
+
+  def feature(string)
+    Feature.new(self,string)
+  end
+
+  def story(string)
+    feature(string).story
   end
 
-  def pull
-    l = local_features
-    remote_features.each do |remote|
+  def pull(*args)
+    l = features
+    args.map! {|arg| story(arg)}
+    args.replace(stories) if args.empty?
+    args.each do |remote|
       body = "# http://www.pivotaltracker.com/story/show/#{remote.id}\n" <<
       normalize_feature(remote.to_s)
       if local = l.detect {|f| f.id == remote.id}
@@ -133,13 +151,23 @@ class Pickler
     nil
   end
 
-  def push
-    local_features.select do |local|
-      next unless local.id
-      remote = local.story
-      next if remote.to_s == local.to_s
-      remote.to_s = local.to_s
-      remote.save
+  def start(*args)
+    args.each do |arg|
+      story = story(arg)
+      story.transition!("started") if %w(unstarted rejected).include?(story.current_state)
+    end
+    pull(*args)
+  end
+
+  def push(*args)
+    features(*args).each do |feature|
+      feature.push
+    end
+  end
+
+  def finish(*args)
+    features(*args).each do |feature|
+      feature.finish
     end
   end
 
@@ -162,33 +190,7 @@ class Pickler
     new
   end
 
-  class LocalFeature
-    attr_reader :pickler, :filename
-
-    def initialize(pickler, filename)
-      @pickler = pickler
-      @filename = filename
-    end
-
-    def to_s
-      File.read(@filename)
-    end
-
-    def id
-      unless defined?(@id)
-        @id = if id = to_s[%r{#\s*http://www\.pivotaltracker\.com/\S*?/(\d+)},1]
-                id.to_i
-              end
-      end
-      @id
-    end
-
-    def story
-      @pickler.project.story(id) if id
-    end
-
-  end
-
 end
 
+require 'pickler/feature'
 require 'pickler/tracker'

data/pickler.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name                = "pickler"
-  s.version             = "0.0.1"
+  s.version             = "0.0.2"
 
   s.summary             = "PIvotal traCKer Liaison to cucumbER"
   s.description         = "Synchronize between Cucumber and Pivotal Tracker"
@@ -15,6 +15,7 @@ Gem::Specification.new do |s|
     "pickler.gemspec",
     "bin/pickler",
     "lib/pickler.rb",
+    "lib/pickler/feature.rb",
     "lib/pickler/tracker.rb",
     "lib/pickler/tracker/project.rb",
     "lib/pickler/tracker/story.rb"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tpope-pickler
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Tim Pope
@@ -44,6 +44,7 @@ files:
 - pickler.gemspec
 - bin/pickler
 - lib/pickler.rb
+- lib/pickler/feature.rb
 - lib/pickler/tracker.rb
 - lib/pickler/tracker/project.rb
 - lib/pickler/tracker/story.rb