#Git Pivotal

##Prelude
You might want to have [this song](http://www.dailymotion.com/video/x9vzh0_olivia-newton-john-lets-get-physica_music) running in the background while you read this.

##Let's Git Pivotal
Inspired by [Hashrocket's blend of git and Pivotal Tracker](http://reinh.com/blog/2009/03/02/a-git-workflow-for-agile-teams.html) and [a popular article on effective git workflows](http://nvie.com/archives/323), I set off to create a set of utilities to simplify the workflow between the two.

###Git Pick
This selects the top-most available feature from your Pivotal Tracker, and offers to create a feature branch.

    1 git-pick:master % git pick
    Collecting latest stories from Pivotal Tracker...
    Story: Test git pivotal
    URL:   http://www.pivotaltracker.com/story/show/1234567
    Accept this story? (Yn): y
    Suggested branch: feature-1234567
    Accept this name? (Yn): y
    Creating feature-1234567 branch...
    Updating story status in Pivotal Tracker...
    2 git-pick:feature-1234567 %
    
##Installation
To install git-pivotal, simply run

    [sudo] gem install git-pivotal

<h2 id="config">Configuration</h2>
Once installed, git pivotal needs three bits of info: your Pivotal Tracker API Token, your name as it appears in Pivotal Tracker and your Pivotal Tracker project id.  The former two are best set as a global git config options:

    git config --global pivotal.api-token 9a9a9a9a9a9a9a9a9a9a
    git config --global pivotal.full-name "Jeff Tucker"

The project id is best placed within your project's git config:

    git config -f .git/config pivotal.project-id 88888

If you're not interested in storing these options in git, you can pass them into git pivotal as command line arguments.  See the usage guides for more details.

##TODO
This is <del>some seriously</del> alpha software.  Several things on the ol' todo list:

* <del>Create a general Pivotal::Base#update_attributes method</del>
* <del>`git pick` doesn't update the story to indicate who claimed it</del>
* Add command to close/finish currently 'picked' feature
* Reduce verbosity of `git pick`
* More that I can't recall at the moment