openvox 7.37.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1120) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +15 -0
  3. data/CODEOWNERS +11 -0
  4. data/CODE_OF_CONDUCT.md +70 -0
  5. data/CONTRIBUTING.md +161 -0
  6. data/Gemfile +82 -0
  7. data/Guardfile.example +76 -0
  8. data/LICENSE +202 -0
  9. data/README.md +68 -0
  10. data/Rakefile +160 -0
  11. data/bin/puppet +9 -0
  12. data/conf/environment.conf +18 -0
  13. data/conf/fileserver.conf +32 -0
  14. data/conf/hiera.yaml +11 -0
  15. data/conf/puppet.conf +6 -0
  16. data/examples/enc/regexp_nodes/classes/databases +2 -0
  17. data/examples/enc/regexp_nodes/classes/webservers +2 -0
  18. data/examples/enc/regexp_nodes/environment/development +2 -0
  19. data/examples/enc/regexp_nodes/parameters/service/prod +1 -0
  20. data/examples/enc/regexp_nodes/parameters/service/qa +3 -0
  21. data/examples/enc/regexp_nodes/parameters/service/sandbox +1 -0
  22. data/examples/enc/regexp_nodes/regexp_nodes.rb +270 -0
  23. data/examples/hiera/README.md +91 -0
  24. data/examples/hiera/etc/hiera.yaml +15 -0
  25. data/examples/hiera/etc/hieradb/common.yaml +3 -0
  26. data/examples/hiera/etc/hieradb/dc1.yaml +6 -0
  27. data/examples/hiera/etc/hieradb/development.yaml +2 -0
  28. data/examples/hiera/etc/puppet.conf +3 -0
  29. data/examples/hiera/modules/data/manifests/common.pp +4 -0
  30. data/examples/hiera/modules/ntp/manifests/config.pp +6 -0
  31. data/examples/hiera/modules/ntp/manifests/data.pp +4 -0
  32. data/examples/hiera/modules/ntp/templates/ntp.conf.erb +3 -0
  33. data/examples/hiera/modules/users/manifests/common.pp +4 -0
  34. data/examples/hiera/modules/users/manifests/dc1.pp +4 -0
  35. data/examples/hiera/modules/users/manifests/development.pp +4 -0
  36. data/examples/hiera/site.pp +3 -0
  37. data/examples/nagios/check_puppet.rb +123 -0
  38. data/ext/README.md +13 -0
  39. data/ext/build_defaults.yaml +18 -0
  40. data/ext/debian/puppet.default +4 -0
  41. data/ext/debian/puppet.init +113 -0
  42. data/ext/hiera/hiera.yaml +15 -0
  43. data/ext/osx/puppet.plist +32 -0
  44. data/ext/project_data.yaml +20 -0
  45. data/ext/redhat/client.init +169 -0
  46. data/ext/redhat/client.sysconfig +2 -0
  47. data/ext/solaris/smf/puppet +44 -0
  48. data/ext/solaris/smf/puppet.xml +46 -0
  49. data/ext/suse/client.init +141 -0
  50. data/ext/systemd/puppet.service +26 -0
  51. data/ext/windows/puppet_interactive.bat +6 -0
  52. data/ext/windows/puppet_shell.bat +9 -0
  53. data/ext/windows/run_puppet_interactive.bat +9 -0
  54. data/ext/windows/service/daemon.bat +6 -0
  55. data/ext/windows/service/daemon.rb +225 -0
  56. data/install.rb +499 -0
  57. data/lib/hiera/puppet_function.rb +84 -0
  58. data/lib/hiera/scope.rb +90 -0
  59. data/lib/hiera_puppet.rb +80 -0
  60. data/lib/puppet/agent/disabler.rb +53 -0
  61. data/lib/puppet/agent/locker.rb +46 -0
  62. data/lib/puppet/agent.rb +176 -0
  63. data/lib/puppet/application/agent.rb +523 -0
  64. data/lib/puppet/application/apply.rb +428 -0
  65. data/lib/puppet/application/catalog.rb +4 -0
  66. data/lib/puppet/application/config.rb +5 -0
  67. data/lib/puppet/application/describe.rb +253 -0
  68. data/lib/puppet/application/device.rb +439 -0
  69. data/lib/puppet/application/doc.rb +233 -0
  70. data/lib/puppet/application/epp.rb +5 -0
  71. data/lib/puppet/application/face_base.rb +276 -0
  72. data/lib/puppet/application/facts.rb +9 -0
  73. data/lib/puppet/application/filebucket.rb +318 -0
  74. data/lib/puppet/application/generate.rb +5 -0
  75. data/lib/puppet/application/help.rb +5 -0
  76. data/lib/puppet/application/indirection_base.rb +4 -0
  77. data/lib/puppet/application/lookup.rb +433 -0
  78. data/lib/puppet/application/module.rb +4 -0
  79. data/lib/puppet/application/node.rb +4 -0
  80. data/lib/puppet/application/parser.rb +5 -0
  81. data/lib/puppet/application/plugin.rb +4 -0
  82. data/lib/puppet/application/report.rb +4 -0
  83. data/lib/puppet/application/resource.rb +254 -0
  84. data/lib/puppet/application/script.rb +264 -0
  85. data/lib/puppet/application/ssl.rb +323 -0
  86. data/lib/puppet/application.rb +596 -0
  87. data/lib/puppet/application_support.rb +68 -0
  88. data/lib/puppet/coercion.rb +40 -0
  89. data/lib/puppet/compilable_resource_type.rb +15 -0
  90. data/lib/puppet/concurrent/lock.rb +16 -0
  91. data/lib/puppet/concurrent/synchronized.rb +15 -0
  92. data/lib/puppet/concurrent/thread_local_singleton.rb +17 -0
  93. data/lib/puppet/concurrent.rb +2 -0
  94. data/lib/puppet/configurer/downloader.rb +85 -0
  95. data/lib/puppet/configurer/fact_handler.rb +50 -0
  96. data/lib/puppet/configurer/plugin_handler.rb +59 -0
  97. data/lib/puppet/configurer.rb +755 -0
  98. data/lib/puppet/confine/any.rb +26 -0
  99. data/lib/puppet/confine/boolean.rb +45 -0
  100. data/lib/puppet/confine/exists.rb +19 -0
  101. data/lib/puppet/confine/false.rb +25 -0
  102. data/lib/puppet/confine/feature.rb +17 -0
  103. data/lib/puppet/confine/true.rb +26 -0
  104. data/lib/puppet/confine/variable.rb +59 -0
  105. data/lib/puppet/confine.rb +83 -0
  106. data/lib/puppet/confine_collection.rb +51 -0
  107. data/lib/puppet/confiner.rb +46 -0
  108. data/lib/puppet/context/trusted_information.rb +120 -0
  109. data/lib/puppet/context.rb +188 -0
  110. data/lib/puppet/daemon.rb +182 -0
  111. data/lib/puppet/data_binding.rb +14 -0
  112. data/lib/puppet/datatypes/error.rb +21 -0
  113. data/lib/puppet/datatypes/impl/error.rb +40 -0
  114. data/lib/puppet/datatypes.rb +213 -0
  115. data/lib/puppet/defaults.rb +2277 -0
  116. data/lib/puppet/environments.rb +601 -0
  117. data/lib/puppet/error.rb +138 -0
  118. data/lib/puppet/etc.rb +180 -0
  119. data/lib/puppet/external/dot.rb +325 -0
  120. data/lib/puppet/external/pson/common.rb +374 -0
  121. data/lib/puppet/external/pson/pure/generator.rb +395 -0
  122. data/lib/puppet/external/pson/pure/parser.rb +308 -0
  123. data/lib/puppet/external/pson/pure.rb +15 -0
  124. data/lib/puppet/external/pson/version.rb +8 -0
  125. data/lib/puppet/face/catalog/select.rb +49 -0
  126. data/lib/puppet/face/catalog.rb +165 -0
  127. data/lib/puppet/face/config.rb +267 -0
  128. data/lib/puppet/face/epp.rb +566 -0
  129. data/lib/puppet/face/facts.rb +174 -0
  130. data/lib/puppet/face/generate.rb +66 -0
  131. data/lib/puppet/face/help/action.erb +90 -0
  132. data/lib/puppet/face/help/face.erb +115 -0
  133. data/lib/puppet/face/help/global.erb +16 -0
  134. data/lib/puppet/face/help/man.erb +152 -0
  135. data/lib/puppet/face/help.rb +242 -0
  136. data/lib/puppet/face/module/changes.rb +43 -0
  137. data/lib/puppet/face/module/install.rb +146 -0
  138. data/lib/puppet/face/module/list.rb +272 -0
  139. data/lib/puppet/face/module/uninstall.rb +89 -0
  140. data/lib/puppet/face/module/upgrade.rb +87 -0
  141. data/lib/puppet/face/module.rb +19 -0
  142. data/lib/puppet/face/node/clean.rb +107 -0
  143. data/lib/puppet/face/node.rb +43 -0
  144. data/lib/puppet/face/parser.rb +227 -0
  145. data/lib/puppet/face/plugin.rb +60 -0
  146. data/lib/puppet/face/report.rb +54 -0
  147. data/lib/puppet/face/resource.rb +53 -0
  148. data/lib/puppet/face.rb +12 -0
  149. data/lib/puppet/facter_impl.rb +96 -0
  150. data/lib/puppet/feature/base.rb +76 -0
  151. data/lib/puppet/feature/bolt.rb +3 -0
  152. data/lib/puppet/feature/cfpropertylist.rb +3 -0
  153. data/lib/puppet/feature/eventlog.rb +5 -0
  154. data/lib/puppet/feature/hiera_eyaml.rb +3 -0
  155. data/lib/puppet/feature/hocon.rb +3 -0
  156. data/lib/puppet/feature/libuser.rb +8 -0
  157. data/lib/puppet/feature/msgpack.rb +3 -0
  158. data/lib/puppet/feature/pe_license.rb +4 -0
  159. data/lib/puppet/feature/selinux.rb +3 -0
  160. data/lib/puppet/feature/ssh.rb +3 -0
  161. data/lib/puppet/feature/telnet.rb +9 -0
  162. data/lib/puppet/feature/zlib.rb +5 -0
  163. data/lib/puppet/ffi/posix/constants.rb +14 -0
  164. data/lib/puppet/ffi/posix/functions.rb +24 -0
  165. data/lib/puppet/ffi/posix.rb +10 -0
  166. data/lib/puppet/ffi/windows/api_types.rb +311 -0
  167. data/lib/puppet/ffi/windows/constants.rb +404 -0
  168. data/lib/puppet/ffi/windows/functions.rb +628 -0
  169. data/lib/puppet/ffi/windows/structs.rb +338 -0
  170. data/lib/puppet/ffi/windows.rb +12 -0
  171. data/lib/puppet/file_bucket/dipper.rb +174 -0
  172. data/lib/puppet/file_bucket/file.rb +129 -0
  173. data/lib/puppet/file_bucket.rb +4 -0
  174. data/lib/puppet/file_serving/base.rb +86 -0
  175. data/lib/puppet/file_serving/configuration/parser.rb +113 -0
  176. data/lib/puppet/file_serving/configuration.rb +113 -0
  177. data/lib/puppet/file_serving/content.rb +43 -0
  178. data/lib/puppet/file_serving/fileset.rb +186 -0
  179. data/lib/puppet/file_serving/http_metadata.rb +62 -0
  180. data/lib/puppet/file_serving/metadata.rb +171 -0
  181. data/lib/puppet/file_serving/mount/file.rb +122 -0
  182. data/lib/puppet/file_serving/mount/locales.rb +35 -0
  183. data/lib/puppet/file_serving/mount/modules.rb +26 -0
  184. data/lib/puppet/file_serving/mount/pluginfacts.rb +35 -0
  185. data/lib/puppet/file_serving/mount/plugins.rb +35 -0
  186. data/lib/puppet/file_serving/mount/scripts.rb +24 -0
  187. data/lib/puppet/file_serving/mount/tasks.rb +23 -0
  188. data/lib/puppet/file_serving/mount.rb +38 -0
  189. data/lib/puppet/file_serving/terminus_helper.rb +31 -0
  190. data/lib/puppet/file_serving/terminus_selector.rb +31 -0
  191. data/lib/puppet/file_serving.rb +3 -0
  192. data/lib/puppet/file_system/file_impl.rb +188 -0
  193. data/lib/puppet/file_system/jruby.rb +23 -0
  194. data/lib/puppet/file_system/memory_file.rb +79 -0
  195. data/lib/puppet/file_system/memory_impl.rb +99 -0
  196. data/lib/puppet/file_system/path_pattern.rb +93 -0
  197. data/lib/puppet/file_system/posix.rb +47 -0
  198. data/lib/puppet/file_system/uniquefile.rb +188 -0
  199. data/lib/puppet/file_system/windows.rb +213 -0
  200. data/lib/puppet/file_system.rb +419 -0
  201. data/lib/puppet/forge/cache.rb +60 -0
  202. data/lib/puppet/forge/errors.rb +114 -0
  203. data/lib/puppet/forge/repository.rb +95 -0
  204. data/lib/puppet/forge.rb +259 -0
  205. data/lib/puppet/functions/abs.rb +61 -0
  206. data/lib/puppet/functions/alert.rb +14 -0
  207. data/lib/puppet/functions/all.rb +104 -0
  208. data/lib/puppet/functions/annotate.rb +108 -0
  209. data/lib/puppet/functions/any.rb +109 -0
  210. data/lib/puppet/functions/assert_type.rb +93 -0
  211. data/lib/puppet/functions/binary_file.rb +32 -0
  212. data/lib/puppet/functions/break.rb +47 -0
  213. data/lib/puppet/functions/call.rb +80 -0
  214. data/lib/puppet/functions/camelcase.rb +62 -0
  215. data/lib/puppet/functions/capitalize.rb +61 -0
  216. data/lib/puppet/functions/ceiling.rb +37 -0
  217. data/lib/puppet/functions/chomp.rb +57 -0
  218. data/lib/puppet/functions/chop.rb +67 -0
  219. data/lib/puppet/functions/compare.rb +125 -0
  220. data/lib/puppet/functions/contain.rb +55 -0
  221. data/lib/puppet/functions/convert_to.rb +34 -0
  222. data/lib/puppet/functions/crit.rb +14 -0
  223. data/lib/puppet/functions/debug.rb +14 -0
  224. data/lib/puppet/functions/defined.rb +159 -0
  225. data/lib/puppet/functions/dig.rb +67 -0
  226. data/lib/puppet/functions/downcase.rb +89 -0
  227. data/lib/puppet/functions/each.rb +167 -0
  228. data/lib/puppet/functions/emerg.rb +14 -0
  229. data/lib/puppet/functions/empty.rb +85 -0
  230. data/lib/puppet/functions/epp.rb +49 -0
  231. data/lib/puppet/functions/err.rb +14 -0
  232. data/lib/puppet/functions/eyaml_lookup_key.rb +102 -0
  233. data/lib/puppet/functions/filter.rb +137 -0
  234. data/lib/puppet/functions/find_file.rb +44 -0
  235. data/lib/puppet/functions/find_template.rb +63 -0
  236. data/lib/puppet/functions/flatten.rb +64 -0
  237. data/lib/puppet/functions/floor.rb +37 -0
  238. data/lib/puppet/functions/get.rb +150 -0
  239. data/lib/puppet/functions/getvar.rb +87 -0
  240. data/lib/puppet/functions/group_by.rb +62 -0
  241. data/lib/puppet/functions/hiera.rb +89 -0
  242. data/lib/puppet/functions/hiera_array.rb +81 -0
  243. data/lib/puppet/functions/hiera_hash.rb +92 -0
  244. data/lib/puppet/functions/hiera_include.rb +104 -0
  245. data/lib/puppet/functions/hocon_data.rb +41 -0
  246. data/lib/puppet/functions/import.rb +7 -0
  247. data/lib/puppet/functions/include.rb +53 -0
  248. data/lib/puppet/functions/index.rb +167 -0
  249. data/lib/puppet/functions/info.rb +14 -0
  250. data/lib/puppet/functions/inline_epp.rb +60 -0
  251. data/lib/puppet/functions/join.rb +56 -0
  252. data/lib/puppet/functions/json_data.rb +33 -0
  253. data/lib/puppet/functions/keys.rb +25 -0
  254. data/lib/puppet/functions/length.rb +44 -0
  255. data/lib/puppet/functions/lest.rb +55 -0
  256. data/lib/puppet/functions/lookup.rb +224 -0
  257. data/lib/puppet/functions/lstrip.rb +58 -0
  258. data/lib/puppet/functions/map.rb +135 -0
  259. data/lib/puppet/functions/match.rb +130 -0
  260. data/lib/puppet/functions/max.rb +183 -0
  261. data/lib/puppet/functions/min.rb +182 -0
  262. data/lib/puppet/functions/module_directory.rb +41 -0
  263. data/lib/puppet/functions/new.rb +1011 -0
  264. data/lib/puppet/functions/next.rb +33 -0
  265. data/lib/puppet/functions/notice.rb +14 -0
  266. data/lib/puppet/functions/partition.rb +62 -0
  267. data/lib/puppet/functions/reduce.rb +162 -0
  268. data/lib/puppet/functions/regsubst.rb +101 -0
  269. data/lib/puppet/functions/require.rb +77 -0
  270. data/lib/puppet/functions/return.rb +15 -0
  271. data/lib/puppet/functions/reverse_each.rb +94 -0
  272. data/lib/puppet/functions/round.rb +24 -0
  273. data/lib/puppet/functions/rstrip.rb +58 -0
  274. data/lib/puppet/functions/scanf.rb +44 -0
  275. data/lib/puppet/functions/size.rb +15 -0
  276. data/lib/puppet/functions/slice.rb +124 -0
  277. data/lib/puppet/functions/sort.rb +74 -0
  278. data/lib/puppet/functions/split.rb +76 -0
  279. data/lib/puppet/functions/step.rb +98 -0
  280. data/lib/puppet/functions/strftime.rb +212 -0
  281. data/lib/puppet/functions/strip.rb +58 -0
  282. data/lib/puppet/functions/then.rb +77 -0
  283. data/lib/puppet/functions/tree_each.rb +197 -0
  284. data/lib/puppet/functions/type.rb +72 -0
  285. data/lib/puppet/functions/unique.rb +132 -0
  286. data/lib/puppet/functions/unwrap.rb +59 -0
  287. data/lib/puppet/functions/upcase.rb +89 -0
  288. data/lib/puppet/functions/values.rb +25 -0
  289. data/lib/puppet/functions/versioncmp.rb +40 -0
  290. data/lib/puppet/functions/warning.rb +14 -0
  291. data/lib/puppet/functions/with.rb +32 -0
  292. data/lib/puppet/functions/yaml_data.rb +45 -0
  293. data/lib/puppet/functions.rb +862 -0
  294. data/lib/puppet/generate/models/type/property.rb +70 -0
  295. data/lib/puppet/generate/models/type/type.rb +65 -0
  296. data/lib/puppet/generate/templates/type/pcore.erb +42 -0
  297. data/lib/puppet/generate/type.rb +249 -0
  298. data/lib/puppet/gettext/config.rb +275 -0
  299. data/lib/puppet/gettext/module_translations.rb +42 -0
  300. data/lib/puppet/gettext/stubs.rb +11 -0
  301. data/lib/puppet/graph/key.rb +26 -0
  302. data/lib/puppet/graph/prioritizer.rb +29 -0
  303. data/lib/puppet/graph/rb_tree_map.rb +388 -0
  304. data/lib/puppet/graph/relationship_graph.rb +284 -0
  305. data/lib/puppet/graph/sequential_prioritizer.rb +31 -0
  306. data/lib/puppet/graph/simple_graph.rb +546 -0
  307. data/lib/puppet/graph.rb +9 -0
  308. data/lib/puppet/http/client.rb +525 -0
  309. data/lib/puppet/http/dns.rb +159 -0
  310. data/lib/puppet/http/errors.rb +48 -0
  311. data/lib/puppet/http/external_client.rb +88 -0
  312. data/lib/puppet/http/factory.rb +51 -0
  313. data/lib/puppet/http/pool.rb +172 -0
  314. data/lib/puppet/http/pool_entry.rb +17 -0
  315. data/lib/puppet/http/proxy.rb +137 -0
  316. data/lib/puppet/http/redirector.rb +85 -0
  317. data/lib/puppet/http/resolver/server_list.rb +87 -0
  318. data/lib/puppet/http/resolver/settings.rb +23 -0
  319. data/lib/puppet/http/resolver/srv.rb +41 -0
  320. data/lib/puppet/http/resolver.rb +48 -0
  321. data/lib/puppet/http/response.rb +102 -0
  322. data/lib/puppet/http/response_converter.rb +24 -0
  323. data/lib/puppet/http/response_net_http.rb +42 -0
  324. data/lib/puppet/http/retry_after_handler.rb +77 -0
  325. data/lib/puppet/http/service/ca.rb +101 -0
  326. data/lib/puppet/http/service/compiler.rb +353 -0
  327. data/lib/puppet/http/service/file_server.rb +198 -0
  328. data/lib/puppet/http/service/puppetserver.rb +53 -0
  329. data/lib/puppet/http/service/report.rb +64 -0
  330. data/lib/puppet/http/service.rb +182 -0
  331. data/lib/puppet/http/session.rb +122 -0
  332. data/lib/puppet/http/site.rb +42 -0
  333. data/lib/puppet/http.rb +46 -0
  334. data/lib/puppet/indirector/catalog/compiler.rb +431 -0
  335. data/lib/puppet/indirector/catalog/json.rb +40 -0
  336. data/lib/puppet/indirector/catalog/msgpack.rb +6 -0
  337. data/lib/puppet/indirector/catalog/rest.rb +49 -0
  338. data/lib/puppet/indirector/catalog/store_configs.rb +8 -0
  339. data/lib/puppet/indirector/catalog/yaml.rb +6 -0
  340. data/lib/puppet/indirector/code.rb +6 -0
  341. data/lib/puppet/indirector/data_binding/hiera.rb +7 -0
  342. data/lib/puppet/indirector/data_binding/none.rb +8 -0
  343. data/lib/puppet/indirector/direct_file_server.rb +17 -0
  344. data/lib/puppet/indirector/envelope.rb +11 -0
  345. data/lib/puppet/indirector/errors.rb +5 -0
  346. data/lib/puppet/indirector/exec.rb +38 -0
  347. data/lib/puppet/indirector/face.rb +153 -0
  348. data/lib/puppet/indirector/fact_search.rb +60 -0
  349. data/lib/puppet/indirector/facts/facter.rb +117 -0
  350. data/lib/puppet/indirector/facts/json.rb +27 -0
  351. data/lib/puppet/indirector/facts/memory.rb +9 -0
  352. data/lib/puppet/indirector/facts/network_device.rb +27 -0
  353. data/lib/puppet/indirector/facts/rest.rb +44 -0
  354. data/lib/puppet/indirector/facts/store_configs.rb +11 -0
  355. data/lib/puppet/indirector/facts/yaml.rb +29 -0
  356. data/lib/puppet/indirector/file_bucket_file/file.rb +262 -0
  357. data/lib/puppet/indirector/file_bucket_file/rest.rb +50 -0
  358. data/lib/puppet/indirector/file_bucket_file/selector.rb +53 -0
  359. data/lib/puppet/indirector/file_content/file.rb +7 -0
  360. data/lib/puppet/indirector/file_content/file_server.rb +7 -0
  361. data/lib/puppet/indirector/file_content/rest.rb +35 -0
  362. data/lib/puppet/indirector/file_content/selector.rb +30 -0
  363. data/lib/puppet/indirector/file_content.rb +5 -0
  364. data/lib/puppet/indirector/file_metadata/file.rb +7 -0
  365. data/lib/puppet/indirector/file_metadata/file_server.rb +7 -0
  366. data/lib/puppet/indirector/file_metadata/http.rb +47 -0
  367. data/lib/puppet/indirector/file_metadata/rest.rb +56 -0
  368. data/lib/puppet/indirector/file_metadata/selector.rb +30 -0
  369. data/lib/puppet/indirector/file_metadata.rb +5 -0
  370. data/lib/puppet/indirector/file_server.rb +54 -0
  371. data/lib/puppet/indirector/generic_http.rb +5 -0
  372. data/lib/puppet/indirector/hiera.rb +100 -0
  373. data/lib/puppet/indirector/indirection.rb +372 -0
  374. data/lib/puppet/indirector/json.rb +79 -0
  375. data/lib/puppet/indirector/memory.rb +34 -0
  376. data/lib/puppet/indirector/msgpack.rb +83 -0
  377. data/lib/puppet/indirector/node/exec.rb +70 -0
  378. data/lib/puppet/indirector/node/json.rb +8 -0
  379. data/lib/puppet/indirector/node/memory.rb +10 -0
  380. data/lib/puppet/indirector/node/msgpack.rb +7 -0
  381. data/lib/puppet/indirector/node/plain.rb +21 -0
  382. data/lib/puppet/indirector/node/rest.rb +29 -0
  383. data/lib/puppet/indirector/node/store_configs.rb +8 -0
  384. data/lib/puppet/indirector/node/yaml.rb +7 -0
  385. data/lib/puppet/indirector/none.rb +9 -0
  386. data/lib/puppet/indirector/plain.rb +9 -0
  387. data/lib/puppet/indirector/report/json.rb +34 -0
  388. data/lib/puppet/indirector/report/msgpack.rb +11 -0
  389. data/lib/puppet/indirector/report/processor.rb +60 -0
  390. data/lib/puppet/indirector/report/rest.rb +42 -0
  391. data/lib/puppet/indirector/report/yaml.rb +34 -0
  392. data/lib/puppet/indirector/request.rb +194 -0
  393. data/lib/puppet/indirector/resource/ral.rb +66 -0
  394. data/lib/puppet/indirector/resource/store_configs.rb +12 -0
  395. data/lib/puppet/indirector/resource/validator.rb +8 -0
  396. data/lib/puppet/indirector/rest.rb +64 -0
  397. data/lib/puppet/indirector/store_configs.rb +30 -0
  398. data/lib/puppet/indirector/terminus.rb +176 -0
  399. data/lib/puppet/indirector/yaml.rb +63 -0
  400. data/lib/puppet/indirector.rb +61 -0
  401. data/lib/puppet/info_service/class_information_service.rb +109 -0
  402. data/lib/puppet/info_service/plan_information_service.rb +36 -0
  403. data/lib/puppet/info_service/task_information_service.rb +44 -0
  404. data/lib/puppet/info_service.rb +26 -0
  405. data/lib/puppet/interface/action.rb +406 -0
  406. data/lib/puppet/interface/action_builder.rb +161 -0
  407. data/lib/puppet/interface/action_manager.rb +98 -0
  408. data/lib/puppet/interface/documentation.rb +357 -0
  409. data/lib/puppet/interface/face_collection.rb +137 -0
  410. data/lib/puppet/interface/option.rb +172 -0
  411. data/lib/puppet/interface/option_builder.rb +105 -0
  412. data/lib/puppet/interface/option_manager.rb +106 -0
  413. data/lib/puppet/interface.rb +239 -0
  414. data/lib/puppet/loaders.rb +30 -0
  415. data/lib/puppet/metatype/manager.rb +197 -0
  416. data/lib/puppet/module/plan.rb +159 -0
  417. data/lib/puppet/module/task.rb +283 -0
  418. data/lib/puppet/module.rb +475 -0
  419. data/lib/puppet/module_tool/applications/application.rb +91 -0
  420. data/lib/puppet/module_tool/applications/checksummer.rb +62 -0
  421. data/lib/puppet/module_tool/applications/installer.rb +411 -0
  422. data/lib/puppet/module_tool/applications/uninstaller.rb +119 -0
  423. data/lib/puppet/module_tool/applications/unpacker.rb +100 -0
  424. data/lib/puppet/module_tool/applications/upgrader.rb +282 -0
  425. data/lib/puppet/module_tool/applications.rb +12 -0
  426. data/lib/puppet/module_tool/checksums.rb +49 -0
  427. data/lib/puppet/module_tool/contents_description.rb +89 -0
  428. data/lib/puppet/module_tool/dependency.rb +41 -0
  429. data/lib/puppet/module_tool/errors/base.rb +15 -0
  430. data/lib/puppet/module_tool/errors/installer.rb +93 -0
  431. data/lib/puppet/module_tool/errors/shared.rb +227 -0
  432. data/lib/puppet/module_tool/errors/uninstaller.rb +50 -0
  433. data/lib/puppet/module_tool/errors/upgrader.rb +63 -0
  434. data/lib/puppet/module_tool/errors.rb +11 -0
  435. data/lib/puppet/module_tool/install_directory.rb +45 -0
  436. data/lib/puppet/module_tool/installed_modules.rb +96 -0
  437. data/lib/puppet/module_tool/local_tarball.rb +90 -0
  438. data/lib/puppet/module_tool/metadata.rb +221 -0
  439. data/lib/puppet/module_tool/shared_behaviors.rb +181 -0
  440. data/lib/puppet/module_tool/tar/gnu.rb +19 -0
  441. data/lib/puppet/module_tool/tar/mini.rb +116 -0
  442. data/lib/puppet/module_tool/tar.rb +18 -0
  443. data/lib/puppet/module_tool.rb +194 -0
  444. data/lib/puppet/network/authconfig.rb +7 -0
  445. data/lib/puppet/network/authorization.rb +19 -0
  446. data/lib/puppet/network/client_request.rb +29 -0
  447. data/lib/puppet/network/format.rb +110 -0
  448. data/lib/puppet/network/format_handler.rb +108 -0
  449. data/lib/puppet/network/format_support.rb +139 -0
  450. data/lib/puppet/network/formats.rb +329 -0
  451. data/lib/puppet/network/http/api/indirected_routes.rb +277 -0
  452. data/lib/puppet/network/http/api/indirection_type.rb +32 -0
  453. data/lib/puppet/network/http/api/master/v3/environments.rb +3 -0
  454. data/lib/puppet/network/http/api/master/v3.rb +3 -0
  455. data/lib/puppet/network/http/api/master.rb +3 -0
  456. data/lib/puppet/network/http/api/server/v3/environments.rb +48 -0
  457. data/lib/puppet/network/http/api/server/v3.rb +39 -0
  458. data/lib/puppet/network/http/api/server.rb +10 -0
  459. data/lib/puppet/network/http/api.rb +39 -0
  460. data/lib/puppet/network/http/connection.rb +286 -0
  461. data/lib/puppet/network/http/error.rb +73 -0
  462. data/lib/puppet/network/http/handler.rb +215 -0
  463. data/lib/puppet/network/http/issues.rb +12 -0
  464. data/lib/puppet/network/http/memory_response.rb +13 -0
  465. data/lib/puppet/network/http/request.rb +71 -0
  466. data/lib/puppet/network/http/response.rb +23 -0
  467. data/lib/puppet/network/http/route.rb +101 -0
  468. data/lib/puppet/network/http.rb +28 -0
  469. data/lib/puppet/network/http_pool.rb +77 -0
  470. data/lib/puppet/network/uri.rb +18 -0
  471. data/lib/puppet/network.rb +3 -0
  472. data/lib/puppet/node/environment.rb +635 -0
  473. data/lib/puppet/node/facts.rb +165 -0
  474. data/lib/puppet/node/server_facts.rb +46 -0
  475. data/lib/puppet/node.rb +256 -0
  476. data/lib/puppet/pal/catalog_compiler.rb +108 -0
  477. data/lib/puppet/pal/compiler.rb +222 -0
  478. data/lib/puppet/pal/function_signature.rb +52 -0
  479. data/lib/puppet/pal/json_catalog_encoder.rb +71 -0
  480. data/lib/puppet/pal/pal_api.rb +15 -0
  481. data/lib/puppet/pal/pal_impl.rb +590 -0
  482. data/lib/puppet/pal/plan_signature.rb +71 -0
  483. data/lib/puppet/pal/script_compiler.rb +73 -0
  484. data/lib/puppet/pal/task_signature.rb +58 -0
  485. data/lib/puppet/parameter/boolean.rb +15 -0
  486. data/lib/puppet/parameter/package_options.rb +31 -0
  487. data/lib/puppet/parameter/path.rb +57 -0
  488. data/lib/puppet/parameter/value.rb +91 -0
  489. data/lib/puppet/parameter/value_collection.rb +212 -0
  490. data/lib/puppet/parameter.rb +589 -0
  491. data/lib/puppet/parser/abstract_compiler.rb +36 -0
  492. data/lib/puppet/parser/ast/block_expression.rb +15 -0
  493. data/lib/puppet/parser/ast/branch.rb +19 -0
  494. data/lib/puppet/parser/ast/hostclass.rb +27 -0
  495. data/lib/puppet/parser/ast/leaf.rb +81 -0
  496. data/lib/puppet/parser/ast/node.rb +17 -0
  497. data/lib/puppet/parser/ast/pops_bridge.rb +245 -0
  498. data/lib/puppet/parser/ast/resource.rb +66 -0
  499. data/lib/puppet/parser/ast/resource_instance.rb +10 -0
  500. data/lib/puppet/parser/ast/resourceparam.rb +31 -0
  501. data/lib/puppet/parser/ast/top_level_construct.rb +4 -0
  502. data/lib/puppet/parser/ast.rb +61 -0
  503. data/lib/puppet/parser/catalog_compiler.rb +56 -0
  504. data/lib/puppet/parser/compiler/catalog_validator/relationship_validator.rb +39 -0
  505. data/lib/puppet/parser/compiler/catalog_validator.rb +33 -0
  506. data/lib/puppet/parser/compiler.rb +615 -0
  507. data/lib/puppet/parser/e4_parser_adapter.rb +60 -0
  508. data/lib/puppet/parser/files.rb +93 -0
  509. data/lib/puppet/parser/functions/assert_type.rb +60 -0
  510. data/lib/puppet/parser/functions/binary_file.rb +24 -0
  511. data/lib/puppet/parser/functions/break.rb +39 -0
  512. data/lib/puppet/parser/functions/contain.rb +30 -0
  513. data/lib/puppet/parser/functions/create_resources.rb +110 -0
  514. data/lib/puppet/parser/functions/defined.rb +107 -0
  515. data/lib/puppet/parser/functions/dig.rb +38 -0
  516. data/lib/puppet/parser/functions/digest.rb +5 -0
  517. data/lib/puppet/parser/functions/each.rb +104 -0
  518. data/lib/puppet/parser/functions/epp.rb +39 -0
  519. data/lib/puppet/parser/functions/fail.rb +11 -0
  520. data/lib/puppet/parser/functions/file.rb +33 -0
  521. data/lib/puppet/parser/functions/filter.rb +79 -0
  522. data/lib/puppet/parser/functions/find_file.rb +28 -0
  523. data/lib/puppet/parser/functions/fqdn_rand.rb +44 -0
  524. data/lib/puppet/parser/functions/generate.rb +37 -0
  525. data/lib/puppet/parser/functions/hiera.rb +103 -0
  526. data/lib/puppet/parser/functions/hiera_array.rb +92 -0
  527. data/lib/puppet/parser/functions/hiera_hash.rb +102 -0
  528. data/lib/puppet/parser/functions/hiera_include.rb +101 -0
  529. data/lib/puppet/parser/functions/include.rb +34 -0
  530. data/lib/puppet/parser/functions/inline_epp.rb +51 -0
  531. data/lib/puppet/parser/functions/inline_template.rb +26 -0
  532. data/lib/puppet/parser/functions/lest.rb +49 -0
  533. data/lib/puppet/parser/functions/lookup.rb +132 -0
  534. data/lib/puppet/parser/functions/map.rb +76 -0
  535. data/lib/puppet/parser/functions/match.rb +43 -0
  536. data/lib/puppet/parser/functions/md5.rb +5 -0
  537. data/lib/puppet/parser/functions/new.rb +991 -0
  538. data/lib/puppet/parser/functions/next.rb +38 -0
  539. data/lib/puppet/parser/functions/realize.rb +20 -0
  540. data/lib/puppet/parser/functions/reduce.rb +137 -0
  541. data/lib/puppet/parser/functions/regsubst.rb +62 -0
  542. data/lib/puppet/parser/functions/require.rb +40 -0
  543. data/lib/puppet/parser/functions/return.rb +92 -0
  544. data/lib/puppet/parser/functions/reverse_each.rb +83 -0
  545. data/lib/puppet/parser/functions/scanf.rb +38 -0
  546. data/lib/puppet/parser/functions/sha1.rb +5 -0
  547. data/lib/puppet/parser/functions/sha256.rb +5 -0
  548. data/lib/puppet/parser/functions/shellquote.rb +61 -0
  549. data/lib/puppet/parser/functions/slice.rb +39 -0
  550. data/lib/puppet/parser/functions/split.rb +28 -0
  551. data/lib/puppet/parser/functions/sprintf.rb +61 -0
  552. data/lib/puppet/parser/functions/step.rb +84 -0
  553. data/lib/puppet/parser/functions/strftime.rb +185 -0
  554. data/lib/puppet/parser/functions/tag.rb +12 -0
  555. data/lib/puppet/parser/functions/tagged.rb +21 -0
  556. data/lib/puppet/parser/functions/template.rb +39 -0
  557. data/lib/puppet/parser/functions/then.rb +73 -0
  558. data/lib/puppet/parser/functions/type.rb +53 -0
  559. data/lib/puppet/parser/functions/versioncmp.rb +30 -0
  560. data/lib/puppet/parser/functions/with.rb +28 -0
  561. data/lib/puppet/parser/functions.rb +321 -0
  562. data/lib/puppet/parser/parser_factory.rb +30 -0
  563. data/lib/puppet/parser/relationship.rb +84 -0
  564. data/lib/puppet/parser/resource/param.rb +35 -0
  565. data/lib/puppet/parser/resource.rb +351 -0
  566. data/lib/puppet/parser/scope.rb +1127 -0
  567. data/lib/puppet/parser/script_compiler.rb +123 -0
  568. data/lib/puppet/parser/templatewrapper.rb +104 -0
  569. data/lib/puppet/parser/type_loader.rb +150 -0
  570. data/lib/puppet/parser.rb +20 -0
  571. data/lib/puppet/plugins/configuration.rb +29 -0
  572. data/lib/puppet/plugins/syntax_checkers.rb +98 -0
  573. data/lib/puppet/plugins.rb +9 -0
  574. data/lib/puppet/pops/adaptable.rb +197 -0
  575. data/lib/puppet/pops/adapters.rb +156 -0
  576. data/lib/puppet/pops/evaluator/access_operator.rb +719 -0
  577. data/lib/puppet/pops/evaluator/callable_signature.rb +107 -0
  578. data/lib/puppet/pops/evaluator/closure.rb +375 -0
  579. data/lib/puppet/pops/evaluator/collector_transformer.rb +234 -0
  580. data/lib/puppet/pops/evaluator/collectors/abstract_collector.rb +86 -0
  581. data/lib/puppet/pops/evaluator/collectors/catalog_collector.rb +29 -0
  582. data/lib/puppet/pops/evaluator/collectors/exported_collector.rb +70 -0
  583. data/lib/puppet/pops/evaluator/collectors/fixed_set_collector.rb +38 -0
  584. data/lib/puppet/pops/evaluator/compare_operator.rb +254 -0
  585. data/lib/puppet/pops/evaluator/deferred_resolver.rb +225 -0
  586. data/lib/puppet/pops/evaluator/epp_evaluator.rb +120 -0
  587. data/lib/puppet/pops/evaluator/evaluator_impl.rb +1317 -0
  588. data/lib/puppet/pops/evaluator/external_syntax_support.rb +46 -0
  589. data/lib/puppet/pops/evaluator/json_strict_literal_evaluator.rb +82 -0
  590. data/lib/puppet/pops/evaluator/literal_evaluator.rb +100 -0
  591. data/lib/puppet/pops/evaluator/puppet_proc.rb +69 -0
  592. data/lib/puppet/pops/evaluator/relationship_operator.rb +185 -0
  593. data/lib/puppet/pops/evaluator/runtime3_converter.rb +221 -0
  594. data/lib/puppet/pops/evaluator/runtime3_resource_support.rb +119 -0
  595. data/lib/puppet/pops/evaluator/runtime3_support.rb +535 -0
  596. data/lib/puppet/pops/functions/dispatch.rb +107 -0
  597. data/lib/puppet/pops/functions/dispatcher.rb +75 -0
  598. data/lib/puppet/pops/functions/function.rb +139 -0
  599. data/lib/puppet/pops/issue_reporter.rb +137 -0
  600. data/lib/puppet/pops/issues.rb +928 -0
  601. data/lib/puppet/pops/label_provider.rb +90 -0
  602. data/lib/puppet/pops/loader/base_loader.rb +178 -0
  603. data/lib/puppet/pops/loader/dependency_loader.rb +91 -0
  604. data/lib/puppet/pops/loader/gem_support.rb +51 -0
  605. data/lib/puppet/pops/loader/generic_plan_instantiator.rb +28 -0
  606. data/lib/puppet/pops/loader/loader.rb +221 -0
  607. data/lib/puppet/pops/loader/loader_paths.rb +412 -0
  608. data/lib/puppet/pops/loader/module_loaders.rb +556 -0
  609. data/lib/puppet/pops/loader/predefined_loader.rb +28 -0
  610. data/lib/puppet/pops/loader/puppet_function_instantiator.rb +84 -0
  611. data/lib/puppet/pops/loader/puppet_plan_instantiator.rb +93 -0
  612. data/lib/puppet/pops/loader/puppet_resource_type_impl_instantiator.rb +79 -0
  613. data/lib/puppet/pops/loader/ruby_data_type_instantiator.rb +39 -0
  614. data/lib/puppet/pops/loader/ruby_function_instantiator.rb +45 -0
  615. data/lib/puppet/pops/loader/ruby_legacy_function_instantiator.rb +120 -0
  616. data/lib/puppet/pops/loader/runtime3_type_loader.rb +103 -0
  617. data/lib/puppet/pops/loader/simple_environment_loader.rb +20 -0
  618. data/lib/puppet/pops/loader/static_loader.rb +131 -0
  619. data/lib/puppet/pops/loader/task_instantiator.rb +44 -0
  620. data/lib/puppet/pops/loader/type_definition_instantiator.rb +100 -0
  621. data/lib/puppet/pops/loader/typed_name.rb +54 -0
  622. data/lib/puppet/pops/loader/uri_helper.rb +22 -0
  623. data/lib/puppet/pops/loaders.rb +546 -0
  624. data/lib/puppet/pops/lookup/configured_data_provider.rb +93 -0
  625. data/lib/puppet/pops/lookup/context.rb +199 -0
  626. data/lib/puppet/pops/lookup/data_adapter.rb +27 -0
  627. data/lib/puppet/pops/lookup/data_dig_function_provider.rb +145 -0
  628. data/lib/puppet/pops/lookup/data_hash_function_provider.rb +126 -0
  629. data/lib/puppet/pops/lookup/data_provider.rb +92 -0
  630. data/lib/puppet/pops/lookup/environment_data_provider.rb +35 -0
  631. data/lib/puppet/pops/lookup/explainer.rb +595 -0
  632. data/lib/puppet/pops/lookup/function_provider.rb +110 -0
  633. data/lib/puppet/pops/lookup/global_data_provider.rb +75 -0
  634. data/lib/puppet/pops/lookup/hiera_config.rb +775 -0
  635. data/lib/puppet/pops/lookup/interpolation.rb +155 -0
  636. data/lib/puppet/pops/lookup/invocation.rb +268 -0
  637. data/lib/puppet/pops/lookup/key_recorder.rb +18 -0
  638. data/lib/puppet/pops/lookup/location_resolver.rb +99 -0
  639. data/lib/puppet/pops/lookup/lookup_adapter.rb +528 -0
  640. data/lib/puppet/pops/lookup/lookup_key.rb +99 -0
  641. data/lib/puppet/pops/lookup/lookup_key_function_provider.rb +92 -0
  642. data/lib/puppet/pops/lookup/module_data_provider.rb +89 -0
  643. data/lib/puppet/pops/lookup/sub_lookup.rb +92 -0
  644. data/lib/puppet/pops/lookup.rb +97 -0
  645. data/lib/puppet/pops/merge_strategy.rb +441 -0
  646. data/lib/puppet/pops/migration/migration_checker.rb +58 -0
  647. data/lib/puppet/pops/model/ast.pp +669 -0
  648. data/lib/puppet/pops/model/ast.rb +4675 -0
  649. data/lib/puppet/pops/model/ast_transformer.rb +131 -0
  650. data/lib/puppet/pops/model/factory.rb +1155 -0
  651. data/lib/puppet/pops/model/model_label_provider.rb +134 -0
  652. data/lib/puppet/pops/model/model_tree_dumper.rb +445 -0
  653. data/lib/puppet/pops/model/pn_transformer.rb +385 -0
  654. data/lib/puppet/pops/model/tree_dumper.rb +59 -0
  655. data/lib/puppet/pops/parser/code_merger.rb +29 -0
  656. data/lib/puppet/pops/parser/egrammar.ra +889 -0
  657. data/lib/puppet/pops/parser/eparser.rb +3184 -0
  658. data/lib/puppet/pops/parser/epp_parser.rb +51 -0
  659. data/lib/puppet/pops/parser/epp_support.rb +265 -0
  660. data/lib/puppet/pops/parser/evaluating_parser.rb +162 -0
  661. data/lib/puppet/pops/parser/heredoc_support.rb +153 -0
  662. data/lib/puppet/pops/parser/interpolation_support.rb +249 -0
  663. data/lib/puppet/pops/parser/lexer2.rb +777 -0
  664. data/lib/puppet/pops/parser/lexer_support.rb +221 -0
  665. data/lib/puppet/pops/parser/locatable.rb +23 -0
  666. data/lib/puppet/pops/parser/locator.rb +357 -0
  667. data/lib/puppet/pops/parser/parser_support.rb +251 -0
  668. data/lib/puppet/pops/parser/pn_parser.rb +317 -0
  669. data/lib/puppet/pops/parser/slurp_support.rb +118 -0
  670. data/lib/puppet/pops/patterns.rb +60 -0
  671. data/lib/puppet/pops/pcore.rb +135 -0
  672. data/lib/puppet/pops/pn.rb +236 -0
  673. data/lib/puppet/pops/puppet_stack.rb +61 -0
  674. data/lib/puppet/pops/resource/param.rb +55 -0
  675. data/lib/puppet/pops/resource/resource_type_impl.rb +294 -0
  676. data/lib/puppet/pops/resource/resource_type_set.pcore +22 -0
  677. data/lib/puppet/pops/semantic_error.rb +29 -0
  678. data/lib/puppet/pops/serialization/abstract_reader.rb +180 -0
  679. data/lib/puppet/pops/serialization/abstract_writer.rb +222 -0
  680. data/lib/puppet/pops/serialization/deserializer.rb +80 -0
  681. data/lib/puppet/pops/serialization/extension.rb +158 -0
  682. data/lib/puppet/pops/serialization/from_data_converter.rb +224 -0
  683. data/lib/puppet/pops/serialization/instance_reader.rb +19 -0
  684. data/lib/puppet/pops/serialization/instance_writer.rb +14 -0
  685. data/lib/puppet/pops/serialization/json.rb +297 -0
  686. data/lib/puppet/pops/serialization/json_path.rb +127 -0
  687. data/lib/puppet/pops/serialization/object.rb +70 -0
  688. data/lib/puppet/pops/serialization/serializer.rb +140 -0
  689. data/lib/puppet/pops/serialization/time_factory.rb +67 -0
  690. data/lib/puppet/pops/serialization/to_data_converter.rb +313 -0
  691. data/lib/puppet/pops/serialization/to_stringified_converter.rb +226 -0
  692. data/lib/puppet/pops/serialization.rb +43 -0
  693. data/lib/puppet/pops/time/timespan.rb +716 -0
  694. data/lib/puppet/pops/time/timestamp.rb +160 -0
  695. data/lib/puppet/pops/types/annotatable.rb +36 -0
  696. data/lib/puppet/pops/types/annotation.rb +71 -0
  697. data/lib/puppet/pops/types/class_loader.rb +132 -0
  698. data/lib/puppet/pops/types/implementation_registry.rb +134 -0
  699. data/lib/puppet/pops/types/iterable.rb +365 -0
  700. data/lib/puppet/pops/types/p_binary_type.rb +232 -0
  701. data/lib/puppet/pops/types/p_init_type.rb +238 -0
  702. data/lib/puppet/pops/types/p_meta_type.rb +94 -0
  703. data/lib/puppet/pops/types/p_object_type.rb +1117 -0
  704. data/lib/puppet/pops/types/p_object_type_extension.rb +228 -0
  705. data/lib/puppet/pops/types/p_runtime_type.rb +115 -0
  706. data/lib/puppet/pops/types/p_sem_ver_range_type.rb +190 -0
  707. data/lib/puppet/pops/types/p_sem_ver_type.rb +155 -0
  708. data/lib/puppet/pops/types/p_sensitive_type.rb +83 -0
  709. data/lib/puppet/pops/types/p_timespan_type.rb +192 -0
  710. data/lib/puppet/pops/types/p_timestamp_type.rb +73 -0
  711. data/lib/puppet/pops/types/p_type_set_type.rb +387 -0
  712. data/lib/puppet/pops/types/p_uri_type.rb +190 -0
  713. data/lib/puppet/pops/types/puppet_object.rb +40 -0
  714. data/lib/puppet/pops/types/recursion_guard.rb +136 -0
  715. data/lib/puppet/pops/types/ruby_generator.rb +472 -0
  716. data/lib/puppet/pops/types/ruby_method.rb +31 -0
  717. data/lib/puppet/pops/types/string_converter.rb +1134 -0
  718. data/lib/puppet/pops/types/tree_iterators.rb +254 -0
  719. data/lib/puppet/pops/types/type_acceptor.rb +25 -0
  720. data/lib/puppet/pops/types/type_asserter.rb +47 -0
  721. data/lib/puppet/pops/types/type_assertion_error.rb +27 -0
  722. data/lib/puppet/pops/types/type_calculator.rb +822 -0
  723. data/lib/puppet/pops/types/type_conversion_error.rb +15 -0
  724. data/lib/puppet/pops/types/type_factory.rb +631 -0
  725. data/lib/puppet/pops/types/type_formatter.rb +801 -0
  726. data/lib/puppet/pops/types/type_mismatch_describer.rb +1096 -0
  727. data/lib/puppet/pops/types/type_parser.rb +683 -0
  728. data/lib/puppet/pops/types/type_set_reference.rb +59 -0
  729. data/lib/puppet/pops/types/type_with_members.rb +43 -0
  730. data/lib/puppet/pops/types/types.rb +3633 -0
  731. data/lib/puppet/pops/utils.rb +119 -0
  732. data/lib/puppet/pops/validation/checker4_0.rb +1148 -0
  733. data/lib/puppet/pops/validation/tasks_checker.rb +93 -0
  734. data/lib/puppet/pops/validation/validator_factory_4_0.rb +45 -0
  735. data/lib/puppet/pops/validation.rb +459 -0
  736. data/lib/puppet/pops/visitable.rb +6 -0
  737. data/lib/puppet/pops/visitor.rb +122 -0
  738. data/lib/puppet/pops.rb +121 -0
  739. data/lib/puppet/property/boolean.rb +7 -0
  740. data/lib/puppet/property/ensure.rb +106 -0
  741. data/lib/puppet/property/keyvalue.rb +158 -0
  742. data/lib/puppet/property/list.rb +70 -0
  743. data/lib/puppet/property/ordered_list.rb +29 -0
  744. data/lib/puppet/property.rb +611 -0
  745. data/lib/puppet/provider/aix_object.rb +485 -0
  746. data/lib/puppet/provider/command.rb +25 -0
  747. data/lib/puppet/provider/confine.rb +6 -0
  748. data/lib/puppet/provider/exec/posix.rb +60 -0
  749. data/lib/puppet/provider/exec/shell.rb +25 -0
  750. data/lib/puppet/provider/exec/windows.rb +55 -0
  751. data/lib/puppet/provider/exec.rb +105 -0
  752. data/lib/puppet/provider/file/posix.rb +144 -0
  753. data/lib/puppet/provider/file/windows.rb +152 -0
  754. data/lib/puppet/provider/group/aix.rb +99 -0
  755. data/lib/puppet/provider/group/directoryservice.rb +22 -0
  756. data/lib/puppet/provider/group/groupadd.rb +174 -0
  757. data/lib/puppet/provider/group/ldap.rb +48 -0
  758. data/lib/puppet/provider/group/pw.rb +51 -0
  759. data/lib/puppet/provider/group/windows_adsi.rb +113 -0
  760. data/lib/puppet/provider/ldap.rb +141 -0
  761. data/lib/puppet/provider/nameservice/directoryservice.rb +512 -0
  762. data/lib/puppet/provider/nameservice/objectadd.rb +22 -0
  763. data/lib/puppet/provider/nameservice/pw.rb +21 -0
  764. data/lib/puppet/provider/nameservice.rb +293 -0
  765. data/lib/puppet/provider/network_device.rb +74 -0
  766. data/lib/puppet/provider/package/aix.rb +169 -0
  767. data/lib/puppet/provider/package/appdmg.rb +111 -0
  768. data/lib/puppet/provider/package/apple.rb +47 -0
  769. data/lib/puppet/provider/package/apt.rb +262 -0
  770. data/lib/puppet/provider/package/aptitude.rb +35 -0
  771. data/lib/puppet/provider/package/aptrpm.rb +83 -0
  772. data/lib/puppet/provider/package/blastwave.rb +112 -0
  773. data/lib/puppet/provider/package/dnf.rb +50 -0
  774. data/lib/puppet/provider/package/dnfmodule.rb +141 -0
  775. data/lib/puppet/provider/package/dpkg.rb +192 -0
  776. data/lib/puppet/provider/package/fink.rb +97 -0
  777. data/lib/puppet/provider/package/freebsd.rb +47 -0
  778. data/lib/puppet/provider/package/gem.rb +293 -0
  779. data/lib/puppet/provider/package/hpux.rb +44 -0
  780. data/lib/puppet/provider/package/macports.rb +110 -0
  781. data/lib/puppet/provider/package/nim.rb +291 -0
  782. data/lib/puppet/provider/package/openbsd.rb +260 -0
  783. data/lib/puppet/provider/package/opkg.rb +82 -0
  784. data/lib/puppet/provider/package/pacman.rb +273 -0
  785. data/lib/puppet/provider/package/pip.rb +346 -0
  786. data/lib/puppet/provider/package/pip2.rb +17 -0
  787. data/lib/puppet/provider/package/pip3.rb +17 -0
  788. data/lib/puppet/provider/package/pkg.rb +295 -0
  789. data/lib/puppet/provider/package/pkgdmg.rb +153 -0
  790. data/lib/puppet/provider/package/pkgin.rb +87 -0
  791. data/lib/puppet/provider/package/pkgng.rb +173 -0
  792. data/lib/puppet/provider/package/pkgutil.rb +187 -0
  793. data/lib/puppet/provider/package/portage.rb +310 -0
  794. data/lib/puppet/provider/package/ports.rb +91 -0
  795. data/lib/puppet/provider/package/portupgrade.rb +240 -0
  796. data/lib/puppet/provider/package/puppet_gem.rb +34 -0
  797. data/lib/puppet/provider/package/puppetserver_gem.rb +171 -0
  798. data/lib/puppet/provider/package/rpm.rb +250 -0
  799. data/lib/puppet/provider/package/rug.rb +51 -0
  800. data/lib/puppet/provider/package/sun.rb +133 -0
  801. data/lib/puppet/provider/package/sunfreeware.rb +9 -0
  802. data/lib/puppet/provider/package/tdnf.rb +28 -0
  803. data/lib/puppet/provider/package/up2date.rb +40 -0
  804. data/lib/puppet/provider/package/urpmi.rb +55 -0
  805. data/lib/puppet/provider/package/windows/exe_package.rb +106 -0
  806. data/lib/puppet/provider/package/windows/msi_package.rb +70 -0
  807. data/lib/puppet/provider/package/windows/package.rb +110 -0
  808. data/lib/puppet/provider/package/windows.rb +130 -0
  809. data/lib/puppet/provider/package/yum.rb +387 -0
  810. data/lib/puppet/provider/package/zypper.rb +206 -0
  811. data/lib/puppet/provider/package.rb +59 -0
  812. data/lib/puppet/provider/package_targetable.rb +69 -0
  813. data/lib/puppet/provider/parsedfile.rb +490 -0
  814. data/lib/puppet/provider/service/base.rb +139 -0
  815. data/lib/puppet/provider/service/bsd.rb +51 -0
  816. data/lib/puppet/provider/service/daemontools.rb +193 -0
  817. data/lib/puppet/provider/service/debian.rb +75 -0
  818. data/lib/puppet/provider/service/freebsd.rb +143 -0
  819. data/lib/puppet/provider/service/gentoo.rb +45 -0
  820. data/lib/puppet/provider/service/init.rb +192 -0
  821. data/lib/puppet/provider/service/launchd.rb +384 -0
  822. data/lib/puppet/provider/service/openbsd.rb +100 -0
  823. data/lib/puppet/provider/service/openrc.rb +71 -0
  824. data/lib/puppet/provider/service/openwrt.rb +36 -0
  825. data/lib/puppet/provider/service/rcng.rb +51 -0
  826. data/lib/puppet/provider/service/redhat.rb +72 -0
  827. data/lib/puppet/provider/service/runit.rb +106 -0
  828. data/lib/puppet/provider/service/service.rb +68 -0
  829. data/lib/puppet/provider/service/smf.rb +317 -0
  830. data/lib/puppet/provider/service/src.rb +147 -0
  831. data/lib/puppet/provider/service/systemd.rb +232 -0
  832. data/lib/puppet/provider/service/upstart.rb +385 -0
  833. data/lib/puppet/provider/service/windows.rb +182 -0
  834. data/lib/puppet/provider/user/aix.rb +361 -0
  835. data/lib/puppet/provider/user/directoryservice.rb +680 -0
  836. data/lib/puppet/provider/user/hpux.rb +95 -0
  837. data/lib/puppet/provider/user/ldap.rb +132 -0
  838. data/lib/puppet/provider/user/openbsd.rb +77 -0
  839. data/lib/puppet/provider/user/pw.rb +108 -0
  840. data/lib/puppet/provider/user/user_role_add.rb +239 -0
  841. data/lib/puppet/provider/user/useradd.rb +406 -0
  842. data/lib/puppet/provider/user/windows_adsi.rb +172 -0
  843. data/lib/puppet/provider.rb +612 -0
  844. data/lib/puppet/reference/configuration.rb +97 -0
  845. data/lib/puppet/reference/function.rb +17 -0
  846. data/lib/puppet/reference/indirection.rb +71 -0
  847. data/lib/puppet/reference/metaparameter.rb +33 -0
  848. data/lib/puppet/reference/providers.rb +117 -0
  849. data/lib/puppet/reference/report.rb +20 -0
  850. data/lib/puppet/reference/type.rb +109 -0
  851. data/lib/puppet/relationship.rb +84 -0
  852. data/lib/puppet/reports/http.rb +44 -0
  853. data/lib/puppet/reports/log.rb +14 -0
  854. data/lib/puppet/reports/store.rb +68 -0
  855. data/lib/puppet/reports.rb +93 -0
  856. data/lib/puppet/resource/catalog.rb +654 -0
  857. data/lib/puppet/resource/status.rb +229 -0
  858. data/lib/puppet/resource/type.rb +425 -0
  859. data/lib/puppet/resource/type_collection.rb +231 -0
  860. data/lib/puppet/resource.rb +663 -0
  861. data/lib/puppet/runtime.rb +65 -0
  862. data/lib/puppet/scheduler/job.rb +53 -0
  863. data/lib/puppet/scheduler/scheduler.rb +44 -0
  864. data/lib/puppet/scheduler/splay_job.rb +32 -0
  865. data/lib/puppet/scheduler/timer.rb +13 -0
  866. data/lib/puppet/scheduler.rb +16 -0
  867. data/lib/puppet/settings/alias_setting.rb +37 -0
  868. data/lib/puppet/settings/array_setting.rb +17 -0
  869. data/lib/puppet/settings/autosign_setting.rb +22 -0
  870. data/lib/puppet/settings/base_setting.rb +223 -0
  871. data/lib/puppet/settings/boolean_setting.rb +32 -0
  872. data/lib/puppet/settings/certificate_revocation_setting.rb +21 -0
  873. data/lib/puppet/settings/config_file.rb +146 -0
  874. data/lib/puppet/settings/directory_setting.rb +18 -0
  875. data/lib/puppet/settings/duration_setting.rb +32 -0
  876. data/lib/puppet/settings/enum_setting.rb +16 -0
  877. data/lib/puppet/settings/environment_conf.rb +224 -0
  878. data/lib/puppet/settings/errors.rb +11 -0
  879. data/lib/puppet/settings/file_or_directory_setting.rb +40 -0
  880. data/lib/puppet/settings/file_setting.rb +241 -0
  881. data/lib/puppet/settings/http_extra_headers_setting.rb +25 -0
  882. data/lib/puppet/settings/ini_file.rb +226 -0
  883. data/lib/puppet/settings/integer_setting.rb +17 -0
  884. data/lib/puppet/settings/path_setting.rb +8 -0
  885. data/lib/puppet/settings/port_setting.rb +15 -0
  886. data/lib/puppet/settings/priority_setting.rb +43 -0
  887. data/lib/puppet/settings/server_list_setting.rb +29 -0
  888. data/lib/puppet/settings/string_setting.rb +9 -0
  889. data/lib/puppet/settings/symbolic_enum_setting.rb +17 -0
  890. data/lib/puppet/settings/terminus_setting.rb +14 -0
  891. data/lib/puppet/settings/ttl_setting.rb +51 -0
  892. data/lib/puppet/settings/value_translator.rb +14 -0
  893. data/lib/puppet/settings.rb +1642 -0
  894. data/lib/puppet/ssl/base.rb +149 -0
  895. data/lib/puppet/ssl/certificate.rb +96 -0
  896. data/lib/puppet/ssl/certificate_request.rb +324 -0
  897. data/lib/puppet/ssl/certificate_request_attributes.rb +37 -0
  898. data/lib/puppet/ssl/certificate_signer.rb +39 -0
  899. data/lib/puppet/ssl/digest.rb +20 -0
  900. data/lib/puppet/ssl/error.rb +26 -0
  901. data/lib/puppet/ssl/oids.rb +197 -0
  902. data/lib/puppet/ssl/openssl_loader.rb +24 -0
  903. data/lib/puppet/ssl/ssl_context.rb +25 -0
  904. data/lib/puppet/ssl/ssl_provider.rb +350 -0
  905. data/lib/puppet/ssl/state_machine.rb +474 -0
  906. data/lib/puppet/ssl/verifier.rb +142 -0
  907. data/lib/puppet/ssl.rb +23 -0
  908. data/lib/puppet/syntax_checkers/base64.rb +40 -0
  909. data/lib/puppet/syntax_checkers/epp.rb +34 -0
  910. data/lib/puppet/syntax_checkers/json.rb +35 -0
  911. data/lib/puppet/syntax_checkers/pp.rb +34 -0
  912. data/lib/puppet/syntax_checkers.rb +3 -0
  913. data/lib/puppet/test/test_helper.rb +265 -0
  914. data/lib/puppet/thread_local.rb +4 -0
  915. data/lib/puppet/transaction/additional_resource_generator.rb +220 -0
  916. data/lib/puppet/transaction/event.rb +168 -0
  917. data/lib/puppet/transaction/event_manager.rb +179 -0
  918. data/lib/puppet/transaction/persistence.rb +119 -0
  919. data/lib/puppet/transaction/report.rb +504 -0
  920. data/lib/puppet/transaction/resource_harness.rb +323 -0
  921. data/lib/puppet/transaction.rb +491 -0
  922. data/lib/puppet/trusted_external.rb +41 -0
  923. data/lib/puppet/type/component.rb +89 -0
  924. data/lib/puppet/type/exec.rb +720 -0
  925. data/lib/puppet/type/file/checksum.rb +50 -0
  926. data/lib/puppet/type/file/checksum_value.rb +54 -0
  927. data/lib/puppet/type/file/content.rb +176 -0
  928. data/lib/puppet/type/file/ctime.rb +21 -0
  929. data/lib/puppet/type/file/data_sync.rb +98 -0
  930. data/lib/puppet/type/file/ensure.rb +195 -0
  931. data/lib/puppet/type/file/group.rb +48 -0
  932. data/lib/puppet/type/file/mode.rb +189 -0
  933. data/lib/puppet/type/file/mtime.rb +19 -0
  934. data/lib/puppet/type/file/owner.rb +51 -0
  935. data/lib/puppet/type/file/selcontext.rb +142 -0
  936. data/lib/puppet/type/file/source.rb +379 -0
  937. data/lib/puppet/type/file/target.rb +88 -0
  938. data/lib/puppet/type/file/type.rb +20 -0
  939. data/lib/puppet/type/file.rb +1133 -0
  940. data/lib/puppet/type/filebucket.rb +121 -0
  941. data/lib/puppet/type/group.rb +237 -0
  942. data/lib/puppet/type/notify.rb +47 -0
  943. data/lib/puppet/type/package.rb +713 -0
  944. data/lib/puppet/type/resources.rb +187 -0
  945. data/lib/puppet/type/schedule.rb +441 -0
  946. data/lib/puppet/type/service.rb +309 -0
  947. data/lib/puppet/type/stage.rb +27 -0
  948. data/lib/puppet/type/tidy.rb +376 -0
  949. data/lib/puppet/type/user.rb +859 -0
  950. data/lib/puppet/type/whit.rb +34 -0
  951. data/lib/puppet/type.rb +2676 -0
  952. data/lib/puppet/util/at_fork/noop.rb +18 -0
  953. data/lib/puppet/util/at_fork/solaris.rb +160 -0
  954. data/lib/puppet/util/at_fork.rb +35 -0
  955. data/lib/puppet/util/autoload.rb +215 -0
  956. data/lib/puppet/util/backups.rb +86 -0
  957. data/lib/puppet/util/character_encoding.rb +80 -0
  958. data/lib/puppet/util/checksums.rb +376 -0
  959. data/lib/puppet/util/classgen.rb +228 -0
  960. data/lib/puppet/util/colors.rb +100 -0
  961. data/lib/puppet/util/command_line/puppet_option_parser.rb +87 -0
  962. data/lib/puppet/util/command_line/trollop.rb +825 -0
  963. data/lib/puppet/util/command_line.rb +196 -0
  964. data/lib/puppet/util/constant_inflector.rb +24 -0
  965. data/lib/puppet/util/diff.rb +81 -0
  966. data/lib/puppet/util/docs.rb +128 -0
  967. data/lib/puppet/util/errors.rb +159 -0
  968. data/lib/puppet/util/execution.rb +424 -0
  969. data/lib/puppet/util/execution_stub.rb +26 -0
  970. data/lib/puppet/util/feature.rb +129 -0
  971. data/lib/puppet/util/file_watcher.rb +28 -0
  972. data/lib/puppet/util/fileparsing.rb +408 -0
  973. data/lib/puppet/util/filetype.rb +358 -0
  974. data/lib/puppet/util/http_proxy.rb +4 -0
  975. data/lib/puppet/util/inifile.rb +340 -0
  976. data/lib/puppet/util/instance_loader.rb +66 -0
  977. data/lib/puppet/util/json.rb +92 -0
  978. data/lib/puppet/util/json_lockfile.rb +44 -0
  979. data/lib/puppet/util/ldap/connection.rb +73 -0
  980. data/lib/puppet/util/ldap/generator.rb +42 -0
  981. data/lib/puppet/util/ldap/manager.rb +284 -0
  982. data/lib/puppet/util/ldap.rb +2 -0
  983. data/lib/puppet/util/libuser.conf +15 -0
  984. data/lib/puppet/util/libuser.rb +12 -0
  985. data/lib/puppet/util/limits.rb +12 -0
  986. data/lib/puppet/util/lockfile.rb +66 -0
  987. data/lib/puppet/util/log/destination.rb +49 -0
  988. data/lib/puppet/util/log/destinations.rb +253 -0
  989. data/lib/puppet/util/log.rb +427 -0
  990. data/lib/puppet/util/logging.rb +300 -0
  991. data/lib/puppet/util/metaid.rb +21 -0
  992. data/lib/puppet/util/metric.rb +65 -0
  993. data/lib/puppet/util/monkey_patches.rb +122 -0
  994. data/lib/puppet/util/multi_match.rb +51 -0
  995. data/lib/puppet/util/network_device/base.rb +23 -0
  996. data/lib/puppet/util/network_device/config.rb +105 -0
  997. data/lib/puppet/util/network_device/transport/base.rb +26 -0
  998. data/lib/puppet/util/network_device/transport.rb +5 -0
  999. data/lib/puppet/util/network_device.rb +17 -0
  1000. data/lib/puppet/util/package/version/debian.rb +175 -0
  1001. data/lib/puppet/util/package/version/gem.rb +15 -0
  1002. data/lib/puppet/util/package/version/pip.rb +167 -0
  1003. data/lib/puppet/util/package/version/range/eq.rb +14 -0
  1004. data/lib/puppet/util/package/version/range/gt.rb +14 -0
  1005. data/lib/puppet/util/package/version/range/gt_eq.rb +14 -0
  1006. data/lib/puppet/util/package/version/range/lt.rb +14 -0
  1007. data/lib/puppet/util/package/version/range/lt_eq.rb +14 -0
  1008. data/lib/puppet/util/package/version/range/min_max.rb +21 -0
  1009. data/lib/puppet/util/package/version/range/simple.rb +11 -0
  1010. data/lib/puppet/util/package/version/range.rb +53 -0
  1011. data/lib/puppet/util/package/version/rpm.rb +73 -0
  1012. data/lib/puppet/util/package.rb +40 -0
  1013. data/lib/puppet/util/pidlock.rb +102 -0
  1014. data/lib/puppet/util/platform.rb +70 -0
  1015. data/lib/puppet/util/plist.rb +161 -0
  1016. data/lib/puppet/util/posix.rb +203 -0
  1017. data/lib/puppet/util/profiler/aggregate.rb +85 -0
  1018. data/lib/puppet/util/profiler/around_profiler.rb +67 -0
  1019. data/lib/puppet/util/profiler/logging.rb +48 -0
  1020. data/lib/puppet/util/profiler/object_counts.rb +17 -0
  1021. data/lib/puppet/util/profiler/wall_clock.rb +35 -0
  1022. data/lib/puppet/util/profiler.rb +53 -0
  1023. data/lib/puppet/util/provider_features.rb +179 -0
  1024. data/lib/puppet/util/psych_support.rb +30 -0
  1025. data/lib/puppet/util/rdoc/code_objects.rb +295 -0
  1026. data/lib/puppet/util/rdoc/generators/puppet_generator.rb +912 -0
  1027. data/lib/puppet/util/rdoc/generators/template/puppet/puppet.rb +1085 -0
  1028. data/lib/puppet/util/rdoc/parser/puppet_parser_core.rb +259 -0
  1029. data/lib/puppet/util/rdoc/parser/puppet_parser_rdoc2.rb +14 -0
  1030. data/lib/puppet/util/rdoc/parser.rb +12 -0
  1031. data/lib/puppet/util/rdoc.rb +53 -0
  1032. data/lib/puppet/util/reference.rb +119 -0
  1033. data/lib/puppet/util/resource_template.rb +61 -0
  1034. data/lib/puppet/util/retry_action.rb +46 -0
  1035. data/lib/puppet/util/rpm_compare.rb +193 -0
  1036. data/lib/puppet/util/rubygems.rb +67 -0
  1037. data/lib/puppet/util/run_mode.rb +122 -0
  1038. data/lib/puppet/util/selinux.rb +297 -0
  1039. data/lib/puppet/util/skip_tags.rb +13 -0
  1040. data/lib/puppet/util/splayer.rb +18 -0
  1041. data/lib/puppet/util/storage.rb +100 -0
  1042. data/lib/puppet/util/suidmanager.rb +166 -0
  1043. data/lib/puppet/util/symbolic_file_mode.rb +156 -0
  1044. data/lib/puppet/util/tag_set.rb +27 -0
  1045. data/lib/puppet/util/tagging.rb +132 -0
  1046. data/lib/puppet/util/terminal.rb +16 -0
  1047. data/lib/puppet/util/user_attr.rb +21 -0
  1048. data/lib/puppet/util/warnings.rb +31 -0
  1049. data/lib/puppet/util/watched_file.rb +37 -0
  1050. data/lib/puppet/util/watcher/change_watcher.rb +33 -0
  1051. data/lib/puppet/util/watcher/periodic_watcher.rb +37 -0
  1052. data/lib/puppet/util/watcher/timer.rb +19 -0
  1053. data/lib/puppet/util/watcher.rb +17 -0
  1054. data/lib/puppet/util/windows/access_control_entry.rb +84 -0
  1055. data/lib/puppet/util/windows/access_control_list.rb +113 -0
  1056. data/lib/puppet/util/windows/adsi.rb +654 -0
  1057. data/lib/puppet/util/windows/com.rb +225 -0
  1058. data/lib/puppet/util/windows/daemon.rb +343 -0
  1059. data/lib/puppet/util/windows/error.rb +84 -0
  1060. data/lib/puppet/util/windows/eventlog.rb +187 -0
  1061. data/lib/puppet/util/windows/file.rb +355 -0
  1062. data/lib/puppet/util/windows/monkey_patches/process.rb +414 -0
  1063. data/lib/puppet/util/windows/principal.rb +201 -0
  1064. data/lib/puppet/util/windows/process.rb +364 -0
  1065. data/lib/puppet/util/windows/registry.rb +441 -0
  1066. data/lib/puppet/util/windows/root_certs.rb +108 -0
  1067. data/lib/puppet/util/windows/security.rb +907 -0
  1068. data/lib/puppet/util/windows/security_descriptor.rb +62 -0
  1069. data/lib/puppet/util/windows/service.rb +696 -0
  1070. data/lib/puppet/util/windows/sid.rb +289 -0
  1071. data/lib/puppet/util/windows/string.rb +15 -0
  1072. data/lib/puppet/util/windows/user.rb +550 -0
  1073. data/lib/puppet/util/windows.rb +51 -0
  1074. data/lib/puppet/util/yaml.rb +65 -0
  1075. data/lib/puppet/util.rb +808 -0
  1076. data/lib/puppet/vendor/require_vendored.rb +4 -0
  1077. data/lib/puppet/vendor.rb +57 -0
  1078. data/lib/puppet/version.rb +95 -0
  1079. data/lib/puppet/x509/cert_provider.rb +369 -0
  1080. data/lib/puppet/x509/pem_store.rb +55 -0
  1081. data/lib/puppet/x509.rb +11 -0
  1082. data/lib/puppet.rb +345 -0
  1083. data/lib/puppet_pal.rb +8 -0
  1084. data/lib/puppet_x.rb +14 -0
  1085. data/locales/config.yaml +29 -0
  1086. data/locales/en/puppet.po +19 -0
  1087. data/locales/puppet.pot +20 -0
  1088. data/man/man5/puppet.conf.5 +2198 -0
  1089. data/man/man8/puppet-agent.8 +203 -0
  1090. data/man/man8/puppet-apply.8 +100 -0
  1091. data/man/man8/puppet-catalog.8 +291 -0
  1092. data/man/man8/puppet-config.8 +151 -0
  1093. data/man/man8/puppet-describe.8 +51 -0
  1094. data/man/man8/puppet-device.8 +119 -0
  1095. data/man/man8/puppet-doc.8 +46 -0
  1096. data/man/man8/puppet-epp.8 +377 -0
  1097. data/man/man8/puppet-facts.8 +234 -0
  1098. data/man/man8/puppet-filebucket.8 +166 -0
  1099. data/man/man8/puppet-generate.8 +84 -0
  1100. data/man/man8/puppet-help.8 +67 -0
  1101. data/man/man8/puppet-lookup.8 +107 -0
  1102. data/man/man8/puppet-module.8 +325 -0
  1103. data/man/man8/puppet-node.8 +163 -0
  1104. data/man/man8/puppet-parser.8 +130 -0
  1105. data/man/man8/puppet-plugin.8 +73 -0
  1106. data/man/man8/puppet-report.8 +127 -0
  1107. data/man/man8/puppet-resource.8 +88 -0
  1108. data/man/man8/puppet-script.8 +70 -0
  1109. data/man/man8/puppet-ssl.8 +63 -0
  1110. data/man/man8/puppet.8 +28 -0
  1111. data/tasks/benchmark.rake +180 -0
  1112. data/tasks/ci.rake +24 -0
  1113. data/tasks/generate_ast_model.rake +90 -0
  1114. data/tasks/generate_cert_fixtures.rake +194 -0
  1115. data/tasks/manpages.rake +67 -0
  1116. data/tasks/memwalk.rake +195 -0
  1117. data/tasks/parallel.rake +410 -0
  1118. data/tasks/parser.rake +22 -0
  1119. data/tasks/yard.rake +59 -0
  1120. metadata +1324 -0
@@ -0,0 +1,1642 @@
1
+ require_relative '../puppet'
2
+ require 'getoptlong'
3
+ require_relative '../puppet/util/watched_file'
4
+ require_relative '../puppet/util/command_line/puppet_option_parser'
5
+ require 'forwardable'
6
+ require 'fileutils'
7
+ require 'concurrent'
8
+ require_relative 'concurrent/lock'
9
+
10
+ # The class for handling configuration files.
11
+ class Puppet::Settings
12
+ extend Forwardable
13
+ include Enumerable
14
+
15
+ require_relative 'settings/errors'
16
+ require_relative 'settings/base_setting'
17
+ require_relative 'settings/string_setting'
18
+ require_relative 'settings/enum_setting'
19
+ require_relative 'settings/symbolic_enum_setting'
20
+ require_relative 'settings/array_setting'
21
+ require_relative 'settings/file_setting'
22
+ require_relative 'settings/directory_setting'
23
+ require_relative 'settings/file_or_directory_setting'
24
+ require_relative 'settings/path_setting'
25
+ require_relative 'settings/boolean_setting'
26
+ require_relative 'settings/integer_setting'
27
+ require_relative 'settings/port_setting'
28
+ require_relative 'settings/terminus_setting'
29
+ require_relative 'settings/duration_setting'
30
+ require_relative 'settings/ttl_setting'
31
+ require_relative 'settings/priority_setting'
32
+ require_relative 'settings/autosign_setting'
33
+ require_relative 'settings/config_file'
34
+ require_relative 'settings/value_translator'
35
+ require_relative 'settings/environment_conf'
36
+ require_relative 'settings/server_list_setting'
37
+ require_relative 'settings/http_extra_headers_setting'
38
+ require_relative 'settings/certificate_revocation_setting'
39
+ require_relative 'settings/alias_setting'
40
+
41
+ # local reference for convenience
42
+ PuppetOptionParser = Puppet::Util::CommandLine::PuppetOptionParser
43
+
44
+ attr_reader :timer
45
+
46
+ # These are the settings that every app is required to specify; there are
47
+ # reasonable defaults defined in application.rb.
48
+ REQUIRED_APP_SETTINGS = [:logdir, :confdir, :vardir, :codedir]
49
+
50
+ # The acceptable sections of the puppet.conf configuration file.
51
+ ALLOWED_SECTION_NAMES = ['main', 'server', 'master', 'agent', 'user'].freeze
52
+
53
+ NONE = 'none'.freeze
54
+
55
+ # This method is intended for puppet internal use only; it is a convenience method that
56
+ # returns reasonable application default settings values for a given run_mode.
57
+ def self.app_defaults_for_run_mode(run_mode)
58
+ {
59
+ :name => run_mode.to_s,
60
+ :run_mode => run_mode.name,
61
+ :confdir => run_mode.conf_dir,
62
+ :codedir => run_mode.code_dir,
63
+ :vardir => run_mode.var_dir,
64
+ :publicdir => run_mode.public_dir,
65
+ :rundir => run_mode.run_dir,
66
+ :logdir => run_mode.log_dir,
67
+ }
68
+ end
69
+
70
+ def self.default_certname()
71
+ hostname = hostname_fact
72
+ domain = domain_fact
73
+ if domain and domain != ""
74
+ fqdn = [hostname, domain].join(".")
75
+ else
76
+ fqdn = hostname
77
+ end
78
+ fqdn.to_s.gsub(/\.$/, '')
79
+ end
80
+
81
+ def self.hostname_fact()
82
+ Puppet.runtime[:facter].value :hostname
83
+ end
84
+
85
+ def self.domain_fact()
86
+ Puppet.runtime[:facter].value :domain
87
+ end
88
+
89
+ def self.default_config_file_name
90
+ "puppet.conf"
91
+ end
92
+
93
+ def stringify_settings(section, settings = :all)
94
+ values_from_the_selected_section =
95
+ values(nil, section.to_sym)
96
+
97
+ loader_settings = {
98
+ :environmentpath => values_from_the_selected_section.interpolate(:environmentpath),
99
+ :basemodulepath => values_from_the_selected_section.interpolate(:basemodulepath),
100
+ }
101
+
102
+ Puppet.override(Puppet.base_context(loader_settings),
103
+ _("New environment loaders generated from the requested section.")) do
104
+ # And now we can lookup values that include those from environments configured from
105
+ # the requested section
106
+ values = values(Puppet[:environment].to_sym, section.to_sym)
107
+
108
+ to_be_rendered = {}
109
+ settings = Puppet.settings.to_a.collect(&:first) if settings == :all
110
+ settings.sort.each do |setting_name|
111
+ to_be_rendered[setting_name] = values.print(setting_name.to_sym)
112
+ end
113
+
114
+ stringifyhash(to_be_rendered)
115
+ end
116
+ end
117
+
118
+ def stringifyhash(hash)
119
+ newhash = {}
120
+ hash.each do |key, val|
121
+ key = key.to_s
122
+ if val.is_a? Hash
123
+ newhash[key] = stringifyhash(val)
124
+ elsif val.is_a? Symbol
125
+ newhash[key] = val.to_s
126
+ else
127
+ newhash[key] = val
128
+ end
129
+ end
130
+ newhash
131
+ end
132
+
133
+ # Create a new collection of config settings.
134
+ def initialize
135
+ @config = {}
136
+ @shortnames = {}
137
+
138
+ @created = []
139
+
140
+ # Keep track of set values.
141
+ @value_sets = {
142
+ :cli => Values.new(:cli, @config),
143
+ :memory => Values.new(:memory, @config),
144
+ :application_defaults => Values.new(:application_defaults, @config),
145
+ :overridden_defaults => Values.new(:overridden_defaults, @config),
146
+ }
147
+ @configuration_file = nil
148
+
149
+ # And keep a per-environment cache
150
+ # We can't use Concurrent::Map because we want to preserve insertion order
151
+ @cache_lock = Puppet::Concurrent::Lock.new
152
+ @cache = Concurrent::Hash.new do |hash, key|
153
+ @cache_lock.synchronize do
154
+ break hash[key] if hash.key?(key)
155
+ hash[key] = Concurrent::Hash.new
156
+ end
157
+ end
158
+ @values_lock = Puppet::Concurrent::Lock.new
159
+ @values = Concurrent::Hash.new do |hash, key|
160
+ @values_lock.synchronize do
161
+ break hash[key] if hash.key?(key)
162
+ hash[key] = Concurrent::Hash.new
163
+ end
164
+ end
165
+
166
+ # The list of sections we've used.
167
+ @used = []
168
+
169
+ @hooks_to_call_on_application_initialization = []
170
+ @deprecated_setting_names = []
171
+ @deprecated_settings_that_have_been_configured = []
172
+
173
+ @translate = Puppet::Settings::ValueTranslator.new
174
+ @config_file_parser = Puppet::Settings::ConfigFile.new(@translate)
175
+ end
176
+
177
+ # Retrieve a config value
178
+ # @param param [Symbol] the name of the setting
179
+ # @return [Object] the value of the setting
180
+ # @api private
181
+ def [](param)
182
+ if @deprecated_setting_names.include?(param)
183
+ issue_deprecation_warning(setting(param), "Accessing '#{param}' as a setting is deprecated.")
184
+ end
185
+ value(param)
186
+ end
187
+
188
+ # Set a config value. This doesn't set the defaults, it sets the value itself.
189
+ # @param param [Symbol] the name of the setting
190
+ # @param value [Object] the new value of the setting
191
+ # @api private
192
+ def []=(param, value)
193
+ if @deprecated_setting_names.include?(param)
194
+ issue_deprecation_warning(setting(param), "Modifying '#{param}' as a setting is deprecated.")
195
+ end
196
+ @value_sets[:memory].set(param, value)
197
+ unsafe_flush_cache
198
+ end
199
+
200
+ # Create a new default value for the given setting. The default overrides are
201
+ # higher precedence than the defaults given in defaults.rb, but lower
202
+ # precedence than any other values for the setting. This allows one setting
203
+ # `a` to change the default of setting `b`, but still allow a user to provide
204
+ # a value for setting `b`.
205
+ #
206
+ # @param param [Symbol] the name of the setting
207
+ # @param value [Object] the new default value for the setting
208
+ # @api private
209
+ def override_default(param, value)
210
+ @value_sets[:overridden_defaults].set(param, value)
211
+ unsafe_flush_cache
212
+ end
213
+
214
+ # Generate the list of valid arguments, in a format that GetoptLong can
215
+ # understand, and add them to the passed option list.
216
+ def addargs(options)
217
+ # Add all of the settings as valid options.
218
+ self.each { |name, setting|
219
+ setting.getopt_args.each { |args| options << args }
220
+ }
221
+
222
+ options
223
+ end
224
+
225
+ # Generate the list of valid arguments, in a format that OptionParser can
226
+ # understand, and add them to the passed option list.
227
+ def optparse_addargs(options)
228
+ # Add all of the settings as valid options.
229
+ self.each { |name, setting|
230
+ options << setting.optparse_args
231
+ }
232
+
233
+ options
234
+ end
235
+
236
+ # Is our setting a boolean setting?
237
+ def boolean?(param)
238
+ param = param.to_sym
239
+ @config.include?(param) and @config[param].kind_of?(BooleanSetting)
240
+ end
241
+
242
+ # Remove all set values, potentially skipping cli values.
243
+ def clear
244
+ unsafe_clear
245
+ end
246
+
247
+ # Remove all set values, potentially skipping cli values.
248
+ def unsafe_clear(clear_cli = true, clear_application_defaults = false)
249
+ if clear_application_defaults
250
+ @value_sets[:application_defaults] = Values.new(:application_defaults, @config)
251
+ @app_defaults_initialized = false
252
+ end
253
+
254
+ if clear_cli
255
+ @value_sets[:cli] = Values.new(:cli, @config)
256
+
257
+ # Only clear the 'used' values if we were explicitly asked to clear out
258
+ # :cli values; otherwise, it may be just a config file reparse,
259
+ # and we want to retain this cli values.
260
+ @used = []
261
+ end
262
+
263
+ @value_sets[:memory] = Values.new(:memory, @config)
264
+ @value_sets[:overridden_defaults] = Values.new(:overridden_defaults, @config)
265
+
266
+ @deprecated_settings_that_have_been_configured.clear
267
+ @values.clear
268
+ @cache.clear
269
+ end
270
+ private :unsafe_clear
271
+
272
+ # Clears all cached settings for a particular environment to ensure
273
+ # that changes to environment.conf are reflected in the settings if
274
+ # the environment timeout has expired.
275
+ #
276
+ # param [String, Symbol] environment the name of environment to clear settings for
277
+ #
278
+ # @api private
279
+ def clear_environment_settings(environment)
280
+
281
+ if environment.nil?
282
+ return
283
+ end
284
+
285
+ @cache[environment.to_sym].clear
286
+ @values[environment.to_sym] = {}
287
+ end
288
+
289
+ # Clear @cache, @used and the Environment.
290
+ #
291
+ # Whenever an object is returned by Settings, a copy is stored in @cache.
292
+ # As long as Setting attributes that determine the content of returned
293
+ # objects remain unchanged, Settings can keep returning objects from @cache
294
+ # without re-fetching or re-generating them.
295
+ #
296
+ # Whenever a Settings attribute changes, such as @values or @preferred_run_mode,
297
+ # this method must be called to clear out the caches so that updated
298
+ # objects will be returned.
299
+ def flush_cache
300
+ unsafe_flush_cache
301
+ end
302
+
303
+ def unsafe_flush_cache
304
+ clearused
305
+ end
306
+ private :unsafe_flush_cache
307
+
308
+ def clearused
309
+ @cache.clear
310
+ @used = []
311
+ end
312
+
313
+ def global_defaults_initialized?()
314
+ @global_defaults_initialized
315
+ end
316
+
317
+ def initialize_global_settings(args = [], require_config = true)
318
+ raise Puppet::DevError, _("Attempting to initialize global default settings more than once!") if global_defaults_initialized?
319
+
320
+ # The first two phases of the lifecycle of a puppet application are:
321
+ # 1) Parse the command line options and handle any of them that are
322
+ # registered, defined "global" puppet settings (mostly from defaults.rb).
323
+ # 2) Parse the puppet config file(s).
324
+
325
+ parse_global_options(args)
326
+ parse_config_files(require_config)
327
+
328
+ @global_defaults_initialized = true
329
+ end
330
+
331
+ # This method is called during application bootstrapping. It is responsible for parsing all of the
332
+ # command line options and initializing the settings accordingly.
333
+ #
334
+ # It will ignore options that are not defined in the global puppet settings list, because they may
335
+ # be valid options for the specific application that we are about to launch... however, at this point
336
+ # in the bootstrapping lifecycle, we don't yet know what that application is.
337
+ def parse_global_options(args)
338
+ # Create an option parser
339
+ option_parser = PuppetOptionParser.new
340
+ option_parser.ignore_invalid_options = true
341
+
342
+ # Add all global options to it.
343
+ self.optparse_addargs([]).each do |option|
344
+ option_parser.on(*option) do |arg|
345
+ opt, val = Puppet::Settings.clean_opt(option[0], arg)
346
+ handlearg(opt, val)
347
+ end
348
+ end
349
+
350
+ option_parser.on('--run_mode',
351
+ "The effective 'run mode' of the application: server, agent, or user.",
352
+ :REQUIRED) do |arg|
353
+ Puppet.settings.preferred_run_mode = arg
354
+ end
355
+
356
+ option_parser.parse(args)
357
+
358
+ # remove run_mode options from the arguments so that later parses don't think
359
+ # it is an unknown option.
360
+ while option_index = args.index('--run_mode') do #rubocop:disable Lint/AssignmentInCondition
361
+ args.delete_at option_index
362
+ args.delete_at option_index
363
+ end
364
+ args.reject! { |arg| arg.start_with? '--run_mode=' }
365
+ end
366
+ private :parse_global_options
367
+
368
+ # A utility method (public, is used by application.rb and perhaps elsewhere) that munges a command-line
369
+ # option string into the format that Puppet.settings expects. (This mostly has to deal with handling the
370
+ # "no-" prefix on flag/boolean options).
371
+ #
372
+ # @param [String] opt the command line option that we are munging
373
+ # @param [String, TrueClass, FalseClass] val the value for the setting (as determined by the OptionParser)
374
+ def self.clean_opt(opt, val)
375
+ # rewrite --[no-]option to --no-option if that's what was given
376
+ if opt =~ /\[no-\]/ and !val
377
+ opt = opt.gsub(/\[no-\]/,'no-')
378
+ end
379
+ # otherwise remove the [no-] prefix to not confuse everybody
380
+ opt = opt.gsub(/\[no-\]/, '')
381
+ [opt, val]
382
+ end
383
+
384
+
385
+ def app_defaults_initialized?
386
+ @app_defaults_initialized
387
+ end
388
+
389
+ def initialize_app_defaults(app_defaults)
390
+ REQUIRED_APP_SETTINGS.each do |key|
391
+ raise SettingsError, "missing required app default setting '#{key}'" unless app_defaults.has_key?(key)
392
+ end
393
+
394
+ app_defaults.each do |key, value|
395
+ if key == :run_mode
396
+ self.preferred_run_mode = value
397
+ else
398
+ @value_sets[:application_defaults].set(key, value)
399
+ unsafe_flush_cache
400
+ end
401
+ end
402
+ apply_metadata
403
+ call_hooks_deferred_to_application_initialization
404
+ issue_deprecations
405
+
406
+ REQUIRED_APP_SETTINGS.each do |key|
407
+ create_ancestors(Puppet[key])
408
+ end
409
+
410
+ @app_defaults_initialized = true
411
+ end
412
+
413
+ # Create ancestor directories.
414
+ #
415
+ # @param dir [String] absolute path for a required application default directory
416
+ # @api private
417
+
418
+ def create_ancestors(dir)
419
+ parent_dir = File.dirname(dir)
420
+
421
+ if !File.exist?(parent_dir)
422
+ FileUtils.mkdir_p(parent_dir)
423
+ end
424
+ end
425
+ private :create_ancestors
426
+
427
+ def call_hooks_deferred_to_application_initialization(options = {})
428
+ @hooks_to_call_on_application_initialization.each do |setting|
429
+ begin
430
+ setting.handle(self.value(setting.name))
431
+ rescue InterpolationError => err
432
+ raise InterpolationError, err.message, err.backtrace unless options[:ignore_interpolation_dependency_errors]
433
+ #swallow. We're not concerned if we can't call hooks because dependencies don't exist yet
434
+ #we'll get another chance after application defaults are initialized
435
+ end
436
+ end
437
+ end
438
+ private :call_hooks_deferred_to_application_initialization
439
+
440
+ # Return a value's description.
441
+ def description(name)
442
+ obj = @config[name.to_sym]
443
+ if obj
444
+ obj.desc
445
+ else
446
+ nil
447
+ end
448
+ end
449
+
450
+ def_delegators :@config, :each, :each_pair, :each_key
451
+
452
+ # Iterate over each section name.
453
+ def eachsection
454
+ yielded = []
455
+ @config.each_value do |object|
456
+ section = object.section
457
+ unless yielded.include? section
458
+ yield section
459
+ yielded << section
460
+ end
461
+ end
462
+ end
463
+
464
+ # Returns a given setting by name
465
+ # @param name [Symbol] The name of the setting to fetch
466
+ # @return [Puppet::Settings::BaseSetting] The setting object
467
+ def setting(param)
468
+ param = param.to_sym
469
+ @config[param]
470
+ end
471
+
472
+ # Handle a command-line argument.
473
+ def handlearg(opt, value = nil)
474
+ @cache.clear
475
+
476
+ if value.is_a?(FalseClass)
477
+ value = "false"
478
+ elsif value.is_a?(TrueClass)
479
+ value = "true"
480
+ end
481
+
482
+ value &&= @translate[value]
483
+ str = opt.sub(/^--/,'')
484
+
485
+ bool = true
486
+ newstr = str.sub(/^no-/, '')
487
+ if newstr != str
488
+ str = newstr
489
+ bool = false
490
+ end
491
+ str = str.intern
492
+
493
+ if @config[str].is_a?(Puppet::Settings::BooleanSetting)
494
+ if value == "" or value.nil?
495
+ value = bool
496
+ end
497
+ end
498
+
499
+ s = @config[str]
500
+ if s
501
+ @deprecated_settings_that_have_been_configured << s if s.completely_deprecated?
502
+ end
503
+
504
+ @value_sets[:cli].set(str, value)
505
+ unsafe_flush_cache
506
+ end
507
+
508
+ def include?(name)
509
+ name = name.intern if name.is_a? String
510
+ @config.include?(name)
511
+ end
512
+
513
+ # Prints the contents of a config file with the available config settings, or it
514
+ # prints a single value of a config setting.
515
+ def print_config_options
516
+ if Puppet::Util::Log.sendlevel?(:info)
517
+ Puppet::Util::Log.newdestination(:console)
518
+ message = (_("Using --configprint is deprecated. Use 'puppet config <subcommand>' instead."))
519
+ Puppet.deprecation_warning(message)
520
+ end
521
+
522
+ env = value(:environment)
523
+ val = value(:configprint)
524
+ if val == "all"
525
+ hash = {}
526
+ each do |name, obj|
527
+ val = value(name,env)
528
+ val = val.inspect if val == ""
529
+ hash[name] = val
530
+ end
531
+ hash.sort { |a,b| a[0].to_s <=> b[0].to_s }.each do |name, v|
532
+ puts "#{name} = #{v}"
533
+ end
534
+ else
535
+ val.split(/\s*,\s*/).sort.each do |v|
536
+ if include?(v)
537
+ #if there is only one value, just print it for back compatibility
538
+ if v == val
539
+ puts value(val,env)
540
+ break
541
+ end
542
+ puts "#{v} = #{value(v,env)}"
543
+ else
544
+ puts "invalid setting: #{v}"
545
+ return false
546
+ end
547
+ end
548
+ end
549
+ true
550
+ end
551
+
552
+ def generate_config
553
+ puts to_config
554
+ true
555
+ end
556
+
557
+ def generate_manifest
558
+ puts to_manifest
559
+ true
560
+ end
561
+
562
+ def print_configs
563
+ return print_config_options if value(:configprint) != ""
564
+ return generate_config if value(:genconfig)
565
+ generate_manifest if value(:genmanifest)
566
+ end
567
+
568
+ def print_configs?
569
+ (value(:configprint) != "" || value(:genconfig) || value(:genmanifest)) && true
570
+ end
571
+
572
+ # The currently configured run mode that is preferred for constructing the application configuration.
573
+ def preferred_run_mode
574
+ @preferred_run_mode_name || :user
575
+ end
576
+
577
+ # PRIVATE! This only exists because we need a hook to validate the run mode when it's being set, and
578
+ # it should never, ever, ever, ever be called from outside of this file.
579
+ # This method is also called when --run_mode MODE is used on the command line to set the default
580
+ #
581
+ # @param mode [String|Symbol] the name of the mode to have in effect
582
+ # @api private
583
+ def preferred_run_mode=(mode)
584
+ mode = mode.to_s.downcase.intern
585
+ raise ValidationError, "Invalid run mode '#{mode}'" unless [:server, :master, :agent, :user].include?(mode)
586
+ @preferred_run_mode_name = mode
587
+ # Changing the run mode has far-reaching consequences. Flush any cached
588
+ # settings so they will be re-generated.
589
+ flush_cache
590
+ mode
591
+ end
592
+
593
+ def parse_config(text, file = "text")
594
+ begin
595
+ data = @config_file_parser.parse_file(file, text, ALLOWED_SECTION_NAMES)
596
+ rescue => detail
597
+ Puppet.log_exception(detail, "Could not parse #{file}: #{detail}")
598
+ return
599
+ end
600
+
601
+ # If we get here and don't have any data, we just return and don't muck with the current state of the world.
602
+ return if data.nil?
603
+
604
+ # If we get here then we have some data, so we need to clear out any
605
+ # previous settings that may have come from config files.
606
+ unsafe_clear(false, false)
607
+
608
+ # Screen settings which have been deprecated and removed from puppet.conf
609
+ # but are still valid on the command line and/or in environment.conf
610
+ screen_non_puppet_conf_settings(data)
611
+
612
+ # Make note of deprecated settings we will warn about later in initialization
613
+ record_deprecations_from_puppet_conf(data)
614
+
615
+ # And now we can repopulate with the values from our last parsing of the config files.
616
+ @configuration_file = data
617
+
618
+ # Determine our environment, if we have one.
619
+ if @config[:environment]
620
+ env = self.value(:environment).to_sym
621
+ else
622
+ env = NONE
623
+ end
624
+
625
+ # Call any hooks we should be calling.
626
+ value_sets = value_sets_for(env, preferred_run_mode)
627
+ @config.values.select(&:has_hook?).each do |setting|
628
+ value_sets.each do |source|
629
+ if source.include?(setting.name)
630
+ # We still have to use value to retrieve the value, since
631
+ # we want the fully interpolated value, not $vardir/lib or whatever.
632
+ # This results in extra work, but so few of the settings
633
+ # will have associated hooks that it ends up being less work this
634
+ # way overall.
635
+ if setting.call_hook_on_initialize?
636
+ @hooks_to_call_on_application_initialization |= [ setting ]
637
+ else
638
+ setting.handle(ChainedValues.new(
639
+ preferred_run_mode,
640
+ env,
641
+ value_sets,
642
+ @config).interpolate(setting.name))
643
+ end
644
+ break
645
+ end
646
+ end
647
+ end
648
+
649
+ call_hooks_deferred_to_application_initialization :ignore_interpolation_dependency_errors => true
650
+ apply_metadata
651
+ end
652
+
653
+ # Parse the configuration file. Just provides thread safety.
654
+ def parse_config_files(require_config = true)
655
+ file = which_configuration_file
656
+ if Puppet::FileSystem.exist?(file)
657
+ begin
658
+ text = read_file(file)
659
+ rescue => detail
660
+ message = _("Could not load %{file}: %{detail}") % { file: file, detail: detail}
661
+ if require_config
662
+ Puppet.log_and_raise(detail, message)
663
+ else
664
+ Puppet.log_exception(detail, message)
665
+ return
666
+ end
667
+ end
668
+ else
669
+ return
670
+ end
671
+
672
+ parse_config(text, file)
673
+ end
674
+ private :parse_config_files
675
+
676
+ def main_config_file
677
+ if explicit_config_file?
678
+ return self[:config]
679
+ else
680
+ return File.join(Puppet::Util::RunMode[:server].conf_dir, config_file_name)
681
+ end
682
+ end
683
+ private :main_config_file
684
+
685
+ def user_config_file
686
+ return File.join(Puppet::Util::RunMode[:user].conf_dir, config_file_name)
687
+ end
688
+ private :user_config_file
689
+
690
+ # This method is here to get around some life-cycle issues. We need to be
691
+ # able to determine the config file name before the settings / defaults are
692
+ # fully loaded. However, we also need to respect any overrides of this value
693
+ # that the user may have specified on the command line.
694
+ #
695
+ # The easiest way to do this is to attempt to read the setting, and if we
696
+ # catch an error (meaning that it hasn't been set yet), we'll fall back to
697
+ # the default value.
698
+ def config_file_name
699
+ begin
700
+ return self[:config_file_name] if self[:config_file_name]
701
+ rescue SettingsError
702
+ # This just means that the setting wasn't explicitly set on the command line, so we will ignore it and
703
+ # fall through to the default name.
704
+ end
705
+ return self.class.default_config_file_name
706
+ end
707
+ private :config_file_name
708
+
709
+ def apply_metadata
710
+ # We have to do it in the reverse of the search path,
711
+ # because multiple sections could set the same value
712
+ # and I'm too lazy to only set the metadata once.
713
+ if @configuration_file
714
+ searchpath(nil, preferred_run_mode).reverse_each do |source|
715
+ section = @configuration_file.sections[source.name] if source.type == :section
716
+ if section
717
+ apply_metadata_from_section(section)
718
+ end
719
+ end
720
+ end
721
+ end
722
+ private :apply_metadata
723
+
724
+ def apply_metadata_from_section(section)
725
+ section.settings.each do |setting|
726
+ type = @config[setting.name] if setting.has_metadata?
727
+ if type
728
+ type.set_meta(setting.meta)
729
+ end
730
+ end
731
+ end
732
+
733
+ SETTING_TYPES = {
734
+ :string => StringSetting,
735
+ :file => FileSetting,
736
+ :directory => DirectorySetting,
737
+ :file_or_directory => FileOrDirectorySetting,
738
+ :path => PathSetting,
739
+ :boolean => BooleanSetting,
740
+ :integer => IntegerSetting,
741
+ :port => PortSetting,
742
+ :terminus => TerminusSetting,
743
+ :duration => DurationSetting,
744
+ :ttl => TTLSetting,
745
+ :array => ArraySetting,
746
+ :enum => EnumSetting,
747
+ :symbolic_enum => SymbolicEnumSetting,
748
+ :priority => PrioritySetting,
749
+ :autosign => AutosignSetting,
750
+ :server_list => ServerListSetting,
751
+ :http_extra_headers => HttpExtraHeadersSetting,
752
+ :certificate_revocation => CertificateRevocationSetting,
753
+ :alias => AliasSetting
754
+ }
755
+
756
+ # Create a new setting. The value is passed in because it's used to determine
757
+ # what kind of setting we're creating, but the value itself might be either
758
+ # a default or a value, so we can't actually assign it.
759
+ #
760
+ # See #define_settings for documentation on the legal values for the ":type" option.
761
+ def newsetting(hash)
762
+ klass = nil
763
+ hash[:section] = hash[:section].to_sym if hash[:section]
764
+
765
+ type = hash[:type]
766
+ if type
767
+ klass = SETTING_TYPES[type]
768
+ unless klass
769
+ raise ArgumentError, _("Invalid setting type '%{type}'") % { type: type }
770
+ end
771
+ hash.delete(:type)
772
+ else
773
+ # The only implicit typing we still do for settings is to fall back to "String" type if they didn't explicitly
774
+ # specify a type. Personally I'd like to get rid of this too, and make the "type" option mandatory... but
775
+ # there was a little resistance to taking things quite that far for now. --cprice 2012-03-19
776
+ klass = StringSetting
777
+ end
778
+ hash[:settings] = self
779
+ setting = klass.new(hash)
780
+
781
+ setting
782
+ end
783
+
784
+ # This has to be private, because it doesn't add the settings to @config
785
+ private :newsetting
786
+
787
+ # Iterate across all of the objects in a given section.
788
+ def persection(section)
789
+ section = section.to_sym
790
+ self.each { |name, obj|
791
+ if obj.section == section
792
+ yield obj
793
+ end
794
+ }
795
+ end
796
+
797
+ # Reparse our config file, if necessary.
798
+ def reparse_config_files
799
+ if files
800
+ filename = any_files_changed?
801
+ if filename
802
+ Puppet.notice "Config file #{filename} changed; triggering re-parse of all config files."
803
+ parse_config_files
804
+ reuse
805
+ end
806
+ end
807
+ end
808
+
809
+ def files
810
+ return @files if @files
811
+ @files = []
812
+ [main_config_file, user_config_file].each do |path|
813
+ if Puppet::FileSystem.exist?(path)
814
+ @files << Puppet::Util::WatchedFile.new(path)
815
+ end
816
+ end
817
+ @files
818
+ end
819
+ private :files
820
+
821
+ # Checks to see if any of the config files have been modified
822
+ # @return the filename of the first file that is found to have changed, or
823
+ # nil if no files have changed
824
+ def any_files_changed?
825
+ files.each do |file|
826
+ return file.to_str if file.changed?
827
+ end
828
+ nil
829
+ end
830
+ private :any_files_changed?
831
+
832
+ def reuse
833
+ return unless defined?(@used)
834
+ new = @used
835
+ @used = []
836
+ self.use(*new)
837
+ end
838
+
839
+ class SearchPathElement < Struct.new(:name, :type); end
840
+
841
+ # The order in which to search for values, without defaults.
842
+ #
843
+ # @param environment [String,Symbol] symbolic reference to an environment name
844
+ # @param run_mode [Symbol] symbolic reference to a Puppet run mode
845
+ # @return [Array<SearchPathElement>]
846
+ # @api private
847
+ def configsearchpath(environment = nil, run_mode = preferred_run_mode)
848
+ searchpath = [
849
+ SearchPathElement.new(:memory, :values),
850
+ SearchPathElement.new(:cli, :values),
851
+ ]
852
+ searchpath << SearchPathElement.new(environment.intern, :environment) if environment
853
+
854
+ if run_mode
855
+ if [:master, :server].include?(run_mode)
856
+ searchpath << SearchPathElement.new(:server, :section)
857
+ searchpath << SearchPathElement.new(:master, :section)
858
+ else
859
+ searchpath << SearchPathElement.new(run_mode, :section)
860
+ end
861
+ end
862
+
863
+ searchpath << SearchPathElement.new(:main, :section)
864
+ end
865
+
866
+ # The order in which to search for values.
867
+ #
868
+ # @param environment [String,Symbol] symbolic reference to an environment name
869
+ # @param run_mode [Symbol] symbolic reference to a Puppet run mode
870
+ # @return [Array<SearchPathElement>]
871
+ # @api private
872
+ def searchpath(environment = nil, run_mode = preferred_run_mode)
873
+ searchpath = configsearchpath(environment, run_mode)
874
+ searchpath << SearchPathElement.new(:application_defaults, :values)
875
+ searchpath << SearchPathElement.new(:overridden_defaults, :values)
876
+ end
877
+
878
+ def service_user_available?
879
+ return @service_user_available if defined?(@service_user_available)
880
+
881
+ if self[:user]
882
+ user = Puppet::Type.type(:user).new :name => self[:user], :audit => :ensure
883
+
884
+ if user.suitable?
885
+ @service_user_available = user.exists?
886
+ else
887
+ raise Puppet::Error, (_("Cannot manage owner permissions, because the provider for '%{name}' is not functional") % { name: user })
888
+ end
889
+ else
890
+ @service_user_available = false
891
+ end
892
+ end
893
+
894
+ def service_group_available?
895
+ return @service_group_available if defined?(@service_group_available)
896
+
897
+ if self[:group]
898
+ group = Puppet::Type.type(:group).new :name => self[:group], :audit => :ensure
899
+
900
+ if group.suitable?
901
+ @service_group_available = group.exists?
902
+ else
903
+ raise Puppet::Error, (_("Cannot manage group permissions, because the provider for '%{name}' is not functional") % { name: group })
904
+ end
905
+ else
906
+ @service_group_available = false
907
+ end
908
+ end
909
+
910
+ # Allow later inspection to determine if the setting was set on the
911
+ # command line, or through some other code path. Used for the
912
+ # `dns_alt_names` option during cert generate. --daniel 2011-10-18
913
+ #
914
+ # @param param [String, Symbol] the setting to look up
915
+ # @return [Object, nil] the value of the setting or nil if unset
916
+ def set_by_cli(param)
917
+ param = param.to_sym
918
+ @value_sets[:cli].lookup(param)
919
+ end
920
+
921
+ def set_by_cli?(param)
922
+ !!set_by_cli(param)
923
+ end
924
+
925
+ # Get values from a search path entry.
926
+ # @api private
927
+ def searchpath_values(source)
928
+ case source.type
929
+ when :values
930
+ @value_sets[source.name]
931
+ when :section
932
+ section = @configuration_file.sections[source.name] if @configuration_file
933
+ if section
934
+ ValuesFromSection.new(source.name, section)
935
+ end
936
+ when :environment
937
+ ValuesFromEnvironmentConf.new(source.name)
938
+ else
939
+ raise Puppet::DevError, _("Unknown searchpath case: %{source_type} for the %{source} settings path element.") % { source_type: source.type, source: source}
940
+ end
941
+ end
942
+
943
+ # Allow later inspection to determine if the setting was set by user
944
+ # config, rather than a default setting.
945
+ def set_by_config?(param, environment = nil, run_mode = preferred_run_mode)
946
+ param = param.to_sym
947
+ configsearchpath(environment, run_mode).any? do |source|
948
+ vals = searchpath_values(source)
949
+ if vals
950
+ vals.lookup(param)
951
+ end
952
+ end
953
+ end
954
+
955
+ # Allow later inspection to determine if the setting was set in a specific
956
+ # section
957
+ #
958
+ # @param param [String, Symbol] the setting to look up
959
+ # @param section [Symbol] the section in which to look up the setting
960
+ # @return [Object, nil] the value of the setting or nil if unset
961
+ def set_in_section(param, section)
962
+ param = param.to_sym
963
+ vals = searchpath_values(SearchPathElement.new(section, :section))
964
+ if vals
965
+ vals.lookup(param)
966
+ end
967
+ end
968
+
969
+ def set_in_section?(param, section)
970
+ !!set_in_section(param, section)
971
+ end
972
+
973
+ # Patches the value for a param in a section.
974
+ # This method is required to support the use case of unifying --dns-alt-names and
975
+ # --dns_alt_names in the certificate face. Ideally this should be cleaned up.
976
+ # See PUP-3684 for more information.
977
+ # For regular use of setting a value, the method `[]=` should be used.
978
+ # @api private
979
+ #
980
+ def patch_value(param, value, type)
981
+ if @value_sets[type]
982
+ @value_sets[type].set(param, value)
983
+ unsafe_flush_cache
984
+ end
985
+ end
986
+
987
+ # Define a group of settings.
988
+ #
989
+ # @param [Symbol] section a symbol to use for grouping multiple settings together into a conceptual unit. This value
990
+ # (and the conceptual separation) is not used very often; the main place where it will have a potential impact
991
+ # is when code calls Settings#use method. See docs on that method for further details, but basically that method
992
+ # just attempts to do any preparation that may be necessary before code attempts to leverage the value of a particular
993
+ # setting. This has the most impact for file/directory settings, where #use will attempt to "ensure" those
994
+ # files / directories.
995
+ # @param [Hash[Hash]] defs the settings to be defined. This argument is a hash of hashes; each key should be a symbol,
996
+ # which is basically the name of the setting that you are defining. The value should be another hash that specifies
997
+ # the parameters for the particular setting. Legal values include:
998
+ # [:default] => not required; this is the value for the setting if no other value is specified (via cli, config file, etc.)
999
+ # For string settings this may include "variables", demarcated with $ or ${} which will be interpolated with values of other settings.
1000
+ # The default value may also be a Proc that will be called only once to evaluate the default when the setting's value is retrieved.
1001
+ # [:desc] => required; a description of the setting, used in documentation / help generation
1002
+ # [:type] => not required, but highly encouraged! This specifies the data type that the setting represents. If
1003
+ # you do not specify it, it will default to "string". Legal values include:
1004
+ # :string - A generic string setting
1005
+ # :boolean - A boolean setting; values are expected to be "true" or "false"
1006
+ # :file - A (single) file path; puppet may attempt to create this file depending on how the settings are used. This type
1007
+ # also supports additional options such as "mode", "owner", "group"
1008
+ # :directory - A (single) directory path; puppet may attempt to create this file depending on how the settings are used. This type
1009
+ # also supports additional options such as "mode", "owner", "group"
1010
+ # :path - This is intended to be used for settings whose value can contain multiple directory paths, represented
1011
+ # as strings separated by the system path separator (e.g. system path, module path, etc.).
1012
+ # [:mode] => an (optional) octal value to be used as the permissions/mode for :file and :directory settings
1013
+ # [:owner] => optional owner username/uid for :file and :directory settings
1014
+ # [:group] => optional group name/gid for :file and :directory settings
1015
+ #
1016
+ def define_settings(section, defs)
1017
+ section = section.to_sym
1018
+ call = []
1019
+ defs.each do |name, hash|
1020
+ raise ArgumentError, _("setting definition for '%{name}' is not a hash!") % { name: name } unless hash.is_a? Hash
1021
+
1022
+ name = name.to_sym
1023
+ hash[:name] = name
1024
+ hash[:section] = section
1025
+ raise ArgumentError, _("Setting %{name} is already defined") % { name: name } if @config.include?(name)
1026
+ tryconfig = newsetting(hash)
1027
+ short = tryconfig.short
1028
+ if short
1029
+ other = @shortnames[short]
1030
+ if other
1031
+ raise ArgumentError, _("Setting %{name} is already using short name '%{short}'") % { name: other.name, short: short }
1032
+ end
1033
+ @shortnames[short] = tryconfig
1034
+ end
1035
+ @config[name] = tryconfig
1036
+
1037
+ # Collect the settings that need to have their hooks called immediately.
1038
+ # We have to collect them so that we can be sure we're fully initialized before
1039
+ # the hook is called.
1040
+ if tryconfig.has_hook?
1041
+ if tryconfig.call_hook_on_define?
1042
+ call << tryconfig
1043
+ elsif tryconfig.call_hook_on_initialize?
1044
+ @hooks_to_call_on_application_initialization |= [ tryconfig ]
1045
+ end
1046
+ end
1047
+
1048
+ @deprecated_setting_names << name if tryconfig.deprecated?
1049
+ end
1050
+
1051
+ call.each do |setting|
1052
+ setting.handle(self.value(setting.name))
1053
+ end
1054
+ end
1055
+
1056
+ # Convert the settings we manage into a catalog full of resources that model those settings.
1057
+ def to_catalog(*sections)
1058
+ sections = nil if sections.empty?
1059
+
1060
+ catalog = Puppet::Resource::Catalog.new("Settings", Puppet::Node::Environment::NONE)
1061
+ @config.keys.find_all { |key| @config[key].is_a?(FileSetting) }.each do |key|
1062
+ file = @config[key]
1063
+ next if file.value.nil?
1064
+ next unless (sections.nil? or sections.include?(file.section))
1065
+ resource = file.to_resource
1066
+ next unless resource
1067
+ next if catalog.resource(resource.ref)
1068
+
1069
+ Puppet.debug {"Using settings: adding file resource '#{key}': '#{resource.inspect}'"}
1070
+
1071
+ catalog.add_resource(resource)
1072
+ end
1073
+
1074
+ add_user_resources(catalog, sections)
1075
+ add_environment_resources(catalog, sections)
1076
+
1077
+ catalog
1078
+ end
1079
+
1080
+ # Convert our list of config settings into a configuration file.
1081
+ def to_config
1082
+ str = %{The configuration file for #{Puppet.run_mode.name}. Note that this file
1083
+ is likely to have unused settings in it; any setting that's
1084
+ valid anywhere in Puppet can be in any config file, even if it's not used.
1085
+
1086
+ Every section can specify three special parameters: owner, group, and mode.
1087
+ These parameters affect the required permissions of any files specified after
1088
+ their specification. Puppet will sometimes use these parameters to check its
1089
+ own configured state, so they can be used to make Puppet a bit more self-managing.
1090
+
1091
+ The file format supports octothorpe-commented lines, but not partial-line comments.
1092
+
1093
+ Generated on #{Time.now}.
1094
+
1095
+ }.gsub(/^/, "# ")
1096
+
1097
+ # Add a section heading that matches our name.
1098
+ str += "[#{preferred_run_mode}]\n"
1099
+ eachsection do |section|
1100
+ persection(section) do |obj|
1101
+ str += obj.to_config + "\n" unless obj.name == :genconfig
1102
+ end
1103
+ end
1104
+
1105
+ return str
1106
+ end
1107
+
1108
+ # Convert to a parseable manifest
1109
+ def to_manifest
1110
+ catalog = to_catalog
1111
+ catalog.resource_refs.collect do |ref|
1112
+ catalog.resource(ref).to_manifest
1113
+ end.join("\n\n")
1114
+ end
1115
+
1116
+ # Create the necessary objects to use a section. This is idempotent;
1117
+ # you can 'use' a section as many times as you want.
1118
+ def use(*sections)
1119
+ if Puppet[:settings_catalog]
1120
+ sections = sections.collect { |s| s.to_sym }
1121
+ sections = sections.reject { |s| @used.include?(s) }
1122
+
1123
+ Puppet.warning(":master section deprecated in favor of :server section") if sections.include?(:master)
1124
+
1125
+ # add :server if sections include :master or :master if sections include :server
1126
+ sections |= [:master, :server] if (sections & [:master, :server]).any?
1127
+
1128
+ sections = sections.collect { |s| s.to_sym }
1129
+ sections = sections.reject { |s| @used.include?(s) }
1130
+
1131
+ return if sections.empty?
1132
+
1133
+ Puppet.debug { "Applying settings catalog for sections #{sections.join(', ')}" }
1134
+
1135
+ begin
1136
+ catalog = to_catalog(*sections).to_ral
1137
+ rescue => detail
1138
+ Puppet.log_and_raise(detail, "Could not create resources for managing Puppet's files and directories in sections #{sections.inspect}: #{detail}")
1139
+ end
1140
+
1141
+ catalog.host_config = false
1142
+ catalog.apply do |transaction|
1143
+ if transaction.any_failed?
1144
+ report = transaction.report
1145
+ status_failures = report.resource_statuses.values.select { |r| r.failed? }
1146
+ status_fail_msg = status_failures.
1147
+ collect(&:events).
1148
+ flatten.
1149
+ select { |event| event.status == 'failure' }.
1150
+ collect { |event| "#{event.resource}: #{event.message}" }.join("; ")
1151
+
1152
+ raise "Got #{status_failures.length} failure(s) while initializing: #{status_fail_msg}"
1153
+ end
1154
+ end
1155
+
1156
+ sections.each { |s| @used << s }
1157
+ @used.uniq!
1158
+ else
1159
+ Puppet.debug("Skipping settings catalog for sections #{sections.join(', ')}")
1160
+ end
1161
+ end
1162
+
1163
+ def valid?(param)
1164
+ param = param.to_sym
1165
+ @config.has_key?(param)
1166
+ end
1167
+
1168
+ # Retrieve an object that can be used for looking up values of configuration
1169
+ # settings.
1170
+ #
1171
+ # @param environment [Symbol] The name of the environment in which to lookup
1172
+ # @param section [Symbol] The name of the configuration section in which to lookup
1173
+ # @return [Puppet::Settings::ChainedValues] An object to perform lookups
1174
+ # @api public
1175
+ def values(environment, section)
1176
+ @values[environment][section] ||= ChainedValues.new(
1177
+ section,
1178
+ environment,
1179
+ value_sets_for(environment, section),
1180
+ @config)
1181
+ end
1182
+
1183
+ # Find the correct value using our search path.
1184
+ #
1185
+ # @param param [String, Symbol] The value to look up
1186
+ # @param environment [String, Symbol] The environment to check for the value
1187
+ # @param bypass_interpolation [true, false] Whether to skip interpolation
1188
+ #
1189
+ # @return [Object] The looked up value
1190
+ #
1191
+ # @raise [InterpolationError]
1192
+ def value(param, environment = nil, bypass_interpolation = false)
1193
+ environment &&= environment.to_sym
1194
+ value_sym(param.to_sym, environment, bypass_interpolation)
1195
+ end
1196
+
1197
+ # Find the correct value using symbols and our search path.
1198
+ #
1199
+ # @param param [Symbol] The value to look up
1200
+ # @param environment [Symbol] The environment to check for the value
1201
+ # @param bypass_interpolation [true, false] Whether to skip interpolation
1202
+ #
1203
+ # @return [Object] The looked up value
1204
+ #
1205
+ # @raise [InterpolationError]
1206
+ def value_sym(param, environment = nil, bypass_interpolation = false)
1207
+ # Check the cache first. It needs to be a per-environment
1208
+ # cache so that we don't spread values from one env
1209
+ # to another.
1210
+ cached_env = @cache[environment || NONE]
1211
+
1212
+ # Avoid two lookups in cache_env unless val is nil. When it is, it's important
1213
+ # to check if the key is included so that further processing (that will result
1214
+ # in nil again) is avoided.
1215
+ val = cached_env[param]
1216
+ return val if !val.nil? || cached_env.include?(param)
1217
+
1218
+ # Short circuit to nil for undefined settings.
1219
+ return nil unless @config.include?(param)
1220
+
1221
+ vals = values(environment, preferred_run_mode)
1222
+ val = bypass_interpolation ? vals.lookup(param) : vals.interpolate(param)
1223
+ cached_env[param] = val
1224
+ val
1225
+ end
1226
+
1227
+ ##
1228
+ # (#15337) All of the logic to determine the configuration file to use
1229
+ # should be centralized into this method. The simplified approach is:
1230
+ #
1231
+ # 1. If there is an explicit configuration file, use that. (--confdir or
1232
+ # --config)
1233
+ # 2. If we're running as a root process, use the system puppet.conf
1234
+ # (usually /etc/puppetlabs/puppet/puppet.conf)
1235
+ # 3. Otherwise, use the user puppet.conf (usually ~/.puppetlabs/etc/puppet/puppet.conf)
1236
+ #
1237
+ # @api private
1238
+ # @todo this code duplicates {Puppet::Util::RunMode#which_dir} as described
1239
+ # in {https://projects.puppetlabs.com/issues/16637 #16637}
1240
+ def which_configuration_file
1241
+ if explicit_config_file? or Puppet.features.root? then
1242
+ return main_config_file
1243
+ else
1244
+ return user_config_file
1245
+ end
1246
+ end
1247
+
1248
+ # This method just turns a file into a new ConfigFile::Conf instance
1249
+ # @param file [String] absolute path to the configuration file
1250
+ # @return [Puppet::Settings::ConfigFile::Conf]
1251
+ # @api private
1252
+ def parse_file(file, allowed_sections = [])
1253
+ @config_file_parser.parse_file(file, read_file(file), allowed_sections)
1254
+ end
1255
+
1256
+ private
1257
+
1258
+ DEPRECATION_REFS = {
1259
+ # intentionally empty. This could be repopulated if we deprecate more settings
1260
+ # and have reference links to associate with them
1261
+ }.freeze
1262
+
1263
+ def screen_non_puppet_conf_settings(puppet_conf)
1264
+ puppet_conf.sections.values.each do |section|
1265
+ forbidden = section.settings.select { |setting| Puppet::Settings::EnvironmentConf::ENVIRONMENT_CONF_ONLY_SETTINGS.include?(setting.name) }
1266
+ raise(SettingsError, "Cannot set #{forbidden.map { |s| s.name }.join(", ")} settings in puppet.conf") if !forbidden.empty?
1267
+ end
1268
+ end
1269
+
1270
+ # Record that we want to issue a deprecation warning later in the application
1271
+ # initialization cycle when we have settings bootstrapped to the point where
1272
+ # we can read the Puppet[:disable_warnings] setting.
1273
+ #
1274
+ # We are only recording warnings applicable to settings set in puppet.conf
1275
+ # itself.
1276
+ def record_deprecations_from_puppet_conf(puppet_conf)
1277
+ puppet_conf.sections.values.each do |section|
1278
+ section.settings.each do |conf_setting|
1279
+ setting = self.setting(conf_setting.name)
1280
+ if setting
1281
+ @deprecated_settings_that_have_been_configured << setting if setting.deprecated?
1282
+ end
1283
+ end
1284
+ end
1285
+ end
1286
+
1287
+ def issue_deprecations
1288
+ @deprecated_settings_that_have_been_configured.each do |setting|
1289
+ issue_deprecation_warning(setting)
1290
+ end
1291
+ end
1292
+
1293
+ def issue_deprecation_warning(setting, msg = nil)
1294
+ name = setting.name
1295
+ ref = DEPRECATION_REFS.find { |params,reference| params.include?(name) }
1296
+ ref = ref[1] if ref
1297
+ case
1298
+ when msg
1299
+ msg << " #{ref}" if ref
1300
+ Puppet.deprecation_warning(msg)
1301
+ when setting.completely_deprecated?
1302
+ message = _("Setting %{name} is deprecated.") % { name: name }
1303
+ message += " #{ref}"
1304
+ Puppet.deprecation_warning(message, "setting-#{name}")
1305
+ when setting.allowed_on_commandline?
1306
+ #TRANSLATORS 'puppet.conf' is a file name and should not be translated
1307
+ message = _("Setting %{name} is deprecated in puppet.conf.") % { name: name }
1308
+ message += " #{ref}"
1309
+ Puppet.deprecation_warning(message, "puppet-conf-setting-#{name}")
1310
+ end
1311
+ end
1312
+
1313
+ def add_environment_resources(catalog, sections)
1314
+ configured_environment = self[:environment]
1315
+
1316
+ if configured_environment == "production" && !production_environment_exists?
1317
+ environment_path = self[:environmentpath]
1318
+ first_environment_path = environment_path.split(File::PATH_SEPARATOR).first
1319
+
1320
+ if Puppet::FileSystem.exist?(first_environment_path)
1321
+ production_environment_path = File.join(first_environment_path, configured_environment)
1322
+ parameters = { :ensure => 'directory' }
1323
+ parameters[:mode] = '0750'
1324
+ if Puppet.features.root?
1325
+ parameters[:owner] = Puppet[:user] if service_user_available?
1326
+ parameters[:group] = Puppet[:group] if service_group_available?
1327
+ end
1328
+ catalog.add_resource(Puppet::Resource.new(:file, production_environment_path, :parameters => parameters))
1329
+ end
1330
+ end
1331
+ end
1332
+
1333
+ def production_environment_exists?
1334
+ environment_path = self[:environmentpath]
1335
+ paths = environment_path.split(File::PATH_SEPARATOR)
1336
+
1337
+ paths.any? do |path|
1338
+ # If expected_path is a symlink, assume the source path is being managed
1339
+ # elsewhere, so accept it also as a valid production environment path
1340
+ expected_path = File.join(path, 'production')
1341
+ Puppet::FileSystem.directory?(expected_path) || Puppet::FileSystem.symlink?(expected_path)
1342
+ end
1343
+ end
1344
+
1345
+ def add_user_resources(catalog, sections)
1346
+ return unless Puppet.features.root?
1347
+ return if Puppet::Util::Platform.windows?
1348
+ return unless self[:mkusers]
1349
+
1350
+ @config.each do |name, setting|
1351
+ next unless setting.respond_to?(:owner)
1352
+ next unless sections.nil? or sections.include?(setting.section)
1353
+
1354
+ user = setting.owner
1355
+ if user && user != "root" && catalog.resource(:user, user).nil?
1356
+ resource = Puppet::Resource.new(:user, user, :parameters => {:ensure => :present})
1357
+ resource[:gid] = self[:group] if self[:group]
1358
+ catalog.add_resource resource
1359
+ end
1360
+ group = setting.group
1361
+ if group && ! %w{root wheel}.include?(group) && catalog.resource(:group, group).nil?
1362
+ catalog.add_resource Puppet::Resource.new(:group, group, :parameters => {:ensure => :present})
1363
+ end
1364
+ end
1365
+ end
1366
+
1367
+ # Yield each search source in turn.
1368
+ def value_sets_for(environment, mode)
1369
+ searchpath(environment, mode).collect { |source| searchpath_values(source) }.compact
1370
+ end
1371
+
1372
+ # Read the file in.
1373
+ # @api private
1374
+ def read_file(file)
1375
+ return Puppet::FileSystem.read(file, :encoding => 'utf-8')
1376
+ end
1377
+
1378
+ # Private method for internal test use only; allows to do a comprehensive clear of all settings between tests.
1379
+ #
1380
+ # @return nil
1381
+ def clear_everything_for_tests()
1382
+ unsafe_clear(true, true)
1383
+ @configuration_file = nil
1384
+ @global_defaults_initialized = false
1385
+ @app_defaults_initialized = false
1386
+ end
1387
+ private :clear_everything_for_tests
1388
+
1389
+ def explicit_config_file?
1390
+ # Figure out if the user has provided an explicit configuration file. If
1391
+ # so, return the path to the file, if not return nil.
1392
+ #
1393
+ # The easiest way to determine whether an explicit one has been specified
1394
+ # is to simply attempt to evaluate the value of ":config". This will
1395
+ # obviously be successful if they've passed an explicit value for :config,
1396
+ # but it will also result in successful interpolation if they've only
1397
+ # passed an explicit value for :confdir.
1398
+ #
1399
+ # If they've specified neither, then the interpolation will fail and we'll
1400
+ # get an exception.
1401
+ #
1402
+ begin
1403
+ return true if self[:config]
1404
+ rescue InterpolationError
1405
+ # This means we failed to interpolate, which means that they didn't
1406
+ # explicitly specify either :config or :confdir... so we'll fall out to
1407
+ # the default value.
1408
+ return false
1409
+ end
1410
+ end
1411
+ private :explicit_config_file?
1412
+
1413
+ # Lookup configuration setting value through a chain of different value sources.
1414
+ #
1415
+ # @api public
1416
+ class ChainedValues
1417
+ ENVIRONMENT_SETTING = "environment".freeze
1418
+ ENVIRONMENT_INTERPOLATION_ALLOWED = ['config_version'].freeze
1419
+
1420
+ # @see Puppet::Settings.values
1421
+ # @api private
1422
+ def initialize(mode, environment, value_sets, defaults)
1423
+ @mode = mode
1424
+ @environment = environment
1425
+ @value_sets = value_sets
1426
+ @defaults = defaults
1427
+ end
1428
+
1429
+ # Lookup the uninterpolated value.
1430
+ #
1431
+ # @param name [Symbol] The configuration setting name to look up
1432
+ # @return [Object] The configuration setting value or nil if the setting is not known
1433
+ # @api public
1434
+ def lookup(name)
1435
+ set = @value_sets.find do |value_set|
1436
+ value_set.include?(name)
1437
+ end
1438
+ if set
1439
+ value = set.lookup(name)
1440
+ if !value.nil?
1441
+ return value
1442
+ end
1443
+ end
1444
+
1445
+ setting = @defaults[name]
1446
+ if setting.respond_to?(:alias_name)
1447
+ val = lookup(setting.alias_name)
1448
+ return val if val
1449
+ end
1450
+
1451
+ @defaults[name].default
1452
+ end
1453
+
1454
+ # Lookup the interpolated value. All instances of `$name` in the value will
1455
+ # be replaced by performing a lookup of `name` and substituting the text
1456
+ # for `$name` in the original value. This interpolation is only performed
1457
+ # if the looked up value is a String.
1458
+ #
1459
+ # @param name [Symbol] The configuration setting name to look up
1460
+ # @return [Object] The configuration setting value or nil if the setting is not known
1461
+ # @api public
1462
+ def interpolate(name)
1463
+ setting = @defaults[name]
1464
+ return nil unless setting
1465
+
1466
+ lookup_and_convert(name) do |val|
1467
+ setting.munge(val)
1468
+ end
1469
+ end
1470
+
1471
+ def print(name)
1472
+ setting = @defaults[name]
1473
+ return nil unless setting
1474
+
1475
+ lookup_and_convert(name) do |val|
1476
+ setting.print(val)
1477
+ end
1478
+ end
1479
+
1480
+ private
1481
+
1482
+ def lookup_and_convert(name, &block)
1483
+ val = lookup(name)
1484
+ # if we interpolate code, all hell breaks loose.
1485
+ if name == :code
1486
+ val
1487
+ else
1488
+ # Convert it if necessary
1489
+ begin
1490
+ val = convert(val, name)
1491
+ rescue InterpolationError => err
1492
+ # This happens because we don't have access to the param name when the
1493
+ # exception is originally raised, but we want it in the message
1494
+ raise InterpolationError, _("Error converting value for param '%{name}': %{detail}") % { name: name, detail: err }, err.backtrace
1495
+ end
1496
+
1497
+ yield val
1498
+ end
1499
+ end
1500
+
1501
+ def convert(value, setting_name)
1502
+ case value
1503
+ when nil
1504
+ nil
1505
+ when String
1506
+ failed_environment_interpolation = false
1507
+ interpolated_value = value.gsub(/\$(\w+)|\$\{(\w+)\}/) do |expression|
1508
+ varname = $2 || $1
1509
+ interpolated_expression =
1510
+ if varname != ENVIRONMENT_SETTING || ok_to_interpolate_environment(setting_name)
1511
+ if varname == ENVIRONMENT_SETTING && @environment
1512
+ @environment
1513
+ elsif varname == "run_mode"
1514
+ @mode
1515
+ elsif !(pval = interpolate(varname.to_sym)).nil?
1516
+ pval
1517
+ else
1518
+ raise InterpolationError, _("Could not find value for %{expression}") % { expression: expression }
1519
+ end
1520
+ else
1521
+ failed_environment_interpolation = true
1522
+ expression
1523
+ end
1524
+ interpolated_expression
1525
+ end
1526
+ if failed_environment_interpolation
1527
+ #TRANSLATORS '$environment' is a Puppet specific variable and should not be translated
1528
+ Puppet.warning(_("You cannot interpolate $environment within '%{setting_name}' when using directory environments.") % { setting_name: setting_name } +
1529
+ ' ' + _("Its value will remain %{value}.") % { value: interpolated_value })
1530
+ end
1531
+ interpolated_value
1532
+ else
1533
+ value
1534
+ end
1535
+ end
1536
+
1537
+ def ok_to_interpolate_environment(setting_name)
1538
+ ENVIRONMENT_INTERPOLATION_ALLOWED.include?(setting_name.to_s)
1539
+ end
1540
+ end
1541
+
1542
+ class Values
1543
+ extend Forwardable
1544
+
1545
+ attr_reader :name
1546
+
1547
+ def initialize(name, defaults)
1548
+ @name = name
1549
+ @values = {}
1550
+ @defaults = defaults
1551
+ end
1552
+
1553
+ def_delegator :@values, :include?
1554
+ def_delegator :@values, :[], :lookup
1555
+
1556
+ def set(name, value)
1557
+ default = @defaults[name]
1558
+
1559
+ if !default
1560
+ raise ArgumentError, _("Attempt to assign a value to unknown setting %{name}") % { name: name.inspect }
1561
+ end
1562
+
1563
+ # This little exception-handling dance ensures that a hook is
1564
+ # able to check whether a value for itself has been explicitly
1565
+ # set, while still preserving the existing value if the hook
1566
+ # throws (as was existing behavior)
1567
+ old_value = @values[name]
1568
+ @values[name] = value
1569
+ begin
1570
+ if default.has_hook?
1571
+ default.handle(value)
1572
+ end
1573
+ rescue Exception => e
1574
+ @values[name] = old_value
1575
+ raise e
1576
+ end
1577
+ end
1578
+
1579
+ def inspect
1580
+ %Q{<#{self.class}:#{self.object_id} @name="#{@name}" @values="#{@values}">}
1581
+ end
1582
+ end
1583
+
1584
+ class ValuesFromSection
1585
+ attr_reader :name
1586
+
1587
+ def initialize(name, section)
1588
+ @name = name
1589
+ @section = section
1590
+ end
1591
+
1592
+ def include?(name)
1593
+ !@section.setting(name).nil?
1594
+ end
1595
+
1596
+ def lookup(name)
1597
+ setting = @section.setting(name)
1598
+ if setting
1599
+ setting.value
1600
+ end
1601
+ end
1602
+
1603
+ def inspect
1604
+ %Q{<#{self.class}:#{self.object_id} @name="#{@name}" @section="#{@section}">}
1605
+ end
1606
+ end
1607
+
1608
+ # @api private
1609
+ class ValuesFromEnvironmentConf
1610
+ def initialize(environment_name)
1611
+ @environment_name = environment_name
1612
+ end
1613
+
1614
+ def name
1615
+ @environment_name
1616
+ end
1617
+
1618
+ def include?(name)
1619
+ if Puppet::Settings::EnvironmentConf::VALID_SETTINGS.include?(name) && conf
1620
+ return true
1621
+ end
1622
+ false
1623
+ end
1624
+
1625
+ def lookup(name)
1626
+ return nil unless Puppet::Settings::EnvironmentConf::VALID_SETTINGS.include?(name)
1627
+ conf.send(name) if conf
1628
+ end
1629
+
1630
+ def conf
1631
+ unless @conf
1632
+ environments = Puppet.lookup(:environments) { nil }
1633
+ @conf = environments.get_conf(@environment_name) if environments
1634
+ end
1635
+ @conf
1636
+ end
1637
+
1638
+ def inspect
1639
+ %Q{<#{self.class}:#{self.object_id} @environment_name="#{@environment_name}" @conf="#{@conf}">}
1640
+ end
1641
+ end
1642
+ end