puppet 3.8.7 → 4.0.0

data/man/man8/puppet-report.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-REPORT" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-REPORT" "8" "March 2015" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-report\fR \- Create, display, and submit reports\.
@@ -10,7 +10,7 @@
 puppet report \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .SH "OPTIONS"
-Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
+Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
@@ -44,32 +44,6 @@ The terminus for an action is often determined by context, but occasionally need
 .SH "ACTIONS"
 .
 .TP
-\fBdestroy\fR \- Invalid for this face\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet report destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this face\.
-.
-.TP
-\fBfind\fR \- Invalid for this face\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet report find [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this face\.
-.
-.TP
 \fBinfo\fR \- Print the default terminus class for this face\.
 \fBSYNOPSIS\fR
 .
@@ -102,19 +76,6 @@ API only: create or overwrite an object\. As the Faces framework does not curren
 Nothing\.
 .
 .TP
-\fBsearch\fR \- Invalid for this face\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet report search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this face\.
-.
-.TP
 \fBsubmit\fR \- API only: submit a report with error handling\.
 \fBSYNOPSIS\fR
 .
@@ -133,45 +94,22 @@ API only: Submits a report to the puppet master\. This action is essentially a s
 .P
 From the implementation of \fBpuppet report submit\fR (API example):
 .
-.IP "" 4
-.
-.nf
-
-begin
-  Puppet::Transaction::Report\.indirection\.terminus_class = :rest
-  Puppet::Face[:report, "0\.0\.1"]\.save(report)
-  Puppet\.notice "Uploaded report for #{report\.name}"
-rescue => detail
-  Puppet\.log_exception(detail, "Could not send report: #{detail}")
-end
-.
-.fi
-.
-.IP "" 0
+.P
+begin Puppet::Transaction::Report\.indirection\.terminus_class = :rest Puppet::Face[:report, "0\.0\.1"]\.save(report) Puppet\.notice "Uploaded report for #{report\.name}" rescue => detail Puppet\.log_exception(detail, "Could not send report: #{detail}") end
 .
 .P
 \fBsubmit\fR
 .
 .P
-From secret_agent\.rb (API example):
-.
-.IP "" 4
-.
-.nf
-
-# \.\.\.
-report  = Puppet::Face[:catalog, \'0\.0\.1\']\.apply
-Puppet::Face[:report, \'0\.0\.1\']\.submit(report)
-return report
-.
-.fi
-.
-.IP "" 0
+API example:report = Puppet::Face[:catalog, \'0\.0\.1\']\.apply Puppet::Face[:report, \'0\.0\.1\']\.submit(report) return report
 .
 .SH "NOTES"
 This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of Puppet\. Valid termini for this face include:
 .
 .IP "\(bu" 4
+\fBmsgpack\fR
+.
+.IP "\(bu" 4
 \fBprocessor\fR
 .
 .IP "\(bu" 4

data/man/man8/puppet-resource.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-RESOURCE" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-RESOURCE" "8" "March 2015" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-resource\fR \- The resource abstraction layer shell
@@ -10,7 +10,7 @@
 Uses the Puppet RAL to directly interact with the system\.
 .
 .SH "USAGE"
-puppet resource [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-H|\-\-host \fIhost\fR] [\-p|\-\-param \fIparameter\fR] [\-t|\-\-types] \fItype\fR [\fIname\fR] [\fIattribute\fR=\fIvalue\fR \.\.\.]
+puppet resource [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-p|\-\-param \fIparameter\fR] [\-t|\-\-types] [\-y|\-\-to_yaml] \fItype\fR [\fIname\fR] [\fIattribute\fR=\fIvalue\fR \.\.\.]
 .
 .SH "DESCRIPTION"
 This command provides simple facilities for converting current system state into Puppet code, along with some ability to modify the current state using Puppet\'s RAL\.
@@ -22,7 +22,7 @@ By default, you must at least provide a type to list, in which case puppet resou
 If given a type, a name, and a series of \fIattribute\fR=\fIvalue\fR pairs, puppet resource will modify the state of the specified resource\. Alternately, if given a type, a name, and the \'\-\-edit\' flag, puppet resource will write its output to a file, open that file in an editor, and then apply the saved file as a Puppet transaction\.
 .
 .SH "OPTIONS"
-Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument\. For example, \'ssldir\' is a valid configuration parameter, so you can specify \'\-\-ssldir \fIdirectory\fR\' as an argument\.
+Note that any setting that\'s valid in the configuration file is also a valid long argument\. For example, \'ssldir\' is a valid setting, so you can specify \'\-\-ssldir \fIdirectory\fR\' as an argument\.
 .
 .P
 See the configuration file documentation at http://docs\.puppetlabs\.com/references/stable/configuration\.html for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \'\-\-genconfig\'\.
@@ -55,6 +55,10 @@ List all available types\.
 \-\-verbose
 Print extra information\.
 .
+.TP
+\-\-to_yaml
+Output found resources in yaml format, suitable to use with Hiera and create_resources\.
+.
 .SH "EXAMPLE"
 This example uses \fBpuppet resource\fR to return a Puppet configuration for the user \fBluke\fR:
 .

data/man/man8/puppet-resource_type.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-RESOURCE_TYPE" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-RESOURCE_TYPE" "8" "March 2015" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-resource_type\fR \- View classes, defined resource types, and nodes from all manifests\.
@@ -16,7 +16,7 @@ This subcommand reads information about the resource collections (classes, nodes
 It will eventually be extended to examine native resource types\.
 .
 .SH "OPTIONS"
-Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
+Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
@@ -50,19 +50,6 @@ The terminus for an action is often determined by context, but occasionally need
 .SH "ACTIONS"
 .
 .TP
-\fBdestroy\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet resource_type destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this subcommand\.
-.
-.TP
 \fBfind\fR \- Retrieve info about a resource collection\.
 \fBSYNOPSIS\fR
 .
@@ -104,19 +91,6 @@ puppet resource_type info [\-\-terminus TERMINUS] [\-\-extra HASH]
 Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the \'\-\-run_mode\' option\.
 .
 .TP
-\fBsave\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet resource_type save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this subcommand\.
-.
-.TP
 \fBsearch\fR \- Search for collections matching a regular expression\.
 \fBSYNOPSIS\fR
 .

data/man/man8/puppet-status.8

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET\-STATUS" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET\-STATUS" "8" "March 2015" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\-status\fR \- View puppet server status\.
@@ -10,7 +10,7 @@
 puppet status \fIaction\fR [\-\-terminus TERMINUS] [\-\-extra HASH]
 .
 .SH "OPTIONS"
-Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid configuration parameters, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
+Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
 .
 .P
 See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
@@ -44,24 +44,11 @@ The terminus for an action is often determined by context, but occasionally need
 .SH "ACTIONS"
 .
 .TP
-\fBdestroy\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet status destroy [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this subcommand\.
-.
-.TP
 \fBfind\fR \- Check status of puppet master server\.
 \fBSYNOPSIS\fR
 .
 .IP
-puppet status [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
+puppet status [\-\-terminus TERMINUS] [\-\-extra HASH] [\fIkey\fR]
 .
 .IP
 \fBDESCRIPTION\fR
@@ -70,7 +57,7 @@ puppet status [\-\-terminus TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
 Checks whether a Puppet server is properly receiving and processing HTTP requests\. This action is only useful when used with \'\-\-terminus rest\'; when invoked with the \fBlocal\fR terminus, \fBfind\fR will always return true\.
 .
 .IP
-Over REST, this action will query the configured puppet master by default\. To query other servers, including puppet agent nodes started with the \fI\-\-listen\fR option, you can set set the global \fI\-\-server\fR and \fI\-\-masterport\fR options on the command line; note that agent nodes listen on port 8139\.
+Over REST, this action will query the configured puppet master by default\. To query other servers, including puppet agent nodes started with the \fI\-\-listen\fR option, you can set the global \fI\-\-server\fR and \fI\-\-masterport\fR options on the command line; note that agent nodes listen on port 8139\.
 .
 .IP
 \fBRETURNS\fR
@@ -84,9 +71,6 @@ A "true" response or a low\-level connection error\. When used from the Ruby API
 .IP
 This action requires that the server\'s \fBauth\.conf\fR file allow find access to the \fBstatus\fR REST terminus\. Puppet agent does not use this facility, and it is turned off by default\. See \fIhttp://docs\.puppetlabs\.com/guides/rest_auth_conf\.html\fR for more details\.
 .
-.IP
-Although this action always returns an unnamed status object, it requires a dummy argument\. This is a known bug\.
-.
 .TP
 \fBinfo\fR \- Print the default terminus class for this face\.
 \fBSYNOPSIS\fR
@@ -100,32 +84,6 @@ puppet status info [\-\-terminus TERMINUS] [\-\-extra HASH]
 .IP
 Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the \'\-\-run_mode\' option\.
 .
-.TP
-\fBsave\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet status save [\-\-terminus TERMINUS] [\-\-extra HASH] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this subcommand\.
-.
-.TP
-\fBsearch\fR \- Invalid for this subcommand\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet status search [\-\-terminus TERMINUS] [\-\-extra HASH] \fIquery\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Invalid for this subcommand\.
-.
 .SH "EXAMPLES"
 \fBfind\fR
 .
@@ -133,7 +91,7 @@ Invalid for this subcommand\.
 Check the status of the configured puppet master:
 .
 .P
-$ puppet status find x \-\-terminus rest
+$ puppet status find \-\-terminus rest
 .
 .SH "NOTES"
 This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of Puppet\. Valid termini for this face include:

data/man/man8/puppet.8

@@ -1,10 +1,10 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "PUPPET" "8" "January 2013" "Puppet Labs, LLC" "Puppet manual"
+.TH "PUPPET" "8" "March 2015" "Puppet Labs, LLC" "Puppet manual"
 .
 .SH "NAME"
 \fBpuppet\fR
 .
 .P
-See \'puppet help\' for help on available puppet subcommands
+[1;31mError: Could not parse application options: invalid option: \-\-help[0m

data/spec/fixtures/integration/provider/mailalias/aliases/test1

@@ -26,3 +26,6 @@ decode:     root
 # Other tests
 anothertest: "|/path/to/rt-mailgate --queue 'another test' --action correspond --url http://my.com/"
 test: "|/path/to/rt-mailgate --queue 'test' --action correspond --url http://my.com/"
+
+# Included file
+incfile: :include: /tmp/somefile

data/spec/fixtures/integration/provider/sshkey/sample

@@ -0,0 +1,21 @@
+hosting2.planetargon.com,64.34.164.77 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAy+f2t52cDMrYkgEKQ6juqfMf/a0nDFry3JAzl+SAWQ0gTklVxNcVbfHx2pkZk66EBGQfrK33Bx1BflZ/iEDyiCwmzVtNba0X9A6ELYjB9WSkWdIqZCfPlKZMu9N//aZ6+3SDVuz/BVFsAVmtqQ4Let2QjOFiSIKXrtPqWvVT/MM=
+kirby.madstop.com,192.168.0.5 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAw9iHuAa/wepHoUzWqsvhQvSkpE4K7agrdLOWHM9mvyRQ2X3HVq5GqzAvWu4J+f0FvcLPwA9tivpxt1oSt5MOtvDM6HoM+8m3P4daBp0nlNaYR8/vHCAmX6N3RyM8FWfp+VqWyux1SooQwxYxVFy86G78ApTqNsZ+p7cHmnBYqk0=
+fedora1,192.168.0.51 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAyz1rKcApU4//j8CHYKexq4qnq2WVqLPrZYGnlij1t7FscLiDVKvBuRHVkfyTNIjAM/t7tM1Dj+FuD4iWziCmf7RO9q4wI5y/1zgCiSUegnZVSmH2yxnWGMdHGpXOkN3NXcpy6jylxyBo0M7T22PSezCxyUVfMclesjOEO1jETd0=
+kirby ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAw9iHuAa/wepHoUzWqsvhQvSkpE4K7agrdLOWHM9mvyRQ2X3HVq5GqzAvWu4J+f0FvcLPwA9tivpxt1oSt5MOtvDM6HoM+8m3P4daBp0nlNaYR8/vHCAmX6N3RyM8FWfp+VqWyux1SooQwxYxVFy86G78ApTqNsZ+p7cHmnBYqk0=
+sol10b,192.168.0.50 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAs37kiDwKxWqi6EfSdKwRaZXBwh2doOARRqZzyitBaPwESy26DwTx+xdQ2rwB4V2k1WIec+1f3bgTS2ArH75dQSPyba2HKqxaSRBd3Zh4z23+uUxpupEyoRdW1HolMOvuoceheSMsruiuYcuiyct41d4c/Qmr51Dv04Doi00k6Ws=
+piratehaven.org,64.81.59.88 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEA7TYRRkle0wDNohZ0TNZN6R1Zp0svxgX+GJ9umI5yNM1bMxUTgeNRh5nIvZg1HgD1WRXQ57dSxxLzbvRyAqc245g6S8eWWCtenvOFLl0rOF5D3VxbQuw79sOe8/Ac8TC+c8RuWB7aaxpwL5Rv9xfDeazOtoKXj7+uwQW1PUmTaEM=
+atalanta,192.168.0.10 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAysniuWiJH6OQLXl63XXcS1b/hP2lAgSz0IutjQ6ZUfBrt1BZ8udEgSh57w5QDLsZ1lNvND61u5cy6iDKXI5TIQY4DvUmsoFZhyr4iYJbtT/h6UJSyaZtEnA7ZMRjGhUIMOn+mjbj7Z3zmJMhxtImK3Xo3O2fJ1hnK4jsBwQPSLc=
+pixie,192.168.0.9 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzDp588CvET6w11LB2s/vPjc4tX9+u46iYJgNFfhzxrXYMVv4GF7d30IXB5+Hwyi2FOQIG1+h0kUXVGWEv64rAFBT7pD2KMFX0lcDERV4avqT0TRDIIA5OqFOhq9Ff+kOmHS2cB7eFyR5vqbN4ujOnJGTmru9dcqyL+2AcFekvh0=
+culain,192.168.0.3 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAvJ/IORhQMdAsJ7LB1sI2LlWUHc7HPTCDiEgJ96ij3jFvqaIiYieRFaNkxbbk75mPkj3vIqWIgAsAtHmKX4wDikNG/gyjs4WM4cWFKtl2jiVhqpoxqqCaVxs6Ex+vpKuKhQR6SzFBFDlBZYP9an6DPu1msTLT8/hZH2WwswVmpyU=
+cs312-server.een.orst.edu,128.193.40.66 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEA+t3hsOiyp1mztt013bLdJqIAFCo8lxlz86MYEPz/mADHzWLs3Xv7xpAUv/E8pRbhEOzXo84EddORRBXz6DgVyMah8+v/u3IOkpXuZI0Iu1n5hZyf2l5DGEyGecr3oqqjUdMuM9HeXFLnqXJI3hDE7civBtqf5AJSol+TCcipeE8=
+freebsd1,192.168.0.52 ssh-dss AAAAB3NzaC1kc3MAAACBAJSiOyQhYlKAi0FDLKy42VzLDq6yJWXGXVCLSfgWyVx7QCq/3+W3C1dtHuAvjbypcjqqvsuGGITgQ1Y6B/+76n5d7FyQnj4SFZ5drOBn/TvslXhrS/Ok5KCcndfNAa+EyMnSZJ21jhoRjZftY4lmb4hy6fEF3RvjuOdf1qBN5FWpAAAAFQDcsWF0zELAW6YUlSjAyO0T0lfPbwAAAIAlOLdOd/WszzVaplCOnH5vF6LWfr6BosZKDkFi0mv6Ec636YGaj4AMxK8sRPusHv6sVByN17ntIJnLo2XD1SuoH28bZ0ZnPIdVnd0l1KqsOCuuow9LZYJUihezoUuYuTvij1jZdrwltuPNJTVLYtsZDnKE5plw+Tjzeb7ImjbXGwAAAIBT40olg3fxhRDiZECle0WK7GitgXCB3njs+4dba8VwveEJb9UuulMc1eR+zQiJR96IUBagC9NiLvUGS1IfiIHpT4FA8O/MK1W9SgxXB9d39Nk/9l8dH3U/fLnbC/hYVo8bN0or/mKxcxQMkdBwpPlWAbELRftod2BkkkvgfQdc+g==
+192.168.0.2 ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgwCZ+qxpMMRJ3otGsjaYeKTKf6tuCZyK1cD+ns9Eu7V0ZJLJ/LLMxduu7n4H/ufGI5rGV5axzgx8yZhjDRzsrGjLAQYsqlomMkf901YQI6UuieSA4MZa5MDkq/Jt6Vx1kEGTpkgrfw9kRMX5BngECt1QKY4xTgC7Ex+WlFvZwk+tRUT3
+openbsd1,192.168.0.54 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAvgRVrtJk0fBg9YsLf7rWR1X32ZjFcva5XBvenDlHruObaHzuGXyyr6iOCAEOc7eCZjlPBYrGZ2potqyk8HlBOHXr1cCBf49t4yAt8KgKswtzWlgdbU1UEwllSRVOpzqULAT0smv/jfaIZdvRoN1rLriqtpn4bQL//ZOHiyXCwdlJ+di8Mza2L8KZ5T75hwIFBhrgL12xfymRp3v+Iy21MjjzsF3pROIkZ7icitNqQF55U9vsHaA37vG8FepVkO10bYYP7IHPZaBPBMPx7qPyRgRDJahEUGBnkIkzwJHEmA+7YMiNTZu6MigezD+CIqY1xOi/eXZwObLwLKXo7eRmpw==
+192.168.0.60 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAufcvE7s1eRwhUwMBfZ6uFNxkdSdzjSDEn3vjByOjG/eraNhnYAW3rxV7WIf2pEa6JSOMrE1mqsEL75xEtpXlzC949Ysz4+1OSHY52KonoFm/a+FbmbFp81TVuVPYaLoeWN27STiJh+puC5spkIZe0laqT1GU13M4gj6B+j3NLhU=
+rh3a,192.168.0.55 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAufcvE7s1eRwhUwMBfZ6uFNxkdSdzjSDEn3vjByOjG/eraNhnYAW3rxV7WIf2pEa6JSOMrE1mqsEL75xEtpXlzC949Ysz4+1OSHY52KonoFm/a+FbmbFp81TVuVPYaLoeWN27STiJh+puC5spkIZe0laqT1GU13M4gj6B+j3NLhU=
+tsetse,192.168.0.7 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwCDGn82BEMSCfcE2LZKcwdAoyIBC+u2twVwWNRm3KzyrJMQ+RbTQo4AwGOdyr/QYh6KaxTKTSoDtiBLr132uenMQKwF47gCKMA1T47uiy+TBUehgOGwOxteSYP/pQRpKXFmhOppSPyDPQVq234XvANeJp0iT8ZKEhF2FsWTs6sM=
+config.sage.org,131.106.3.205 ssh-dss AAAAB3NzaC1kc3MAAACBAL2akEcIfQsfm3zCd2hD6PgH3kWA/tqX/qbrLhL/ipX7iqK/y282GMClZQSQjc1YNi9virvLzb6u/gdZxicZ8K5O3FaJrULQJOZaP62SOHk5CUSHVnvpMCaCnbwB6gEHa2LeMWStcEfWW+g1CC2hzPJw16/S5GISGXbyanO02MnXAAAAFQDomwx/OCjTmmQljMTU5rgNn2E4gwAAAIBmtMSfcs2Tq5iFFKK5cahluv047vVNfXqYIAkeJniceL0Et16MKfuzadpq0H9ocxQYW/5Ir9nUULrdxBUN9LxNKq15/uWkJC9QCSh8PysgvFnjVZeCODua/dn6eZTZnY9DZ3S6v1pT8CP6uWr5fmZJ8FKJGrC3gYX4y1V1ZTCVewAAAIB6e7RCST6vkTS5rgn5wGbrfLK5ad+PW+2i66k77Zv1pjtfRz+0oejBjwJDPNVSc2YNEl7X0nEEMNjo/a5x8Ls+nVqhzJA+NXIwS1e/moKbXFGewW5HAtxd79gtInC8dEIO7hmnWnqF1dBkRHXg1YffYkHrMVJBxpzagw7nYa0BBQ==
+rh3b,192.168.0.56 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAufcvE7s1eRwhUwMBfZ6uFNxkdSdzjSDEn3vjByOjG/eraNhnYAW3rxV7WIf2pEa6JSOMrE1mqsEL75xEtpXlzC949Ysz4+1OSHY52KonoFm/a+FbmbFp81TVuVPYaLoeWN27STiJh+puC5spkIZe0laqT1GU13M4gj6B+j3NLhU=
+centos1,192.168.0.57 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEA0DXqYF+3Lf68GkWBAjjKBb6UITNnzm4wiDi/AGjv5+DoVXqDcqHvZ8rZFAMgUe1dVob4pWT2ZWLHW0gicoJCdr4UQbPXlWz1F62z8fo2PRRPlG6KN1wmF7pnyml8jr0wBX8lQZJsMqi4InGozf7wFHLH/7DNGRK3MD6tSp3Z4is=
+doorstop.cafes.net,205.241.238.186 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEApJKeB9/bN5t55zLETHs0MVo/vEkfQ3EzY7178GKLI/yiOFmcn+NvUvUtCQK/xKpod813LBHCODxZPG1Kb0SjlaC/EkFEenb74LNu0o1qXa1GWh3wfaIm0JRNjXqPqxAWTlMs43O2HXwOwmLVhl7SSP3xtTw6h9gREbVKmfBaRdsRfzD0etfz1NCnmGh/1Sh9+j4eeS+IBtwoR5JVhZVhuofHCqs5HZ8gLDgfn8HXP7pMbLkx54cf1R/tmFmn9JGLdTPtEGcSIiu7414XSbfChSC83rGZCDPKHq7ZodiE8GpbWLBnyPXi2AYxTPM7aZMqitIHv3MWf5suV0q0WLGdnQ==
+host.domain.com,host1.domain.com,192.168.0.1 dss thisismykey1

data/spec/fixtures/unit/data_providers/environments/production/environment.conf

@@ -0,0 +1,2 @@
+environment_timeout = 0
+environment_data_provider = 'function'

data/spec/fixtures/unit/data_providers/environments/production/lib/puppet/functions/environment/data.rb

@@ -0,0 +1,7 @@
+Puppet::Functions.create_function(:'environment::data') do
+  def data()
+    { 'abc::def::test1' => 'env_test1',
+      'abc::def::test2' => 'env_test2'
+    }
+  end
+end

data/spec/fixtures/unit/data_providers/environments/production/modules/abc/lib/puppet/bindings/abc/default.rb

@@ -0,0 +1,9 @@
+Puppet::Bindings.newbindings('abc::default') do
+  # In the default bindings for this module
+  bind {
+    # bind its name to the 'puppet' environment data provider
+    name         'abc'
+    to           'function'
+    in_multibind 'puppet::module_data'
+ }
+end

data/spec/fixtures/unit/data_providers/environments/production/modules/abc/lib/puppet/functions/abc/data.rb

@@ -0,0 +1,8 @@
+Puppet::Functions.create_function(:'abc::data') do
+  def data()
+    { 'abc::def::test1' => 'module_test1',
+      'abc::def::test2' => 'module_test2',
+      'abc::def::test3' => 'module_test3'
+    }
+  end
+end

data/spec/fixtures/unit/data_providers/environments/production/modules/abc/manifests/init.pp

@@ -0,0 +1,9 @@
+class abc {
+  include 'abc::def'
+}
+
+class abc::def ($test1, $test2, $test3) {
+  notify { $test1: }
+  notify { $test2: }
+  notify { $test3: }
+}

data/spec/fixtures/unit/data_providers/environments/sample/environment.conf

@@ -0,0 +1,2 @@
+# Use the 'sample' env data provider (in this fixture)
+environment_data_provider=sample

data/spec/fixtures/unit/data_providers/environments/sample/manifests/site.pp

@@ -0,0 +1,6 @@
+class test($param_a = 1, $param_b = 2, $param_c = 3) {
+  notify { "$param_a, $param_b, $param_c": }
+}
+
+include test
+include dataprovider::test

data/spec/fixtures/unit/data_providers/environments/sample/modules/dataprovider/lib/puppet/bindings/dataprovider/default.rb

@@ -0,0 +1,54 @@
+# This registers the default bindings for this module.
+# These bidnings are loaded at the start of a Puppet
+# catalog production.
+# 
+# The registrations makes 'sample' available as both a
+# data provider for an environment, and individually
+# selectable in modules.
+#
+# Note that there are two different implementation classes
+# registered, one for environment, and one for modules.
+#
+# Also note that all data are strings including the names
+# of the classes that implement the provider logic. This
+# is to not cause loading of those classes until they
+# are needed.
+#
+Puppet::Bindings.newbindings('dataprovider::default') do
+
+  # Make the SampleEnvData provider available for use in environments
+  # as 'sample'.
+  #
+  bind {
+    name 'sample'
+    in_multibind 'puppet::environment_data_providers'
+    to_instance 'PuppetX::Helindbe::SampleEnvData'
+  }
+
+  # Make the SampleModuleData provider available for use in environments
+  # as 'sample'.
+  #
+  bind {
+    name 'sample'
+    in_multibind 'puppet::module_data_providers'
+    to_instance 'PuppetX::Helindbe::SampleModuleData'
+  }
+
+  # This is what users of the 'sample' module data provider should
+  # use in its default.rb bindings. The module providing the implementation
+  # of this data provider typically does not have any puppet logic, so it
+  # would not have this binding. This example module has this however since
+  # it would otherwise require an additional module with just some puppet code
+  # and this binding to demonstrate the functionality.
+  #
+  # This binding declares that this module wants to use the 'sample' data provider
+  # for this module. (Thus ending up using the SampleModuleData implementation
+  # bound above in this example).
+  # 
+  bind {
+    name 'dataprovider'
+    to 'sample'
+    in_multibind 'puppet::module_data'
+  }
+end
+

data/spec/fixtures/unit/data_providers/environments/sample/modules/dataprovider/lib/puppet_x/helindbe/sample_env_data.rb

@@ -0,0 +1,31 @@
+# The module is named after the author, to ensure that names under PuppetX namespace
+# does not clash.
+#
+require 'puppet_x'
+module PuppetX::Helindbe
+
+  # An env data provider that is hardcoded and provides data for
+  # the two names 'test::param_a' and 'test::param_b'.
+  #
+  # A real implementation would read the data from somewhere or invoke some
+  # other service to obtain the data. When doing so caching may be performance
+  # critical, and it is important that a cache is associated with the apropriate
+  # object to not cause memory leaks. See more details in the documentation
+  # for how to write a data provider and use adapters.
+  #
+  class SampleEnvData < Puppet::Plugins::DataProviders::EnvironmentDataProvider
+    def initialize()
+      @data = { 
+        'test::param_a' => 'env data param_a is 10',
+        'test::param_b' => 'env data param_b is 20',
+        # demo: this overrides a parameter for a class in the dataprovider module
+        'dataprovider::test::param_c' => 'env data param_c is 300',
+      }
+    end
+
+    def lookup(name, scope, merge)
+      @data[name]
+    end
+  end
+end
+

data/spec/fixtures/unit/data_providers/environments/sample/modules/dataprovider/lib/puppet_x/helindbe/sample_module_data.rb

@@ -0,0 +1,32 @@
+# The module is named after the author, to ensure that names under PuppetX namespace
+# does not clash.
+#
+require 'puppet_x'
+module PuppetX::Helindbe
+
+  # A module data provider that is hardcoded and provides data for
+  # the three names 'test::param_a', 'test::param_b', and 'test::param_c'
+  #
+  # A real implementation would read the data from somewhere or invoke some
+  # other service to obtain the data. When doing so caching may be performance
+  # critical, and it is important that a cache is associated with the apropriate
+  # object to not cause memory leaks. See more details in the documentation
+  # for how to write a data provider and use adapters.
+  #
+  class SampleModuleData < Puppet::Plugins::DataProviders::ModuleDataProvider
+    def initialize()
+      @data = { 
+        'dataprovider::test::param_a' => 'module data param_a is 100',
+        'dataprovider::test::param_b' => 'module data param_b is 200',
+
+        # demo: uncomment the entry below to make it override the environment provided data
+        #'dataprovider::test::param_c' => 'env data param_c is 300',
+      }
+    end
+
+    def lookup(name, scope, merge)
+      @data[name]
+    end
+  end
+end
+

data/spec/fixtures/unit/data_providers/environments/sample/modules/dataprovider/manifests/init.pp

@@ -0,0 +1,5 @@
+class dataprovider {
+  class test($param_a = 1, $param_b = 2, $param_c = 3) {
+    notify { "$param_a, $param_b, $param_c": }
+  }
+}

data/spec/fixtures/unit/functions/lookup/environments/production/environment.conf

@@ -0,0 +1,2 @@
+environment_timeout = 0
+environment_data_provider = 'function'

data/spec/fixtures/unit/functions/lookup/environments/production/lib/puppet/functions/environment/data.rb

@@ -0,0 +1,13 @@
+Puppet::Functions.create_function(:'environment::data') do
+  def data()
+    { 'abc::a' => 'env_a',
+      'abc::c' => 'env_c',
+      'abc::d' => { 'k1' => 'env_d1', 'k2' => 'env_d2', 'k3' => 'env_d3' },
+      'abc::e' => { 'k1' => 'env_e1', 'k3' => 'env_e3' },
+      'bca::e' => { 'k1' => 'env_bca_e1', 'k3' => 'env_bca_e3' },
+      'no_provider::e' => { 'k1' => 'env_no_provider_e1', 'k3' => 'env_no_provider_e3' },
+      'abc::f' => { 'k1' => { 's1' => 'env_f11', 's2' => 'env_f12' },  'k2' => { 's1' => 'env_f21', 's3' => 'env_f23' }},
+      'abc::n' => nil
+    }
+  end
+end

data/spec/fixtures/unit/functions/lookup/environments/production/modules/abc/lib/puppet/bindings/abc/default.rb

@@ -0,0 +1,9 @@
+Puppet::Bindings.newbindings('abc::default') do
+  # In the default bindings for this module
+  bind {
+    # bind its name to the 'puppet' module data provider
+    name         'abc'
+    to           'function'
+    in_multibind 'puppet::module_data'
+ }
+end

data/spec/fixtures/unit/functions/lookup/environments/production/modules/abc/lib/puppet/functions/abc/data.rb

@@ -0,0 +1,9 @@
+Puppet::Functions.create_function(:'abc::data') do
+  def data()
+    { 'abc::b' => 'module_b',
+      'abc::c' => 'module_c',
+      'abc::e' => { 'k1' => 'module_e1', 'k2' => 'module_e2' },
+      'abc::f' => { 'k1' => { 's1' => 'module_f11', 's3' => 'module_f13' },  'k2' => { 's1' => 'module_f21', 's2' => 'module_f22' }},
+    }
+  end
+end

data/spec/fixtures/unit/functions/lookup/environments/production/modules/abc/manifests/init.pp

@@ -0,0 +1,8 @@
+class abc {
+  if $block != 'no_block_present' {
+    $result = lookup(*$args) |$names| { if $block == true { $names } else { $block } }
+  }
+  else {
+    $result = lookup(*$args)
+  }
+}

data/spec/fixtures/unit/functions/lookup/environments/production/modules/bad_data/lib/puppet/bindings/bad_data/default.rb

@@ -0,0 +1,9 @@
+Puppet::Bindings.newbindings('bad_data::default') do
+  # In the default bindings for this module
+  bind {
+    # bind its name to the 'puppet' module data provider
+    name         'bad_data'
+    to           'function'
+    in_multibind 'puppet::module_data'
+ }
+end

data/spec/fixtures/unit/functions/lookup/environments/production/modules/bad_data/lib/puppet/functions/bad_data/data.rb

@@ -0,0 +1,6 @@
+Puppet::Functions.create_function(:'bad_data::data') do
+  def data()
+    { 'b' => 'module_b', # Intentionally bad key (no module prefix)
+    }
+  end
+end

data/spec/fixtures/unit/functions/lookup/environments/production/modules/bad_data/manifests/init.pp

@@ -0,0 +1,3 @@
+class bad_data {
+  $result = lookup(bad_data::b)
+}

data/spec/fixtures/unit/functions/lookup/environments/production/modules/bca/lib/puppet/bindings/bca/default.rb

@@ -0,0 +1,9 @@
+Puppet::Bindings.newbindings('bca::default') do
+  # In the default bindings for this module
+  bind {
+    # bind its name to the 'puppet' module data provider
+    name         'bca'
+    to           'function'
+    in_multibind 'puppet::module_data'
+ }
+end

data/spec/fixtures/unit/functions/lookup/environments/production/modules/bca/lib/puppet/functions/bca/data.rb

@@ -0,0 +1,9 @@
+Puppet::Functions.create_function(:'bca::data') do
+  def data()
+    { 'bca::b' => 'module_bca_b',
+      'bca::c' => 'module_bca_c',
+      'bca::e' => { 'k1' => 'module_bca_e1', 'k2' => 'module_bca_e2' },
+      'bca::f' => { 'k1' => { 's1' => 'module_bca_f11', 's3' => 'module_bca_f13' },  'k2' => { 's1' => 'module_bca_f21', 's2' => 'module_bca_f22' }},
+    }
+  end
+end