Tests for a typename provider live at spec/unit/puppet/typename_spec.rb and
their corresponding fixture (starting file) under
spec/fixture/unit/puppet/typename/.
Use an rspec context section per fixture and have multiple examples within the section using it.
Tests use real resources which are applied to the system via the
AugeasSpec::Fixtures::apply method to a temporary file created from the
original fixture. Once applied, the temporary file is loaded back into Augeas
and the contents/structure of the file can be tested.
Execute rake spec in the root directory to run them.
After applying the resource, there are a few ways we could test the results of the file.
- use augparse? No API today, could generate module file and shell out.
- use Config::Augeas::Validator? Need to write separate rules, no rootdir support and is Perl, not Ruby.
- use XML comparison? No ruby-augeas support for aug_to_xml.
- use ruby-augeas? Using this as we can test for specific nodes, values etc and compare with rspec.
- use File.read + rspec? Comparing the whole file will be a problem if Augeas lenses change whitespace.
Install bundler and run bundle install to get all gems required for
development or see the contents of Gemfile.
This will include librarian-puppet, which you can then use to get all Puppet
modules required too with librarian-puppet install.
Please send pull requests via GitHub, or patches via git send-email to the author.