<commit_before>= puppetshow

Description goes here.

== Contributing to puppetshow
 
* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
* Fork the project.<commit_msg>new description and warning<commit_after>= PuppetShow

PuppetShow is a Cucumber[http://cukes.info] extention for using
VirtualBox[https://www.virtualbox.org/] virtual machines to test the
behavior of applying Puppet[http://www.puppetlabs.com] configurations
to live (virtual) systems.

Vagrant[http://vagrantup.com] is used for managing the virtual systems
including fetching base images from the internet.  The
Sahara[https://github.com/jedi4ever/sahara]
Vagrant[http://vagrantup.com] plugin is used to manage sandboxing teh
virtual systems so changes introduced during test runs are rolled back
and all tests run against a pristine image.

== Caveats

* we absolutely require vagrant (~> 1.0), sahara still requires vagrant
  (~> 0.9)  -- untill sahara bumps a rev upstream this means to get
  this to work at all you will need to kludge
  $GEM_PATH/specifications/sahara-0.0.10.gemspec (I expect 0.0.11 will
  allow for the newer vagrant)

* this is very new code it is not nealy as DRY as is should be and
  likely still contains hardcoded references to my development
  environment -- best to think of it as an example of an idea rather
  than a tool at this point 

== Contributing to puppetshow
 
* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
* Fork the project.
{'fraction_non_alphanumeric': 0.06161673261729791, 'fraction_numerical': 0.007348784624081402, 'mean_word_length': 4.267857142857143, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 2, 'lorem ipsum': 0, 'www.': 2, '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': '284565', 'n_tokens_mistral': 516, 'n_tokens_neox': 489, 'n_words': 243}