Update puppetlabs/stdlib module

[mirror/dsa-puppet.git] / 3rdparty / modules / stdlib / lib / puppet / parser / functions / getparam.rb

diff --git a/3rdparty/modules/stdlib/lib/puppet/parser/functions/getparam.rb b/3rdparty/modules/stdlib/lib/puppet/parser/functions/getparam.rb
index 0a5cbe0..95981b3 100644 (file)
--- a/3rdparty/modules/stdlib/lib/puppet/parser/functions/getparam.rb
+++ b/3rdparty/modules/stdlib/lib/puppet/parser/functions/getparam.rb
@@ -3,31 +3,50 @@ require 'puppet/parser/functions'
 
 Puppet::Parser::Functions.newfunction(:getparam,
                                       :type => :rvalue,
-                                      :doc => <<-'ENDOFDOC'
-Takes a resource reference and name of the parameter and
-returns value of resource's parameter.
+                                      :doc => <<-'DOC'
+    Takes a resource reference and name of the parameter and
+    returns value of resource's parameter. Note that user defined
+    resource types are evaluated lazily.
 
-*Examples:*
+    *Examples:*
 
-    define example_resource($param) {
-    }
+        # define a resource type with a parameter
+        define example_resource($param) {
+        }
 
-    example_resource { "example_resource_instance":
-        param => "param_value"
-    }
+        # declare an instance of that type
+        example_resource { "example_resource_instance":
+            param => "'the value we are getting in this example''"
+        }
 
-    getparam(Example_resource["example_resource_instance"], "param")
+        # Because of order of evaluation, a second definition is needed
+        # that will be evaluated after the first resource has been declared
+        #
+        define example_get_param {
+          # This will notice the value of the parameter
+          notice(getparam(Example_resource["example_resource_instance"], "param"))
+        }
 
-Would return: param_value
-ENDOFDOC
-) do |vals|
+        # Declare an instance of the second resource type - this will call notice
+        example_get_param { 'show_notify': }
+
+    Would notice: 'the value we are getting in this example'
+
+    Note that since Puppet 4.0.0 it is possible to get a parameter value by using its data type
+    and the [ ] operator. The example below is equivalent to a call to getparam():
+
+        Example_resource['example_resource_instance']['param']
+
+  DOC
+                                     ) do |vals|
   reference, param = vals
   raise(ArgumentError, 'Must specify a reference') unless reference
-  raise(ArgumentError, 'Must specify name of a parameter') unless param and param.instance_of? String
+  raise(ArgumentError, 'Must specify name of a parameter') unless param && param.instance_of?(String)
 
   return '' if param.empty?
 
-  if resource = findresource(reference.to_s)
+  resource = findresource(reference.to_s)
+  if resource
     return resource[param] unless resource[param].nil?
   end