• Installation
• Basic usage
• Experimental features
• Module compatibility
• Contributing
• Contact Information

The Puppet Development Kit (PDK) includes key Puppet code development and testing tools for Linux, Windows, and OS X workstations, so you can install one package with the tools you need to create and validate new modules.

PDK includes testing tools, a complete module skeleton, and command line tools to help you create, validate, and run tests on Puppet modules. PDK also includes all dependencies needed for its use.

PDK includes the following tools:

Download and install the newest package matching your platform from the download page. If you are using Windows, remember to close any open PowerShell windows.

For complete installation information, see the PDK documentation.

PDK can generate modules and classes, validate module metadata, style, and syntax, and run unit tests. This README contains very basic usage information---for complete usage information, see the PDK documentation.

Generates the basic components of a module and set up an infrastructure for testing it with PDK.

1. Run the pdk new module command, specifying the name of the new module:

pdk new module my_module

This command asks a series of metadata questions and then generates the basic components of a new module.

To generate a class in your module, use the pdk new class command, specifying the name of your new class. To generate the main class of the module, which is defined in an init.pp file, give the class the same name as the module.

1. From the command line, in your module's directory, run:

pdk new class class_name

PDK creates the new class manifest and a test file (as class_name_spec.rb) in your module's /spec/classes directory.

To generate a defined type in your module, use the pdk new defined_type command, specifying the name of your new defined type.

1. From the command line, in your module's directory, run:

pdk new defined_type defined_type_name

PDK creates the new defined_type manifest and a test file (as defined_type_name_spec.rb) in your module's /spec/defines directory.

To generate a task in your module, use the pdk new task command, specifying the name of your new task.

1. From the command line, in your module's directory, run:

pdk new task task_name

PDK creates the new task file and metadata.

PDK can validate the well-formedness of the module and style and syntax of its files.

1. In the module's directory, run:

pdk validate

This command validates the metadata, Puppet code syntax and style, and Ruby syntax and style for the entire module.

PDK's default template sets up rspec for Ruby-level unit testing, and rspec-puppet for catalog-level unit testing.

In the module's directory, run unit tests with:

pdk test unit

This command runs all available unit tests.

PDK Version Compatibility: Modules created with PDK validate against and run on all Puppet and Ruby version combinations currently under maintenance (see https://docs.puppet.com/puppet/latest/about_agent.html and https://puppet.com/misc/puppet-enterprise-lifecycle)

PDK encourages community contributions. See the CONTRIBUTING.md file for development notes.

This codebase is licensed under Apache 2.0. However, the open source dependencies included in this codebase might be subject to other software licenses such as AGPL, GPL2.0, and MIT.

• For reporting bugs
• To contact us with questions, join the Puppet Community on Slack