Project

pivo_flow

0.02
No commit activity in last 3 years
No release in over 3 years
Automated querying for pivotal stories, adding story id to commit message, etc.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
< 4

Runtime

 Project Readme

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.

Installation

Install it yourself as:

$ gem install pivo_flow

Usage

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

Git-hooks

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.

Changelog

See CHANGELOG.md file

Contributing

  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

Thanks

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.