module-postgresql/spec/README.md

Warning: these spec tests are pretty resource intensive!

You will need the following in order to run them:

* Virtualbox
* vagrant
* 'sahara' gem
* The source code for all of the dependent modules; you should clone a copy of each of these at the same level in your directory structure as your copy of puppet-postgresql.  For best results you should check out the same tag that is specified as the dependency in the puppet-postgresql `Modulefile`.  At the time of this writing, here are the github repos you'll need (but check the `Modulefile` to make sure you're up to date):
    * stdlib : https://github.com/puppetlabs/puppetlabs-stdlib
    * firewall : https://github.com/puppetlabs/puppetlabs-firewall
    * apt : https://github.com/puppetlabs/puppetlabs-apt
* A decent chunk of free disk space (~300MB per distro tested)
* Patience :)

If you just run:

    rspec ./spec

then, for each distro that has a Vagrantfile in the spec/distros directory,
vagrant will download a base image from the web, fire up a VM, and run
the suite of tests against the VM.

If you only want to run the tests against an individual distro, you can
instead do something like:

    rspec ./spec/distros/ubuntu_lucid_64

For some options that might speed up the testing process a bit during development,
please see `spec/support/postgres_test_config.rb`.