git-pivotal-tracker 0.9.0

data/features/finish.feature

@@ -0,0 +1,119 @@
+Feature: git finish
+
+  In order to finish the card for the current topic branch you can issue the following 
+  commands:
+  
+    git finish 
+    git finish <options>
+
+  Supported options:
+    -k <api_key>    - specify the Pivotal API key to use. Overrides configuration.
+    -p <project_id> - specify the Pivotal project id to use. Overrides configuration.
+    
+  This will do the following:
+    * mark the card as finished in Pivotal
+    * push the topic branch to origin
+    * switch to 'acceptance' integration branch, run git pull, then merge in topic branch
+    * push 'acceptance' integration branch
+
+  Related git configuration settings:
+    * pivotal.acceptance-branch - this is where finished cards are merged. Defaults to acceptance.
+
+  Background:
+    Given I have a started Pivotal Tracker feature
+    And I am on the "CURRENT_CARD-feature" branch
+
+  Scenario: Executing with no settings
+    When I run `git-finish`
+    Then the output should contain:
+      """
+      Pivotal Tracker API Token and Project ID are required
+      """
+    And the exit status should be 1
+
+  Scenario: Executing with inline settings
+    When I run `git-finish -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT`
+    Then the output should contain:
+      """
+      Marking Story CURRENT_CARD as finished...
+      Pushing CURRENT_CARD-feature to origin
+      Pulling acceptance...
+      Merging CURRENT_CARD-feature into acceptance
+      Pushing acceptance to origin
+      Now on acceptance.
+      """
+    And I should be on the "acceptance" branch
+
+  Scenario: Executing with git configuration
+    Given a file named ".gitconfig" with:
+      """
+      [pivotal]
+        api-token = PIVOTAL_API_KEY
+        full-name = PIVOTAL_USER
+        project-id = PIVOTAL_TEST_PROJECT
+      """
+    When I run `git-finish -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT`
+    Then the output should contain:
+      """
+      Marking Story CURRENT_CARD as finished...
+      Pushing CURRENT_CARD-feature to origin
+      Pulling acceptance...
+      Merging CURRENT_CARD-feature into acceptance
+      Pushing acceptance to origin
+      Now on acceptance.
+      """
+    And I should be on the "acceptance" branch
+
+  Scenario: Executing from a misnamed branch
+    Given I am on the "missing-an-id" branch
+    When I run `git-finish -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT`
+    Then the output should contain:
+      """
+      Branch name must contain a Pivotal Tracker story id
+      """
+    And the exit status should be 1
+
+  Scenario: Specifying an integration branch in Git configuration
+    Given I have a "develop" branch
+    And a file named ".gitconfig" with:
+      """
+      [pivotal]
+        api-token = PIVOTAL_API_KEY
+        full-name = PIVOTAL_USER
+        acceptance-branch = develop
+        project-id = PIVOTAL_TEST_PROJECT
+      """
+    When I run `git-finish -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT`
+    Then the output should contain:
+      """
+      Marking Story CURRENT_CARD as finished...
+      Pushing CURRENT_CARD-feature to origin
+      Pulling develop...
+      Merging CURRENT_CARD-feature into develop
+      Pushing develop to origin
+      Now on develop.
+      """
+    And I should be on the "develop" branch
+
+  Scenario: Closing chore stories
+    Given I have a started Pivotal Tracker chore
+    And I am on the "CURRENT_CARD-chore" branch
+    And a file named ".gitconfig" with:
+      """
+      [pivotal]
+        api-token = PIVOTAL_API_KEY
+        full-name = PIVOTAL_USER
+        project-id = PIVOTAL_TEST_PROJECT
+      """
+    When I run `git-finish -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT`
+    Then the output should contain:
+      """
+      Marking Story CURRENT_CARD as finished...
+      Pushing CURRENT_CARD-chore to origin
+      Pulling acceptance...
+      Merging CURRENT_CARD-chore into acceptance
+      Pushing acceptance to origin
+      Now on acceptance.
+      """
+    And I should be on the "acceptance" branch
+  

data/features/info.feature

@@ -0,0 +1,99 @@
+Feature: git info
+
+  In order to get information about a specific card you can issue one of the following 
+  commands:
+
+    git info
+    git info <options>
+    git info <card_id>
+    git info <card_id> <options>
+
+  Supported options:
+    --comments      - displays comments for the card
+    -k <api_key>    - specify the Pivotal API key to use. Overrides configuration.
+    -p <project_id> - specify the Pivotal project id to use. Overrides configuration.
+    -D              - do not prompt for user input, use recommended values by default.
+    
+  Background:
+    Given I have a Pivotal Tracker feature named "Test Story" with description "This is the description!"
+    And I am on the "CURRENT_CARD-feature" branch
+
+  Scenario: Executing with no settings
+    When I run `git-info`
+    Then the output should contain:
+      """
+      Pivotal Tracker API Token and Project ID are required
+      """
+    And the exit status should be 1
+    
+  Scenario: Grabbing info about current topic branch
+    Given I have configured the Git repos for Pivotal
+    When I run `git-info`
+    Then the output should contain:
+      """
+      Story:         Test Story
+      URL:           http://www.pivotaltracker.com/story/show/CURRENT_CARD
+      State:         not accepted
+      Description:
+        This is the description!
+      """
+
+  Scenario: Supplying Pivotal configuration via command line arguments
+    When I run `git-info -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT -n "PIVOTAL_USER" -D`
+    Then the output should contain:
+      """
+      Story:         Test Story
+      URL:           http://www.pivotaltracker.com/story/show/CURRENT_CARD
+      State:         not accepted
+      Description:
+        This is the description!
+      """
+
+  Scenario: Grabbing info about a specific card in question topic branch
+    Given I have a Pivotal Tracker chore named "Test Chore" with description "The chore description!"
+    And I have configured the Git repos for Pivotal
+    When I run `git-info CURRENT_CARD`
+    Then the output should contain:
+      """
+      Story:         Test Chore
+      URL:           http://www.pivotaltracker.com/story/show/CURRENT_CARD
+      State:         not accepted
+      Description:
+        The chore description!
+      """
+
+  Scenario: Grabbing info when the card has labels
+    Given I have a Pivotal Tracker chore named "Test Chore" with description "The chore description!"
+    And the chore is labeled "foo, bar, baz"
+    And I have configured the Git repos for Pivotal
+    When I run `git-info CURRENT_CARD`
+    Then the output should contain:
+      """
+      Story:         Test Chore
+      URL:           http://www.pivotaltracker.com/story/show/CURRENT_CARD
+      Labels:        bar, baz, foo
+      State:         not accepted
+      Description:
+        The chore description!
+      """
+
+  Scenario: Requesting comments on a card using --comments
+    Given I have a Pivotal Tracker chore named "Test Chore" with description "The chore description!"
+    And the "PIVOTAL_USER" commented on the card "Well, this looks mighty fine!"
+    And I have configured the Git repos for Pivotal
+    When I run `git-info CURRENT_CARD --comments`
+    Then the output should contain "Comments:"
+    And the output should contain "Well, this looks mighty fine!"
+    And the output should contain "PIVOTAL_USER"
+
+  Scenario: Grabbing info when not on a topic branch and not supplying a card id
+    Given I have configured the Git repos for Pivotal
+    And I am on the "foo" branch
+    Then I should be on the "foo" branch
+    When I run `git-info`
+    Then the output should contain:
+      """
+      No story id was supplied and you aren't on a topic branch!
+      """
+  
+  

data/features/start.feature

@@ -0,0 +1,113 @@
+Feature: git start
+
+  In order to start the next available card in the project you can issue the following
+  commands:
+     
+     git start <options>
+     git start <card_type> <options>
+
+  Supported options:
+    -k <api_key>    - specify the Pivotal API key to use. Overrides configuration.
+    -p <project_id> - specify the Pivotal project id to use. Overrides configuration.
+    -D              - do not prompt for user input, use recommended values by default.
+    
+  This will check out a topic branch for the card and place you on it.
+  
+  Scenario Outline: Executing with no settings
+    When I run `<command>`
+    Then the output should contain:
+      """
+      Pivotal Tracker API Token and Project ID are required
+      """
+    And the exit status should be 1
+  
+    Examples:
+      | command           |
+      | git-start bug     |
+      | git-start chore   |
+      | git-start feature |
+
+  Scenario: Starting the next feature when it is unestimated
+    Given I have an unestimated Pivotal Tracker feature
+    And I have configured the Git repos for Pivotal
+    When I run `git-start feature -D`
+    Then the output should contain:
+      """
+      Stories in the started state must be estimated.
+      """
+    And the exit status should be 1
+
+  # Assumption: that chores can be started without being estimated in Pivotal
+  Scenario: Starting the next chore when it is unestimated
+    Given I have an unestimated Pivotal Tracker chore
+    And I have configured the Git repos for Pivotal
+    When I run `git-start chore -D`
+    Then the output should contain "Switched to a new branch 'CURRENT_CARD-chore'"
+    And I should be on the "CURRENT_CARD-chore" branch
+    And card CURRENT_CARD is marked is started in Pivotal Tracker
+
+  # Assumption: that estimating bugs in Pivotal is turned off
+  Scenario: Starting the next bug when it is unestimated
+    Given I have an unestimated Pivotal Tracker bug
+    And I have configured the Git repos for Pivotal
+    When I run `git-start bug -D`
+    Then the output should contain "Switched to a new branch 'CURRENT_CARD-bugfix'"
+    And I should be on the "CURRENT_CARD-bugfix" branch
+    And card CURRENT_CARD is marked is started in Pivotal Tracker
+
+  Scenario Outline: Starting the next estimated card interactively (without -D option)
+    Given I have a Pivotal Tracker <card_type>
+    And I have configured the Git repos for Pivotal
+    When I run `git-start <card_type>` interactively
+    And I type "a_purple_<card_type>"
+    Then the output should contain "Switched to a new branch 'CURRENT_CARD-a_purple_<card_type>'"
+    And I should be on the "CURRENT_CARD-a_purple_<card_type>" branch
+    And card CURRENT_CARD is marked is started in Pivotal Tracker
+    
+    Examples:
+      | card_type |
+      | bug       |
+      | chore     |
+      | feature   |
+
+  Scenario Outline: Starting the next estimated card using configured defaults (with -D option)
+    Given I have a Pivotal Tracker <card_type>
+    And I have configured the Git repos for Pivotal
+    When I run `git-start <card_type> -D`
+    Then the output should contain "Switched to a new branch 'CURRENT_CARD-<card_type><branch_suffix>'"
+    And I should be on the "CURRENT_CARD-<card_type><branch_suffix>" branch
+    And card CURRENT_CARD is marked is started in Pivotal Tracker
+    
+    Examples:
+      | card_type | branch_suffix |
+      | bug       |     fix       |
+      | chore     |               |
+      | feature   |               |
+
+  Scenario Outline: Starting a specific card
+    Given I have a Pivotal Tracker <card_type>
+    And I have configured the Git repos for Pivotal
+    When I run `git-start CURRENT_CARD -D`
+    Then the output should contain "Switched to a new branch 'CURRENT_CARD-<card_type><branch_suffix>'"
+    And I should be on the "CURRENT_CARD-<card_type><branch_suffix>" branch
+    And card CURRENT_CARD is marked is started in Pivotal Tracker
+    
+    Examples:
+      | card_type | branch_suffix |
+      | bug       |     fix       |
+      | chore     |               |
+      | feature   |               |
+
+  Scenario Outline: Supplying Pivotal configuration via command line arguments
+    Given I have a Pivotal Tracker <card_type>
+    And I have configured the Git repos for Pivotal with bogus information
+    When I run `git-start <card_type> -k PIVOTAL_API_KEY -p PIVOTAL_TEST_PROJECT -n "PIVOTAL_USER" -D`
+    Then the output should contain "Switched to a new branch 'CURRENT_CARD-<card_type><branch_suffix>'"
+    And I should be on the "CURRENT_CARD-<card_type><branch_suffix>" branch
+    And card CURRENT_CARD is marked is started in Pivotal Tracker
+
+    Examples:
+      | card_type | branch_suffix |
+      | bug       |     fix       |
+      | chore     |               |
+      | feature   |               |

data/features/step_definitions/steps.rb

@@ -0,0 +1,114 @@
+STORY_TYPE = /feature|bug|chore|release/
+STORY_STATE = /unscheduled|unstarted|started|finished|delivered|accepted|rejected/
+
+Transform /PIVOTAL|CURRENT/ do |placeholder|
+  placeholder.
+    gsub("PIVOTAL_API_KEY", "80f3c308cfdfbaa8f5a21aa524081690").
+    gsub("PIVOTAL_TEST_PROJECT", "516377").
+    gsub("PIVOTAL_USER", "Robotic Zach").
+    gsub("CURRENT_CARD", current_card.id.to_s)
+end
+
+Given "I debug" do
+  require 'pry'
+  binding.pry
+end
+
+Given /^I have configured the Git repos for Pivotal$/ do
+  step %|a file named ".gitconfig" with:|, <<-EOT.gsub!(/^\s+\S/, '')
+    |[pivotal]
+    |  api-token = PIVOTAL_API_KEY
+    |  full-name = PIVOTAL_USER
+    |  acceptance-branch  = acceptance
+    |  integration-branch = master
+    |  project-id = PIVOTAL_TEST_PROJECT
+  EOT
+end
+
+Given /^I have configured the Git repos for Pivotal with bogus information$/ do
+  step %|a file named ".gitconfig" with:|, <<-EOT.gsub!(/^\s+\S/, '')
+    |[pivotal]
+    |  api-token          = badtoken
+    |  full-name          = Bad Joe
+    |  integration-branch = whoknows
+    |  project-id         = something
+    |  remote             = origin
+  EOT
+end
+
+Given /^the "([^"]+)" commented on the card "([^"]+)"$/ do |author, text|
+  comment_on_story :author => author, :text => text
+end
+
+Given /^the (#{STORY_TYPE}|card) is labeled "([^"]+)"$/ do |type, labels|
+  update_test_story :labels => labels
+end
+
+Given /^I have a(?:n)? (#{STORY_STATE})?\s?Pivotal Tracker (#{STORY_TYPE})$/ do |status, type|
+  options = {}
+  options[:current_state] = status if status
+  create_test_story type, options
+end
+
+Given /^I have a(?:n)? unestimated \s?Pivotal Tracker (#{STORY_TYPE})$/ do |type|
+  options = { :estimate => -1 }
+  create_test_story type, options
+end
+
+Given /^I have a(?:n)? (#{STORY_STATE})?\s?Pivotal Tracker (#{STORY_TYPE}) named "([^"]+)" with description "([^"]+)"$/ do |status, type, name, description|
+  options = { :name => name, :description => description }
+  options[:current_state] = status if status
+  create_test_story type, options
+end
+
+Given /the card is a (#{STORY_TYPE})/ do |type|
+  update_test_story :story_type => type
+end
+
+Given /the (#{STORY_TYPE}) is unestimated/ do |type|
+  update_test_story :estimate => -1
+end
+
+Given /the (#{STORY_TYPE}) is (#{STORY_STATE})/ do |type, state|
+  update_test_story :current_state => state
+end
+
+Given /^I am on the "([^"]*)" branch$/ do |branch|
+  `git checkout -b #{branch} > /dev/null 2>&1`
+end
+
+Given /^I have a "([^"]*)" branch$/ do |branch|
+  `git branch #{branch} > /dev/null 2>&1`
+end
+
+When /^the current card is refreshed$/ do
+  refresh_current_card!
+end
+
+Then /^the card CURRENT_CARD should (not )?have the "([^"]*)" label$/ do |negate, label|
+  if negate
+    current_card.labels.to_s.should_not include(label)
+  else
+    current_card.labels.to_s.should include(label)
+  end
+end
+
+Then /^the card CURRENT_CARD should have the comment by "([^"]*)":$/ do |author, str|
+  current_card.notes.all.last.tap do |note|
+    note.author.should eq(author)
+    note.text.should include(str)
+  end
+end
+
+Then /^the card CURRENT_CARD should not have the comment:$/ do |str|
+  current_card.notes.all.detect{ |n| n.text.include?(str) }.should be_nil
+end
+
+
+Then /^I should be on the "([^"]*)" branch$/ do |branch|
+  current_branch.should == branch
+end
+
+Then /^card (CURRENT_\w+) is marked is started in Pivotal Tracker$/ do |card_id|
+  assert_card_is_started(card_id)
+end

data/features/support/dsl/assertions.rb

@@ -0,0 +1,11 @@
+module GitPivotal
+  module FeatureHelpers
+    module Assertions
+      def assert_card_is_started(id)
+        pivotal_project.stories.find(id).current_state.should eq("started")
+      end
+    end
+  end
+end
+
+World(GitPivotal::FeatureHelpers::Assertions)