Pivotxt lets you easily create stories in Pivotal Tracker from a simple text file.
Sure, there's slurper but I didn't like slurper's file format; it's too YAML-y.
Hint: if you need a vim plugin to help you write your stories file, it's probably overly-complicated.
So, I drafted a simple file format that I'd like to use and I wrote a grammar in Treetop to parse that format. Pivotxt is the result. Hopefully you'll find it as useful as I do.
Configuration & Usage
- Stick your appropriate values into pivotxt_config.yml
- Use bin/pivotxt like this: pivotxt stories.pivotxt
- You're done.
Sample stories.pivotxt file format
LabelOne LabelTwo - Features start with -'s as you can see (an inline description for this feature would go here) - Features can have multi-line descriptions too, like this one This is the first description line for the above feature. Here is another line. And yet another line here. - All stories nested under a line of labels will have those labels applied to them. In this case, we'll end up with 3 features and 2 chores, all with the 'LabelOne' and 'LabelTwo' labels assigned to them because these are all nested under the 'LabelOne LabelTwo' line above.  Chores look like check boxes (and they can have inline descriptions too)  Chores can also have multi-line descriptions Here's a multiline description for the above chore. This is a second line of description. AnotherLabel - Obviously, you can have as many labeled groups of stories as you want. This feature belongs to a new label group called 'AnotherLabel' and it will be the only story created for the 'AnotherLabel' label.
- Special thanks to Clifford Heath (@cliffordheath) for helping me grok Treetop and get started with my grammar.
- Thanks to Hashrocket's slurper for the inspriation.
MIT Licensed. Copyright (c) 2010 Gabe Hollombe. See LICENSE for details.