Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 3af8cc9ab9
Fetching contributors…

Cannot retrieve contributors at this time

55 lines (33 sloc) 1.548 kb

Pickler

Synchronize user stories in Pivotal Tracker with Cucumber features.

Getting started

gem install tpope-pickler --source=http://gems.github.com
echo "api_token: ..."  > ~/.tracker.yml
echo "project_id: ..." > ~/my/app/features/tracker.yml

For details about the Pivotal Tracker API, including where to find your API token and project id, see www.pivotaltracker.com/help/api .

The pull and push commands map the story's name into the “Feature: …” line and the story's description with an additional two space indent into the feature's body. Keep this in mind when entering stories into Pivotal Tracker.

Usage

pickler pull

Download all well formed stories to the features/ directory. Previously unseen stories will be given a numeric filename that you are encouraged to change.

pickler push

Upload all features with a tracker url in a comment on the first line.

pickler search <query>

List all stories matching the given query.

pickler show <id>

Show details for the story referenced by the id.

pickler start <id> [basename]

Pull a given feature and change its state to started. If basename is given and no local file exists, features/basename.feature will be created in lieu of features/id.feature.

pickler finish <id>

Push a given feature and change its state to finished.

Disclaimer

No warranties, expressed or implied.

Notably, the push and pull commands are quite happy to blindly clobber features if so instructed. Pivotal Tracker has a history to recover things server side.

Jump to Line
Something went wrong with that request. Please try again.