Build Status

PDQTest

PDQTest - Puppet Docker Quick-test - is the quickest and easiest way to test your puppet modules for Linux and Windows.

PDQTest features:

  • Static analysis testing (PDK):
    • Metadata
    • Syntax
    • Linting
    • RSpec
  • Acceptance testing for Linux and Windows:

PDQTest acceptance tests can be retrofitted to and PDK enabled module by running pdqtest init.

PDQTest runs static analysis tests within the machine it is running from and then loads a docker container to perform acceptance testing, sharing the puppet module and cached dependencies from your host.

This way you can destructively test your module without risking the host.

demo Adding PDQTest to a project and running acceptance tests in Docker

PDQTest 2.0 Release notes

PDQTest 2.0 new features:

PDQTest Manual

  1. Installation
  2. Enabling testing
  3. Running tests
  4. Acceptance tests
  5. Windows
  6. PDK Integration
  7. Puppet module dependencies
  8. Test generation
  9. Puppet facts
  10. Hiera
  11. Caching
  12. Emoji
  13. Upgrading
  14. Tips and tricks
  15. Troubleshooting
  16. Examples
  17. Development
  18. Inplace execution
  19. PDQTest 1.x -> 2.x Upgrade guide