Package: bushy
BushyA git workflow plugin inspired bygit-pivotalbut intending to
support multiple project management platforms aside from just Pivotal Tracker.InstallationBushy is aPythonpackage and can be installed using
theeasy_installorpipcommands. For the most seamless integration
install the package so the generated console scripts are available in your $PATH.It is always advisable to install python packages within a virtualenv. If youactivateyour project virtualenv while developing, this will place the
commands in your $PATH automatically. Alternatively, you can create a dedicated
virtualenv for Bushy and add the scripts to your shell config. If you usebashyou could do the following to ensure the commands are accessible:$ virtualenv-2.6 --no-site-packages bushy
$ bushy/bin/pip install bushy
$ echo "export PATH=$PATH:/path/to/bushy/bin" >> ~/.bash_profileThis will allow you to run the following commands:$ git feature
$ git finish
$ git bugAs well as:$ /path/to/bushy/bin/git-feature
$ /path/to/bushy/bin/git-finish
$ /path/to/bushy/bin/git-bugUsagePivotal ConfigurationBushy requires global and project local configuration to integrate fully.Required local configuration (from within your project directory):$ git config -f .git/config bushy.platform pivotal # use Pivotal Tracker for this project
$ git config -f .git/config bushy-pivotal.project-id PROJECT_ID # from the project url on the Pivotal Tracker siteRequired global configuration:$ git config --global bushy-pivotal.api-token TOKEN # taken from the profile section on the Pivotal Tracker site
$ git config --global bushy-pivotal.full-name "YOUR NAME"Optional configuration:$ git config --global bushy-pivotal.integration-branch # the name of the integration branch if different from master
$ git config --global bushy-pivotal.only-mine # only select from new features that are assigned to youWorking on a new featureYou can select a new feature to work on using thegit-featurecommand:junkafarian$ git feature
Retrieving latest features from Pivotal Tracker
Story: hook up with pivotal
URL: http://www.pivotaltracker.com/story/show/8236507
Updating feature status in Pivotal Tracker...
Enter branch name (will be prepended by 8236507) [feature]:
Switching to branch 8236507-feature
junkafarian$If you want to work on a specific story you can specify the story id:junkafarian$ git feature -s 12345
Retrieving story 12345 from Pivotal Tracker
Story: hook up with pivotal
URL: http://www.pivotaltracker.com/story/show/12345
Updating feature status in Pivotal Tracker...
Enter branch name (will be prepended by 12345) [feature]:
Switching to branch 12345-feature
junkafarian$This will switch you to a new branch for working on the issue
selected.Once you have completed the development work / checked tests pass /
committed the changes, you can declare the task as finished:junkafarian$ git finish
Marking Story 8236507 as finished...
Merging 8236507-feature into master
Removing 8236507-feature branch
Merged code into trunk. Please push upstream and notify the release manager if necessary
junkafarian$You can then push these changes upstream.RoadmapUnit Tests - completedAllow features / bugs to be selected by ID on the commandline - completedSupport for github issuesEtymologyBushyencourages a workflow based entirely around code branches.
Bushes have lots of branches…CHANGES0.3 (unreleased)0.2.5 (2011-07-08)Fixed dependency on pivotal-py to >=0.1.3Changed import path for Pivotal0.2.4 (2011-07-08)Fixed dependency on pivotal-py to >=0.1.20.2.3 (2011-07-07)A bugfix release due to bad packaging when uploading to PyPI. Sorry to anyone who experienced problems!