Skip to content

Import stories into Pivotal Tracker from simply a formatted text file.

License

Notifications You must be signed in to change notification settings

gabehollombe/Pivotxt

Repository files navigation

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

  1. Stick your appropriate values into pivotxt_config.yml
  2. Use bin/pivotxt like this: pivotxt stories.pivotxt
  3. 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.

Acknowledgements

Contributors

  • @gabehollombe
  • @dpickett

Copyright

MIT Licensed. Copyright (c) 2010 Gabe Hollombe. See LICENSE for details.

About

Import stories into Pivotal Tracker from simply a formatted text file.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages