<commit_before>tracker_packer (`tp`)
=====================

`tp` is a dead simple command-line utility for importing story templates into
[Pivotal Tracker](http://pivotaltracker.com) to save precious time on
your agile project. I mean, think of the velocity for heaven's sake!

Usage:

    tp --token=blah --project=123 --file=stories.yml

will create stories in the project with ID of 123 based on the yaml
template file provided. Upon completion, the newly created story IDs
are displayed as output.

Sample yaml template file:

    ---
    -  unstarted
       Provision server
    -  unstarted
       Init git repo
    -  unstarted
       Set gitosis permissions
    -  unstarted
       Set vhost entry

Really the only thing you need to provide is a story name. You can
further customize and tailor your stories (or chores) by setting the
desired attributes. See the PT API docs for more info.

`tp` owes its simplicity to the wonderful [pivotal-tracker](https://github.com/jsmestad/pivotal-tracker) [gem](http://rubygems.org/gems/pivotal-tracker).

In fact, there's nothing more to `tp` than slurping in yaml, looping
and creating stories. This gem is overkill.

Getting Started
---------------

* Installing:

    `gem install tracker_packer`

* Retrieving API token:

    `curl -u $USERNAME:$PASSWORD -X GET https://www.pivotaltracker.com/services/v3/tokens/active`

Additional Information
----------------------

* Pivotal API v3 info: 

* pivotal-tracker gem info: <commit_msg>update README to jive with core changes to the cmd line arguments<commit_after>tracker_packer (`tp`)
=====================

`tp` is a dead simple command-line utility for importing story templates into
[Pivotal Tracker](http://pivotaltracker.com) to save precious time on
your agile project. I mean, think of the velocity for heaven's sake!

Usage:

    tp template_file.yml

will create stories in the project with ID of 123 based on the yaml
template file provided. Upon completion, the newly created story IDs
are displayed as output.

Sample yaml template file:

    ---
    :token: <my_secret_api_token>
    :project: 123
    :stories:
      -  :current_state: unstarted
         :name: Provision server
         :story_type: chore
      -  :current_state: unstarted
         :name: Set up git repo
         :story_type: chore
      -  :current_state: unstarted
         :name: Set up DNS
         :story_type: chore
         :description: find out from client what they want to call their site

Really the only thing you need to provide is a story name. You can
further customize and tailor your stories (or chores) by setting the
desired attributes. See the PT API docs for more info.

`tp` owes its simplicity to the wonderful [pivotal-tracker](https://github.com/jsmestad/pivotal-tracker) [gem](http://rubygems.org/gems/pivotal-tracker).

In fact, there's nothing more to `tp` than slurping in yaml, looping
and creating stories. This gem is overkill.

Getting Started
---------------

* Installing:

    `gem install tracker_packer`

* Retrieving API token:

    `curl -u $USERNAME:$PASSWORD -X GET https://www.pivotaltracker.com/services/v3/tokens/active`

Additional Information
----------------------

* Pivotal API v3 info: <https://www.pivotaltracker.com/help/api?version=v3>

* pivotal-tracker gem info: <http://rdoc.info/projects/jsmestad/pivotal-tracker>
{'fraction_non_alphanumeric': 0.11107802263251935, 'fraction_numerical': 0.005062537224538415, 'mean_word_length': 3.2145545796737767, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 6, 'https://': 5, 'lorem ipsum': 0, 'www.': 3, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1130557', 'n_tokens_mistral': 1052, 'n_tokens_neox': 968, 'n_words': 381}