idealian-git-pivotal 0.2.3

data/.gitignore

@@ -0,0 +1,3 @@
+pkg
+coverage
+*.gem

data/CHANGELOG

@@ -0,0 +1,14 @@
+v 0.1.3
+- Fixed bug preventing command line args from being properly interpretted
+
+v 0.1.2
+- Fixed bug introduced in v 0.1.1 which prevented git pick from completing
+
+v 0.1.1
+- Updated git pick to tell Pivotal who owns the picked feature
+- Improved Pivotal Tracker framework write ability
+
+v 0.1.0
+- Initial release
+- Basic framework for reading from Pivotal Tracker
+- git pick utility

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2010 Jeff Tucker
+
+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/Rakefile

@@ -0,0 +1,35 @@
+require 'rubygems'
+require 'rake'
+require 'spec/rake/spectask'
+
+$LOAD_PATH.unshift('lib')
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "git-pivotal"
+    gemspec.summary = "A collection of git utilities to ease integration with Pivotal Tracker"
+    gemspec.description = "A collection of git utilities to ease integration with Pivotal Tracker"
+    gemspec.email = "jeff@trydionel.com"
+    gemspec.homepage = "http://github.com/trydionel/git-pivotal"
+    gemspec.authors = ["Jeff Tucker", "Sam Stokes"]
+    
+    gemspec.add_dependency "nokogiri"
+    gemspec.add_dependency "rest-client"
+    gemspec.add_dependency "builder"
+    
+    gemspec.add_development_dependency "rspec"
+    gemspec.add_development_dependency "rcov"
+    gemspec.add_development_dependency "mocha"
+  end
+  
+  Jeweler::GemcutterTasks.new
+rescue
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--color']
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'gems']
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.2

data/bin/git-bug

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'pivotal'
+require 'commands/bug'
+
+exit Commands::Bug.new(STDIN, STDOUT, *ARGV).run!

data/bin/git-chore

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'pivotal'
+require 'commands/chore'
+
+exit Commands::Chore.new(STDIN, STDOUT, *ARGV).run!

data/bin/git-feature

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'pivotal'
+require 'commands/feature'
+
+exit Commands::Feature.new(STDIN, STDOUT, *ARGV).run!

data/bin/git-finish

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'pivotal'
+require 'commands/finish'
+
+exit Commands::Finish.new(STDIN, STDOUT, *ARGV).run!

data/bin/git-pick

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'pivotal'
+require 'commands/feature'
+
+STDOUT.puts "DEPRECATION WARNING: git pick has been deprecated.  Please use git feature instead."
+exit Commands::Feature.new(STDIN, STDOUT, *ARGV).run!

data/git-pivotal.gemspec

@@ -0,0 +1,111 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{git-pivotal}
+  s.version = "0.2.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeff Tucker", "Sam Stokes"]
+  s.date = %q{2010-03-11}
+  s.description = %q{A collection of git utilities to ease integration with Pivotal Tracker}
+  s.email = %q{jeff@trydionel.com}
+  s.executables = ["git-bug", "git-chore", "git-feature", "git-finish", "git-pick"]
+  s.extra_rdoc_files = [
+    "LICENSE"
+  ]
+  s.files = [
+    ".gitignore",
+     "CHANGELOG",
+     "LICENSE",
+     "Rakefile",
+     "VERSION",
+     "bin/git-bug",
+     "bin/git-chore",
+     "bin/git-feature",
+     "bin/git-finish",
+     "bin/git-pick",
+     "git-pivotal.gemspec",
+     "lib/commands/base.rb",
+     "lib/commands/bug.rb",
+     "lib/commands/chore.rb",
+     "lib/commands/feature.rb",
+     "lib/commands/finish.rb",
+     "lib/commands/pick.rb",
+     "lib/pivotal.rb",
+     "lib/pivotal/api.rb",
+     "lib/pivotal/associations.rb",
+     "lib/pivotal/attributes.rb",
+     "lib/pivotal/base.rb",
+     "lib/pivotal/collection.rb",
+     "lib/pivotal/project.rb",
+     "lib/pivotal/story.rb",
+     "readme.markdown",
+     "spec/commands/base_spec.rb",
+     "spec/commands/bug_spec.rb",
+     "spec/commands/chore_spec.rb",
+     "spec/commands/feature_spec.rb",
+     "spec/factories.rb",
+     "spec/factory.rb",
+     "spec/pivotal/api_spec.rb",
+     "spec/pivotal/associations_spec.rb",
+     "spec/pivotal/attributes_spec.rb",
+     "spec/pivotal/base_spec.rb",
+     "spec/pivotal/collection_spec.rb",
+     "spec/pivotal/project_spec.rb",
+     "spec/pivotal/story_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/trydionel/git-pivotal}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A collection of git utilities to ease integration with Pivotal Tracker}
+  s.test_files = [
+    "spec/commands/base_spec.rb",
+     "spec/commands/bug_spec.rb",
+     "spec/commands/chore_spec.rb",
+     "spec/commands/feature_spec.rb",
+     "spec/factories.rb",
+     "spec/factory.rb",
+     "spec/pivotal/api_spec.rb",
+     "spec/pivotal/associations_spec.rb",
+     "spec/pivotal/attributes_spec.rb",
+     "spec/pivotal/base_spec.rb",
+     "spec/pivotal/collection_spec.rb",
+     "spec/pivotal/project_spec.rb",
+     "spec/pivotal/story_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_runtime_dependency(%q<rest-client>, [">= 0"])
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0"])
+    else
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<rest-client>, [">= 0"])
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<rest-client>, [">= 0"])
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0"])
+  end
+end
+

data/lib/commands/base.rb

@@ -0,0 +1,63 @@
+require 'optparse'
+
+module Commands
+  class Base
+
+    attr_accessor :input, :output, :options
+  
+    def initialize(input=STDIN, output=STDOUT, *args)
+      @input = input
+      @output = output
+      @options = {}
+      
+      parse_gitconfig
+      parse_argv(*args)
+    end
+  
+    def put(string, newline=true)
+      @output.print(newline ? string + "\n" : string) unless options[:quiet]
+    end
+
+    def sys(cmd)
+      put cmd if options[:verbose]
+      system cmd
+    end
+
+    def get(cmd)
+      put cmd if options[:verbose]
+      `#{cmd}`
+    end
+    
+    def run!
+      unless options[:api_token] && options[:project_id]
+        put "Pivotal Tracker API Token and Project ID are required"
+        return 1
+      end
+    end
+
+  private
+
+    def parse_gitconfig
+      token = get("git config --get pivotal.api-token").strip
+      id    = get("git config --get pivotal.project-id").strip
+      name  = get("git config --get pivotal.full-name").strip
+
+      options[:api_token] = token unless token == ""
+      options[:project_id] = id unless id == ""
+      options[:full_name] = name unless name == ""
+    end
+
+    def parse_argv(*args)
+      OptionParser.new do |opts|
+        opts.banner = "Usage: git pick [options]"
+        opts.on("-k", "--api-key=", "Pivotal Tracker API key") { |k| options[:api_token] = k }
+        opts.on("-p", "--project-id=", "Pivotal Trakcer project id") { |p| options[:project_id] = p }
+        opts.on("-n", "--full-name=", "Pivotal Trakcer full name") { |n| options[:full_name] = n }
+        opts.on("-q", "--quiet", "Quiet, no-interaction mode") { |q| options[:quiet] = q }
+        opts.on("-v", "--[no-]verbose", "Run verbosely") { |v| options[:verbose] = v }
+        opts.on_tail("-h", "--help", "This usage guide") { put opts; exit 0 }
+      end.parse!(args)
+    end
+
+  end
+end

data/lib/commands/bug.rb

@@ -0,0 +1,19 @@
+require 'commands/pick'
+
+module Commands
+  class Bug < Pick
+
+    def type
+      "bug"
+    end
+    
+    def plural_type
+      "bugs"
+    end
+    
+    def branch_suffix
+      "bugfix"
+    end
+
+  end
+end

data/lib/commands/chore.rb

@@ -0,0 +1,19 @@
+require 'commands/pick'
+
+module Commands
+  class Chore < Pick
+
+    def type
+      "chore"
+    end
+    
+    def plural_type
+      "chores"
+    end
+    
+    def branch_suffix
+      "chore"
+    end
+
+  end
+end

data/lib/commands/feature.rb

@@ -0,0 +1,19 @@
+require 'commands/pick'
+
+module Commands
+  class Feature < Pick
+
+    def type
+      "feature"
+    end
+    
+    def plural_type
+      "features"
+    end
+    
+    def branch_suffix
+      "feature"
+    end
+
+  end
+end

data/lib/commands/finish.rb

@@ -0,0 +1,41 @@
+require 'commands/base'
+
+module Commands
+  class Finish < Base
+  
+    def run!
+      super
+      
+      # clunky way to get branch name... need better method
+      current_branch = get('git status | head -1').gsub(/^.+On branch /, '').chomp
+      story_id = current_branch[/\d+/]
+      unless story_id
+        put "Branch name must contain a Pivotal Tracker story id"
+        return 1
+      end
+
+      api = Pivotal::Api.new(:api_token => options[:api_token])
+      project = api.projects.find(:id => options[:project_id])
+      story = project.stories.find(:id => story_id)
+      
+      put "Marking Story #{story_id} as finished..."
+      if story.update_attributes(:current_state => :finished)
+      
+        target_branch = "develop"
+        put "Merging #{current_branch} into #{target_branch}"
+        sys "git checkout #{target_branch}"
+        sys "git merge --no-ff #{current_branch}"
+      
+        put "Removing #{current_branch} branch"
+        sys "git branch -d #{current_branch}"
+
+        return 0
+      else
+        put "Unable to mark Story #{story_id} as finished"
+        
+        return 1
+      end
+    end
+
+  end
+end

data/lib/commands/pick.rb

@@ -0,0 +1,61 @@
+require 'commands/base'
+
+module Commands
+  class Pick < Base
+  
+    def type
+      raise Error "must define in subclass"
+    end
+    
+    def plural_type
+      raise Error "must define in subclass"
+    end
+  
+    def branch_suffix
+      raise Error "must define in subclass"
+    end
+    
+    def run!
+      super
+    
+      put "Retrieving latest #{plural_type} from Pivotal Tracker..."
+      api = Pivotal::Api.new(:api_token => options[:api_token])
+
+      project = api.projects.find(:id => options[:project_id])
+      story = project.stories.find(:conditions => { :story_type => type, :current_state => :unstarted }, :limit => 1).first
+    
+      unless story
+        put "No #{plural_type} available!"
+        return 0
+      end
+    
+      put "Story: #{story.name}"
+      put "URL:   #{story.url}"
+
+      put "Updating #{type} status in Pivotal Tracker..."
+      if story.start!(:owned_by => options[:full_name])
+    
+        suffix = branch_suffix
+        unless options[:quiet]
+          put "Enter branch name (will be prepended by #{story.id}) [#{suffix}]: ", false
+          suffix = input.gets.chomp
+      
+          suffix = "feature" if suffix == ""
+        end
+
+        branch = "#{story.id}-#{suffix}"
+        if get("git branch").match(branch).nil?
+          put "Creating #{branch} branch..."
+          sys "git checkout -b #{branch}"
+        end
+    
+        return 0
+      else
+        put "Unable to mark #{type} as started"
+        
+        return 1
+      end
+    end
+
+  end
+end