GitFlowPivotal

This gem adds a rake task that allows you to streamline your workflow if you use pivotal tracker and git-flow.

Installation

Make sure you've installed git-flow brew install git-flow. Use defaults for branch names.

Add this line to your application's Gemfile:

gem 'git_flow_pivotal'

And then execute:

$ bundle

Or install it yourself as:

$ gem install git_flow_pivotal

You will need to export a few variables to hook up to tracker

git config --global pivotal.fullname
git config --global pivotal.token your_token

Your full name must match your name in tracker. If you do not already have an API token you can generate one by clicking your name and going to preferences.

Run the following command and select the corrent project to complete setup.

rake pt:setup

Alternatively you can set the projectid manually:

git config pivotal.projectid tracker_project_id

Usage

The following tasks are available:

pt:list

Lists all unstarted and rejected stories assigned to you and asks which you want to start. Starting a story will update it in tracker and does "git flow feature start first_five_words_of_story_STORYID" 

pt:finish

Finishes current story in tracker and does "git flow feature finish branchname"

pt:comment text="Yo story whack"

Adds a comment to the current story

pt:web

Browses to current story in browser

The latter 3 require branch names consistent with what pt:list does to work properly.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request