No description

Find a file

Jeff McCune 665610baaf (#13439 ) Fix test failures with Puppet 2.6.x Without this patch the spec_helper sends a message named initialize_everything_for_tests to Puppet.settings. This is a problem because Puppet 2.6.x does not have this method, only Puppet 2.7.x and Puppet master have this method at this time and we're getting false positive test failures. This patch fixes the problem by looking before we leap. We test if the private method exists before calling it. This works with Ruby 1.8.5 and onwards and Puppet 2.6, 2.7 and master. This should fix all of the failures I've caused in Jenkins today.		2012-03-29 16:52:15 -07:00
lib	(#13494 ) Specify the behavior of zero padded strings	2012-03-29 15:17:30 -07:00
manifests	Docs: Update documentation of stdlib classes	2011-08-18 12:39:04 -07:00
spec	(#13439 ) Fix test failures with Puppet 2.6.x	2012-03-29 16:52:15 -07:00
tests	(#8792 ) Rename basic smoke test to reflect file_line rename	2011-08-08 09:33:56 -07:00
.gitignore	(#8797 ) Merge puppetlabs-functions into puppetlabs-stdlib	2011-08-05 10:31:46 +01:00
CHANGELOG	Merge branch '2.1.x' into 2.2.x	2012-03-29 15:19:21 -07:00
LICENSE	(#8797 ) Merge puppetlabs-functions into puppetlabs-stdlib	2011-08-05 10:31:46 +01:00
Modulefile	Merge branch '2.1.x' into 2.2.x	2012-03-29 15:19:21 -07:00
Rakefile	(#11607 ) Add Rakefile to enable spec testing	2011-12-30 15:48:15 -08:00
README.markdown	(maint) Add semantic versioning info to README	2011-12-30 11:46:21 -08:00
RELEASE_PROCESS.markdown	Update CHANGELOG and README for 1.0.0	2011-08-04 17:24:46 -07:00

README.markdown

Puppet Labs Standard Library

This module provides a "standard library" of resources for developing Puppet Modules. This modules will include the following additions to Puppet

Stages
Facts
Functions
Defined resource types
Types
Providers

This module is officially curated and provided by Puppet Labs. The modules Puppet Labs writes and distributes will make heavy use of this standard library.

Versions

This module follows semver.org (v1.0.0) versioning guidelines. The standard library module is released as part of Puppet Enterprise and as a result older versions of Puppet Enterprise that Puppet Labs still supports will have bugfix maintenance branches periodically "merged up" into master. The current list of integration branches are:

v2.1.x (v2.1.1 released in PE 1.2, 1.2.1, 1.2.3, 1.2.4)
v2.2.x (Never released as part of PE, only to the Forge)
v2.3.x (Scheduled for next PE feature release)
master (mainline development branch)

The first Puppet Enterprise version including the stdlib module is Puppet Enterprise 1.2.

Compatibility

stdlib v2.1.x, v2.2.x

v2.1.x and v2.2.x of this module are designed to work with Puppet versions 2.6.x and 2.7.x. There are currently no plans for a Puppet 0.25 standard library module.

stdlib v2.3.x

While not yet released, the standard library may only work with Puppet 2.7.x.

Functions

Please see puppet doc -r function for documentation on each function. The current list of functions is:

getvar
has_key
loadyaml
merge.rb
validate_array
validate_bool
validate_hash
validate_re
validate_string

validate_hash

$somehash = { 'one' => 'two' }
validate\_hash($somehash)

getvar()

This function aims to look up variables in user-defined namespaces within puppet. Note, if the namespace is a class, it should already be evaluated before the function is used.

$namespace = 'site::data'
include "${namespace}"
$myvar = getvar("${namespace}::myvar")

Facts

Facts in /etc/facter/facts.d and /etc/puppetlabs/facter/facts.d are now loaded automatically. This is a direct copy of R.I. Pienaar's custom facter fact located at: https://github.com/ripienaar/facter-facts/tree/master/facts-dot-d