PivoFlow

PivoFlow lets you choose the story you are currently working on from Pivotal Tracker. Intended for all the people, who doesn't like feature-branch approach or are "merdżuj - nie pier*ol"-theory enthusiasts.

Install it yourself as:

$ gem install pivo_flow

All the required information is gathered on demand, but it's a good idea to prepare:

• project's Pivotal Tracker ID

• your Pivotal Tracker API token (see here https://www.pivotaltracker.com/profile#api)

  • when project's ID is strictly connected with one project, API-token is for all the projects, so the best solution would be to add it globally to git config:

  git config --global pivo-flow.pivotal-token YOUR_PIVOTAL_API_TOKEN

Show help

pf help

or

pf --help

Get list of current stories with an interactive choice menu

pf stories

Start story with given ID

pf start STORY_ID

Finish current story [or given story ID]

pf finish [STORY_ID]

Clear current story without notifying Pivotal

pf clear

Show finished stories and select the one you would like to deliver

pf deliver

Display current gem version

pf version

Show current STORY_ID from temp file

pf current

This gem installs a pepare-commit-msg hook by adding a reference to pf-prepare-commit-msg file. In short: you shouldn't be worried about your own prepare-commit-msg hook, the one added by pivo_flow will be added in the last line of original hook file.

See CHANGELOG.md file

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

This gem is inspired by https://github.com/blindsey/git_pivotal_tracker. Thanks to it's author for the inspiration and idea. If you would like to use Pivotal with feature-branch-based flow, git_pivotal_tracker is the way you should proably go.