openvox 8.19.0

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 (1104) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +19 -0
  3. data/CODEOWNERS +11 -0
  4. data/CODE_OF_CONDUCT.md +70 -0
  5. data/Gemfile +87 -0
  6. data/Guardfile.example +76 -0
  7. data/LICENSE +202 -0
  8. data/README.md +63 -0
  9. data/Rakefile +170 -0
  10. data/bin/puppet +10 -0
  11. data/conf/environment.conf +18 -0
  12. data/conf/fileserver.conf +32 -0
  13. data/conf/hiera.yaml +11 -0
  14. data/conf/puppet.conf +6 -0
  15. data/examples/enc/regexp_nodes/classes/databases +2 -0
  16. data/examples/enc/regexp_nodes/classes/webservers +2 -0
  17. data/examples/enc/regexp_nodes/environment/development +2 -0
  18. data/examples/enc/regexp_nodes/parameters/service/prod +1 -0
  19. data/examples/enc/regexp_nodes/parameters/service/qa +3 -0
  20. data/examples/enc/regexp_nodes/parameters/service/sandbox +1 -0
  21. data/examples/enc/regexp_nodes/regexp_nodes.rb +270 -0
  22. data/examples/hiera/README.md +102 -0
  23. data/examples/hiera/data/common.yaml +12 -0
  24. data/examples/hiera/data/dc1.yaml +6 -0
  25. data/examples/hiera/hiera.yaml +15 -0
  26. data/examples/hiera/modules/ntp/data/common.yaml +4 -0
  27. data/examples/hiera/modules/ntp/hiera.yaml +9 -0
  28. data/examples/hiera/modules/ntp/manifests/config.pp +18 -0
  29. data/examples/hiera/modules/ntp/templates/ntp.conf.epp +3 -0
  30. data/examples/hiera/modules/users/manifests/common.pp +9 -0
  31. data/examples/hiera/modules/users/manifests/dc1.pp +9 -0
  32. data/examples/hiera/site.pp +3 -0
  33. data/examples/nagios/check_puppet.rb +123 -0
  34. data/ext/README.md +13 -0
  35. data/ext/build_defaults.yaml +18 -0
  36. data/ext/debian/puppet.default +4 -0
  37. data/ext/debian/puppet.init +113 -0
  38. data/ext/hiera/hiera.yaml +15 -0
  39. data/ext/osx/puppet.plist +32 -0
  40. data/ext/project_data.yaml +20 -0
  41. data/ext/redhat/client.init +169 -0
  42. data/ext/redhat/client.sysconfig +2 -0
  43. data/ext/solaris/smf/puppet +44 -0
  44. data/ext/solaris/smf/puppet.xml +46 -0
  45. data/ext/suse/client.init +141 -0
  46. data/ext/systemd/puppet.service +26 -0
  47. data/ext/windows/puppet_interactive.bat +6 -0
  48. data/ext/windows/puppet_shell.bat +9 -0
  49. data/ext/windows/run_puppet_interactive.bat +9 -0
  50. data/ext/windows/service/daemon.bat +6 -0
  51. data/ext/windows/service/daemon.rb +219 -0
  52. data/install.rb +428 -0
  53. data/lib/hiera/puppet_function.rb +86 -0
  54. data/lib/hiera/scope.rb +92 -0
  55. data/lib/hiera_puppet.rb +78 -0
  56. data/lib/puppet/agent/disabler.rb +55 -0
  57. data/lib/puppet/agent/locker.rb +46 -0
  58. data/lib/puppet/agent.rb +178 -0
  59. data/lib/puppet/application/agent.rb +527 -0
  60. data/lib/puppet/application/apply.rb +435 -0
  61. data/lib/puppet/application/catalog.rb +6 -0
  62. data/lib/puppet/application/config.rb +7 -0
  63. data/lib/puppet/application/describe.rb +255 -0
  64. data/lib/puppet/application/device.rb +440 -0
  65. data/lib/puppet/application/doc.rb +232 -0
  66. data/lib/puppet/application/epp.rb +7 -0
  67. data/lib/puppet/application/face_base.rb +277 -0
  68. data/lib/puppet/application/facts.rb +11 -0
  69. data/lib/puppet/application/filebucket.rb +324 -0
  70. data/lib/puppet/application/generate.rb +7 -0
  71. data/lib/puppet/application/help.rb +7 -0
  72. data/lib/puppet/application/indirection_base.rb +6 -0
  73. data/lib/puppet/application/lookup.rb +433 -0
  74. data/lib/puppet/application/module.rb +6 -0
  75. data/lib/puppet/application/node.rb +6 -0
  76. data/lib/puppet/application/parser.rb +7 -0
  77. data/lib/puppet/application/plugin.rb +6 -0
  78. data/lib/puppet/application/report.rb +6 -0
  79. data/lib/puppet/application/resource.rb +264 -0
  80. data/lib/puppet/application/script.rb +266 -0
  81. data/lib/puppet/application/ssl.rb +331 -0
  82. data/lib/puppet/application.rb +596 -0
  83. data/lib/puppet/application_support.rb +69 -0
  84. data/lib/puppet/coercion.rb +42 -0
  85. data/lib/puppet/compilable_resource_type.rb +17 -0
  86. data/lib/puppet/concurrent/lock.rb +15 -0
  87. data/lib/puppet/concurrent/synchronized.rb +15 -0
  88. data/lib/puppet/concurrent/thread_local_singleton.rb +18 -0
  89. data/lib/puppet/concurrent.rb +4 -0
  90. data/lib/puppet/configurer/downloader.rb +91 -0
  91. data/lib/puppet/configurer/fact_handler.rb +51 -0
  92. data/lib/puppet/configurer/plugin_handler.rb +61 -0
  93. data/lib/puppet/configurer.rb +759 -0
  94. data/lib/puppet/confine/any.rb +28 -0
  95. data/lib/puppet/confine/boolean.rb +47 -0
  96. data/lib/puppet/confine/exists.rb +21 -0
  97. data/lib/puppet/confine/false.rb +27 -0
  98. data/lib/puppet/confine/feature.rb +18 -0
  99. data/lib/puppet/confine/true.rb +28 -0
  100. data/lib/puppet/confine/variable.rb +61 -0
  101. data/lib/puppet/confine.rb +86 -0
  102. data/lib/puppet/confine_collection.rb +54 -0
  103. data/lib/puppet/confiner.rb +48 -0
  104. data/lib/puppet/context/trusted_information.rb +122 -0
  105. data/lib/puppet/context.rb +190 -0
  106. data/lib/puppet/daemon.rb +198 -0
  107. data/lib/puppet/data_binding.rb +16 -0
  108. data/lib/puppet/datatypes/error.rb +23 -0
  109. data/lib/puppet/datatypes/impl/error.rb +42 -0
  110. data/lib/puppet/datatypes.rb +218 -0
  111. data/lib/puppet/defaults.rb +2316 -0
  112. data/lib/puppet/environments.rb +599 -0
  113. data/lib/puppet/error.rb +142 -0
  114. data/lib/puppet/etc.rb +185 -0
  115. data/lib/puppet/external/dot.rb +315 -0
  116. data/lib/puppet/face/catalog/select.rb +51 -0
  117. data/lib/puppet/face/catalog.rb +167 -0
  118. data/lib/puppet/face/config.rb +266 -0
  119. data/lib/puppet/face/epp.rb +565 -0
  120. data/lib/puppet/face/facts.rb +176 -0
  121. data/lib/puppet/face/generate.rb +69 -0
  122. data/lib/puppet/face/help/action.erb +89 -0
  123. data/lib/puppet/face/help/face.erb +114 -0
  124. data/lib/puppet/face/help/global.erb +16 -0
  125. data/lib/puppet/face/help/man.erb +152 -0
  126. data/lib/puppet/face/help.rb +260 -0
  127. data/lib/puppet/face/module/changes.rb +44 -0
  128. data/lib/puppet/face/module/install.rb +149 -0
  129. data/lib/puppet/face/module/list.rb +271 -0
  130. data/lib/puppet/face/module/uninstall.rb +91 -0
  131. data/lib/puppet/face/module/upgrade.rb +89 -0
  132. data/lib/puppet/face/module.rb +21 -0
  133. data/lib/puppet/face/node/clean.rb +109 -0
  134. data/lib/puppet/face/node.rb +45 -0
  135. data/lib/puppet/face/parser.rb +226 -0
  136. data/lib/puppet/face/plugin.rb +62 -0
  137. data/lib/puppet/face/report.rb +54 -0
  138. data/lib/puppet/face/resource.rb +55 -0
  139. data/lib/puppet/face.rb +14 -0
  140. data/lib/puppet/facter_impl.rb +96 -0
  141. data/lib/puppet/feature/base.rb +76 -0
  142. data/lib/puppet/feature/bolt.rb +5 -0
  143. data/lib/puppet/feature/cfpropertylist.rb +5 -0
  144. data/lib/puppet/feature/eventlog.rb +7 -0
  145. data/lib/puppet/feature/hiera_eyaml.rb +5 -0
  146. data/lib/puppet/feature/hocon.rb +5 -0
  147. data/lib/puppet/feature/libuser.rb +10 -0
  148. data/lib/puppet/feature/msgpack.rb +5 -0
  149. data/lib/puppet/feature/pe_license.rb +6 -0
  150. data/lib/puppet/feature/pson.rb +6 -0
  151. data/lib/puppet/feature/selinux.rb +5 -0
  152. data/lib/puppet/feature/ssh.rb +5 -0
  153. data/lib/puppet/feature/telnet.rb +5 -0
  154. data/lib/puppet/feature/zlib.rb +7 -0
  155. data/lib/puppet/ffi/posix/constants.rb +16 -0
  156. data/lib/puppet/ffi/posix/functions.rb +25 -0
  157. data/lib/puppet/ffi/posix.rb +12 -0
  158. data/lib/puppet/ffi/windows/api_types.rb +313 -0
  159. data/lib/puppet/ffi/windows/constants.rb +406 -0
  160. data/lib/puppet/ffi/windows/functions.rb +629 -0
  161. data/lib/puppet/ffi/windows/structs.rb +339 -0
  162. data/lib/puppet/ffi/windows.rb +14 -0
  163. data/lib/puppet/file_bucket/dipper.rb +183 -0
  164. data/lib/puppet/file_bucket/file.rb +131 -0
  165. data/lib/puppet/file_bucket.rb +6 -0
  166. data/lib/puppet/file_serving/base.rb +94 -0
  167. data/lib/puppet/file_serving/configuration/parser.rb +116 -0
  168. data/lib/puppet/file_serving/configuration.rb +116 -0
  169. data/lib/puppet/file_serving/content.rb +45 -0
  170. data/lib/puppet/file_serving/fileset.rb +190 -0
  171. data/lib/puppet/file_serving/http_metadata.rb +61 -0
  172. data/lib/puppet/file_serving/metadata.rb +174 -0
  173. data/lib/puppet/file_serving/mount/file.rb +126 -0
  174. data/lib/puppet/file_serving/mount/locales.rb +35 -0
  175. data/lib/puppet/file_serving/mount/modules.rb +29 -0
  176. data/lib/puppet/file_serving/mount/pluginfacts.rb +35 -0
  177. data/lib/puppet/file_serving/mount/plugins.rb +35 -0
  178. data/lib/puppet/file_serving/mount/scripts.rb +27 -0
  179. data/lib/puppet/file_serving/mount/tasks.rb +26 -0
  180. data/lib/puppet/file_serving/mount.rb +41 -0
  181. data/lib/puppet/file_serving/terminus_helper.rb +33 -0
  182. data/lib/puppet/file_serving/terminus_selector.rb +33 -0
  183. data/lib/puppet/file_serving.rb +5 -0
  184. data/lib/puppet/file_system/file_impl.rb +189 -0
  185. data/lib/puppet/file_system/jruby.rb +25 -0
  186. data/lib/puppet/file_system/memory_file.rb +82 -0
  187. data/lib/puppet/file_system/memory_impl.rb +103 -0
  188. data/lib/puppet/file_system/path_pattern.rb +95 -0
  189. data/lib/puppet/file_system/posix.rb +52 -0
  190. data/lib/puppet/file_system/uniquefile.rb +190 -0
  191. data/lib/puppet/file_system/windows.rb +224 -0
  192. data/lib/puppet/file_system.rb +421 -0
  193. data/lib/puppet/forge/cache.rb +61 -0
  194. data/lib/puppet/forge/errors.rb +113 -0
  195. data/lib/puppet/forge/repository.rb +98 -0
  196. data/lib/puppet/forge.rb +257 -0
  197. data/lib/puppet/functions/abs.rb +64 -0
  198. data/lib/puppet/functions/alert.rb +16 -0
  199. data/lib/puppet/functions/all.rb +106 -0
  200. data/lib/puppet/functions/annotate.rb +110 -0
  201. data/lib/puppet/functions/any.rb +111 -0
  202. data/lib/puppet/functions/assert_type.rb +96 -0
  203. data/lib/puppet/functions/binary_file.rb +35 -0
  204. data/lib/puppet/functions/break.rb +49 -0
  205. data/lib/puppet/functions/call.rb +81 -0
  206. data/lib/puppet/functions/camelcase.rb +63 -0
  207. data/lib/puppet/functions/capitalize.rb +62 -0
  208. data/lib/puppet/functions/ceiling.rb +38 -0
  209. data/lib/puppet/functions/chomp.rb +58 -0
  210. data/lib/puppet/functions/chop.rb +68 -0
  211. data/lib/puppet/functions/compare.rb +127 -0
  212. data/lib/puppet/functions/contain.rb +58 -0
  213. data/lib/puppet/functions/convert_to.rb +36 -0
  214. data/lib/puppet/functions/crit.rb +16 -0
  215. data/lib/puppet/functions/debug.rb +16 -0
  216. data/lib/puppet/functions/defined.rb +163 -0
  217. data/lib/puppet/functions/dig.rb +70 -0
  218. data/lib/puppet/functions/downcase.rb +91 -0
  219. data/lib/puppet/functions/each.rb +169 -0
  220. data/lib/puppet/functions/emerg.rb +16 -0
  221. data/lib/puppet/functions/empty.rb +87 -0
  222. data/lib/puppet/functions/epp.rb +50 -0
  223. data/lib/puppet/functions/err.rb +16 -0
  224. data/lib/puppet/functions/eyaml_lookup_key.rb +103 -0
  225. data/lib/puppet/functions/filter.rb +138 -0
  226. data/lib/puppet/functions/find_file.rb +50 -0
  227. data/lib/puppet/functions/find_template.rb +65 -0
  228. data/lib/puppet/functions/flatten.rb +66 -0
  229. data/lib/puppet/functions/floor.rb +38 -0
  230. data/lib/puppet/functions/get.rb +152 -0
  231. data/lib/puppet/functions/getvar.rb +89 -0
  232. data/lib/puppet/functions/group_by.rb +62 -0
  233. data/lib/puppet/functions/hiera.rb +91 -0
  234. data/lib/puppet/functions/hiera_array.rb +83 -0
  235. data/lib/puppet/functions/hiera_hash.rb +94 -0
  236. data/lib/puppet/functions/hiera_include.rb +107 -0
  237. data/lib/puppet/functions/hocon_data.rb +41 -0
  238. data/lib/puppet/functions/import.rb +9 -0
  239. data/lib/puppet/functions/include.rb +56 -0
  240. data/lib/puppet/functions/index.rb +168 -0
  241. data/lib/puppet/functions/info.rb +16 -0
  242. data/lib/puppet/functions/inline_epp.rb +61 -0
  243. data/lib/puppet/functions/join.rb +58 -0
  244. data/lib/puppet/functions/json_data.rb +33 -0
  245. data/lib/puppet/functions/keys.rb +27 -0
  246. data/lib/puppet/functions/length.rb +45 -0
  247. data/lib/puppet/functions/lest.rb +57 -0
  248. data/lib/puppet/functions/lookup.rb +224 -0
  249. data/lib/puppet/functions/lstrip.rb +59 -0
  250. data/lib/puppet/functions/map.rb +137 -0
  251. data/lib/puppet/functions/match.rb +133 -0
  252. data/lib/puppet/functions/max.rb +250 -0
  253. data/lib/puppet/functions/min.rb +249 -0
  254. data/lib/puppet/functions/module_directory.rb +43 -0
  255. data/lib/puppet/functions/new.rb +1013 -0
  256. data/lib/puppet/functions/next.rb +35 -0
  257. data/lib/puppet/functions/notice.rb +16 -0
  258. data/lib/puppet/functions/partition.rb +62 -0
  259. data/lib/puppet/functions/reduce.rb +159 -0
  260. data/lib/puppet/functions/regsubst.rb +100 -0
  261. data/lib/puppet/functions/require.rb +81 -0
  262. data/lib/puppet/functions/return.rb +17 -0
  263. data/lib/puppet/functions/reverse_each.rb +96 -0
  264. data/lib/puppet/functions/round.rb +26 -0
  265. data/lib/puppet/functions/rstrip.rb +59 -0
  266. data/lib/puppet/functions/scanf.rb +46 -0
  267. data/lib/puppet/functions/size.rb +15 -0
  268. data/lib/puppet/functions/slice.rb +127 -0
  269. data/lib/puppet/functions/sort.rb +76 -0
  270. data/lib/puppet/functions/split.rb +78 -0
  271. data/lib/puppet/functions/step.rb +100 -0
  272. data/lib/puppet/functions/strftime.rb +214 -0
  273. data/lib/puppet/functions/strip.rb +59 -0
  274. data/lib/puppet/functions/then.rb +80 -0
  275. data/lib/puppet/functions/tree_each.rb +198 -0
  276. data/lib/puppet/functions/type.rb +74 -0
  277. data/lib/puppet/functions/unique.rb +135 -0
  278. data/lib/puppet/functions/unwrap.rb +61 -0
  279. data/lib/puppet/functions/upcase.rb +91 -0
  280. data/lib/puppet/functions/values.rb +27 -0
  281. data/lib/puppet/functions/versioncmp.rb +41 -0
  282. data/lib/puppet/functions/warning.rb +16 -0
  283. data/lib/puppet/functions/with.rb +34 -0
  284. data/lib/puppet/functions/yaml_data.rb +45 -0
  285. data/lib/puppet/functions.rb +858 -0
  286. data/lib/puppet/generate/models/type/property.rb +73 -0
  287. data/lib/puppet/generate/models/type/type.rb +68 -0
  288. data/lib/puppet/generate/templates/type/pcore.erb +42 -0
  289. data/lib/puppet/generate/type.rb +255 -0
  290. data/lib/puppet/gettext/config.rb +282 -0
  291. data/lib/puppet/gettext/module_translations.rb +43 -0
  292. data/lib/puppet/gettext/stubs.rb +13 -0
  293. data/lib/puppet/graph/key.rb +28 -0
  294. data/lib/puppet/graph/prioritizer.rb +31 -0
  295. data/lib/puppet/graph/rb_tree_map.rb +407 -0
  296. data/lib/puppet/graph/relationship_graph.rb +286 -0
  297. data/lib/puppet/graph/sequential_prioritizer.rb +33 -0
  298. data/lib/puppet/graph/simple_graph.rb +552 -0
  299. data/lib/puppet/graph.rb +11 -0
  300. data/lib/puppet/http/client.rb +529 -0
  301. data/lib/puppet/http/dns.rb +159 -0
  302. data/lib/puppet/http/errors.rb +50 -0
  303. data/lib/puppet/http/external_client.rb +89 -0
  304. data/lib/puppet/http/factory.rb +53 -0
  305. data/lib/puppet/http/pool.rb +174 -0
  306. data/lib/puppet/http/pool_entry.rb +19 -0
  307. data/lib/puppet/http/proxy.rb +139 -0
  308. data/lib/puppet/http/redirector.rb +87 -0
  309. data/lib/puppet/http/resolver/server_list.rb +88 -0
  310. data/lib/puppet/http/resolver/settings.rb +24 -0
  311. data/lib/puppet/http/resolver/srv.rb +42 -0
  312. data/lib/puppet/http/resolver.rb +50 -0
  313. data/lib/puppet/http/response.rb +104 -0
  314. data/lib/puppet/http/response_converter.rb +25 -0
  315. data/lib/puppet/http/response_net_http.rb +43 -0
  316. data/lib/puppet/http/retry_after_handler.rb +78 -0
  317. data/lib/puppet/http/service/ca.rb +133 -0
  318. data/lib/puppet/http/service/compiler.rb +356 -0
  319. data/lib/puppet/http/service/file_server.rb +200 -0
  320. data/lib/puppet/http/service/puppetserver.rb +54 -0
  321. data/lib/puppet/http/service/report.rb +62 -0
  322. data/lib/puppet/http/service.rb +177 -0
  323. data/lib/puppet/http/session.rb +124 -0
  324. data/lib/puppet/http/site.rb +44 -0
  325. data/lib/puppet/http.rb +48 -0
  326. data/lib/puppet/indirector/catalog/compiler.rb +432 -0
  327. data/lib/puppet/indirector/catalog/json.rb +42 -0
  328. data/lib/puppet/indirector/catalog/msgpack.rb +8 -0
  329. data/lib/puppet/indirector/catalog/rest.rb +51 -0
  330. data/lib/puppet/indirector/catalog/store_configs.rb +8 -0
  331. data/lib/puppet/indirector/catalog/yaml.rb +8 -0
  332. data/lib/puppet/indirector/code.rb +8 -0
  333. data/lib/puppet/indirector/data_binding/hiera.rb +8 -0
  334. data/lib/puppet/indirector/data_binding/none.rb +10 -0
  335. data/lib/puppet/indirector/direct_file_server.rb +20 -0
  336. data/lib/puppet/indirector/envelope.rb +13 -0
  337. data/lib/puppet/indirector/errors.rb +7 -0
  338. data/lib/puppet/indirector/exec.rb +40 -0
  339. data/lib/puppet/indirector/face.rb +142 -0
  340. data/lib/puppet/indirector/fact_search.rb +62 -0
  341. data/lib/puppet/indirector/facts/facter.rb +120 -0
  342. data/lib/puppet/indirector/facts/json.rb +29 -0
  343. data/lib/puppet/indirector/facts/memory.rb +11 -0
  344. data/lib/puppet/indirector/facts/network_device.rb +29 -0
  345. data/lib/puppet/indirector/facts/rest.rb +46 -0
  346. data/lib/puppet/indirector/facts/store_configs.rb +12 -0
  347. data/lib/puppet/indirector/facts/yaml.rb +31 -0
  348. data/lib/puppet/indirector/file_bucket_file/file.rb +268 -0
  349. data/lib/puppet/indirector/file_bucket_file/rest.rb +53 -0
  350. data/lib/puppet/indirector/file_bucket_file/selector.rb +54 -0
  351. data/lib/puppet/indirector/file_content/file.rb +9 -0
  352. data/lib/puppet/indirector/file_content/file_server.rb +9 -0
  353. data/lib/puppet/indirector/file_content/rest.rb +37 -0
  354. data/lib/puppet/indirector/file_content/selector.rb +32 -0
  355. data/lib/puppet/indirector/file_content.rb +7 -0
  356. data/lib/puppet/indirector/file_metadata/file.rb +9 -0
  357. data/lib/puppet/indirector/file_metadata/file_server.rb +9 -0
  358. data/lib/puppet/indirector/file_metadata/http.rb +49 -0
  359. data/lib/puppet/indirector/file_metadata/rest.rb +58 -0
  360. data/lib/puppet/indirector/file_metadata/selector.rb +32 -0
  361. data/lib/puppet/indirector/file_metadata.rb +7 -0
  362. data/lib/puppet/indirector/file_server.rb +57 -0
  363. data/lib/puppet/indirector/generic_http.rb +7 -0
  364. data/lib/puppet/indirector/hiera.rb +101 -0
  365. data/lib/puppet/indirector/indirection.rb +381 -0
  366. data/lib/puppet/indirector/json.rb +82 -0
  367. data/lib/puppet/indirector/memory.rb +37 -0
  368. data/lib/puppet/indirector/msgpack.rb +87 -0
  369. data/lib/puppet/indirector/node/exec.rb +70 -0
  370. data/lib/puppet/indirector/node/json.rb +9 -0
  371. data/lib/puppet/indirector/node/memory.rb +12 -0
  372. data/lib/puppet/indirector/node/msgpack.rb +9 -0
  373. data/lib/puppet/indirector/node/plain.rb +23 -0
  374. data/lib/puppet/indirector/node/rest.rb +31 -0
  375. data/lib/puppet/indirector/node/store_configs.rb +8 -0
  376. data/lib/puppet/indirector/node/yaml.rb +9 -0
  377. data/lib/puppet/indirector/none.rb +10 -0
  378. data/lib/puppet/indirector/plain.rb +11 -0
  379. data/lib/puppet/indirector/report/json.rb +36 -0
  380. data/lib/puppet/indirector/report/msgpack.rb +13 -0
  381. data/lib/puppet/indirector/report/processor.rb +63 -0
  382. data/lib/puppet/indirector/report/rest.rb +31 -0
  383. data/lib/puppet/indirector/report/yaml.rb +36 -0
  384. data/lib/puppet/indirector/request.rb +197 -0
  385. data/lib/puppet/indirector/resource/ral.rb +66 -0
  386. data/lib/puppet/indirector/resource/store_configs.rb +14 -0
  387. data/lib/puppet/indirector/resource/validator.rb +10 -0
  388. data/lib/puppet/indirector/rest.rb +66 -0
  389. data/lib/puppet/indirector/store_configs.rb +32 -0
  390. data/lib/puppet/indirector/terminus.rb +180 -0
  391. data/lib/puppet/indirector/yaml.rb +65 -0
  392. data/lib/puppet/indirector.rb +64 -0
  393. data/lib/puppet/info_service/class_information_service.rb +108 -0
  394. data/lib/puppet/info_service/plan_information_service.rb +38 -0
  395. data/lib/puppet/info_service/task_information_service.rb +45 -0
  396. data/lib/puppet/info_service.rb +27 -0
  397. data/lib/puppet/interface/action.rb +410 -0
  398. data/lib/puppet/interface/action_builder.rb +167 -0
  399. data/lib/puppet/interface/action_manager.rb +101 -0
  400. data/lib/puppet/interface/documentation.rb +363 -0
  401. data/lib/puppet/interface/face_collection.rb +141 -0
  402. data/lib/puppet/interface/option.rb +184 -0
  403. data/lib/puppet/interface/option_builder.rb +110 -0
  404. data/lib/puppet/interface/option_manager.rb +108 -0
  405. data/lib/puppet/interface.rb +240 -0
  406. data/lib/puppet/loaders.rb +31 -0
  407. data/lib/puppet/metatype/manager.rb +198 -0
  408. data/lib/puppet/module/plan.rb +166 -0
  409. data/lib/puppet/module/task.rb +288 -0
  410. data/lib/puppet/module.rb +487 -0
  411. data/lib/puppet/module_tool/applications/application.rb +96 -0
  412. data/lib/puppet/module_tool/applications/checksummer.rb +62 -0
  413. data/lib/puppet/module_tool/applications/installer.rb +402 -0
  414. data/lib/puppet/module_tool/applications/uninstaller.rb +121 -0
  415. data/lib/puppet/module_tool/applications/unpacker.rb +102 -0
  416. data/lib/puppet/module_tool/applications/upgrader.rb +288 -0
  417. data/lib/puppet/module_tool/applications.rb +14 -0
  418. data/lib/puppet/module_tool/checksums.rb +50 -0
  419. data/lib/puppet/module_tool/dependency.rb +42 -0
  420. data/lib/puppet/module_tool/errors/base.rb +17 -0
  421. data/lib/puppet/module_tool/errors/installer.rb +94 -0
  422. data/lib/puppet/module_tool/errors/shared.rb +228 -0
  423. data/lib/puppet/module_tool/errors/uninstaller.rb +51 -0
  424. data/lib/puppet/module_tool/errors/upgrader.rb +64 -0
  425. data/lib/puppet/module_tool/errors.rb +13 -0
  426. data/lib/puppet/module_tool/install_directory.rb +48 -0
  427. data/lib/puppet/module_tool/installed_modules.rb +99 -0
  428. data/lib/puppet/module_tool/local_tarball.rb +92 -0
  429. data/lib/puppet/module_tool/metadata.rb +227 -0
  430. data/lib/puppet/module_tool/shared_behaviors.rb +199 -0
  431. data/lib/puppet/module_tool/tar/gnu.rb +23 -0
  432. data/lib/puppet/module_tool/tar/mini.rb +118 -0
  433. data/lib/puppet/module_tool/tar.rb +20 -0
  434. data/lib/puppet/module_tool.rb +194 -0
  435. data/lib/puppet/network/authconfig.rb +9 -0
  436. data/lib/puppet/network/authorization.rb +21 -0
  437. data/lib/puppet/network/client_request.rb +32 -0
  438. data/lib/puppet/network/format.rb +116 -0
  439. data/lib/puppet/network/format_handler.rb +110 -0
  440. data/lib/puppet/network/format_support.rb +140 -0
  441. data/lib/puppet/network/formats.rb +338 -0
  442. data/lib/puppet/network/http/api/indirected_routes.rb +270 -0
  443. data/lib/puppet/network/http/api/indirection_type.rb +33 -0
  444. data/lib/puppet/network/http/api/master/v3/environments.rb +4 -0
  445. data/lib/puppet/network/http/api/master/v3.rb +4 -0
  446. data/lib/puppet/network/http/api/master.rb +5 -0
  447. data/lib/puppet/network/http/api/server/v3/environments.rb +54 -0
  448. data/lib/puppet/network/http/api/server/v3.rb +40 -0
  449. data/lib/puppet/network/http/api/server.rb +12 -0
  450. data/lib/puppet/network/http/api.rb +41 -0
  451. data/lib/puppet/network/http/connection.rb +288 -0
  452. data/lib/puppet/network/http/error.rb +75 -0
  453. data/lib/puppet/network/http/handler.rb +213 -0
  454. data/lib/puppet/network/http/issues.rb +14 -0
  455. data/lib/puppet/network/http/memory_response.rb +15 -0
  456. data/lib/puppet/network/http/request.rb +83 -0
  457. data/lib/puppet/network/http/response.rb +25 -0
  458. data/lib/puppet/network/http/route.rb +104 -0
  459. data/lib/puppet/network/http.rb +30 -0
  460. data/lib/puppet/network/http_pool.rb +78 -0
  461. data/lib/puppet/network/uri.rb +20 -0
  462. data/lib/puppet/network.rb +5 -0
  463. data/lib/puppet/node/environment.rb +638 -0
  464. data/lib/puppet/node/facts.rb +165 -0
  465. data/lib/puppet/node/server_facts.rb +46 -0
  466. data/lib/puppet/node.rb +256 -0
  467. data/lib/puppet/pal/catalog_compiler.rb +107 -0
  468. data/lib/puppet/pal/compiler.rb +227 -0
  469. data/lib/puppet/pal/function_signature.rb +54 -0
  470. data/lib/puppet/pal/json_catalog_encoder.rb +76 -0
  471. data/lib/puppet/pal/pal_api.rb +17 -0
  472. data/lib/puppet/pal/pal_impl.rb +585 -0
  473. data/lib/puppet/pal/plan_signature.rb +73 -0
  474. data/lib/puppet/pal/script_compiler.rb +75 -0
  475. data/lib/puppet/pal/task_signature.rb +64 -0
  476. data/lib/puppet/parameter/boolean.rb +17 -0
  477. data/lib/puppet/parameter/package_options.rb +33 -0
  478. data/lib/puppet/parameter/path.rb +61 -0
  479. data/lib/puppet/parameter/value.rb +93 -0
  480. data/lib/puppet/parameter/value_collection.rb +213 -0
  481. data/lib/puppet/parameter.rb +590 -0
  482. data/lib/puppet/parser/abstract_compiler.rb +35 -0
  483. data/lib/puppet/parser/ast/block_expression.rb +17 -0
  484. data/lib/puppet/parser/ast/branch.rb +21 -0
  485. data/lib/puppet/parser/ast/hostclass.rb +29 -0
  486. data/lib/puppet/parser/ast/leaf.rb +84 -0
  487. data/lib/puppet/parser/ast/node.rb +19 -0
  488. data/lib/puppet/parser/ast/pops_bridge.rb +245 -0
  489. data/lib/puppet/parser/ast/resource.rb +66 -0
  490. data/lib/puppet/parser/ast/resource_instance.rb +13 -0
  491. data/lib/puppet/parser/ast/resourceparam.rb +33 -0
  492. data/lib/puppet/parser/ast/top_level_construct.rb +6 -0
  493. data/lib/puppet/parser/ast.rb +62 -0
  494. data/lib/puppet/parser/catalog_compiler.rb +56 -0
  495. data/lib/puppet/parser/compiler/catalog_validator/relationship_validator.rb +41 -0
  496. data/lib/puppet/parser/compiler/catalog_validator.rb +35 -0
  497. data/lib/puppet/parser/compiler.rb +616 -0
  498. data/lib/puppet/parser/e4_parser_adapter.rb +61 -0
  499. data/lib/puppet/parser/files.rb +95 -0
  500. data/lib/puppet/parser/functions/assert_type.rb +62 -0
  501. data/lib/puppet/parser/functions/binary_file.rb +26 -0
  502. data/lib/puppet/parser/functions/break.rb +41 -0
  503. data/lib/puppet/parser/functions/contain.rb +32 -0
  504. data/lib/puppet/parser/functions/create_resources.rb +114 -0
  505. data/lib/puppet/parser/functions/defined.rb +109 -0
  506. data/lib/puppet/parser/functions/dig.rb +40 -0
  507. data/lib/puppet/parser/functions/digest.rb +7 -0
  508. data/lib/puppet/parser/functions/each.rb +106 -0
  509. data/lib/puppet/parser/functions/epp.rb +40 -0
  510. data/lib/puppet/parser/functions/fail.rb +13 -0
  511. data/lib/puppet/parser/functions/file.rb +35 -0
  512. data/lib/puppet/parser/functions/filter.rb +81 -0
  513. data/lib/puppet/parser/functions/find_file.rb +29 -0
  514. data/lib/puppet/parser/functions/fqdn_rand.rb +46 -0
  515. data/lib/puppet/parser/functions/generate.rb +39 -0
  516. data/lib/puppet/parser/functions/hiera.rb +105 -0
  517. data/lib/puppet/parser/functions/hiera_array.rb +93 -0
  518. data/lib/puppet/parser/functions/hiera_hash.rb +103 -0
  519. data/lib/puppet/parser/functions/hiera_include.rb +102 -0
  520. data/lib/puppet/parser/functions/include.rb +36 -0
  521. data/lib/puppet/parser/functions/inline_epp.rb +52 -0
  522. data/lib/puppet/parser/functions/inline_template.rb +28 -0
  523. data/lib/puppet/parser/functions/lest.rb +51 -0
  524. data/lib/puppet/parser/functions/lookup.rb +134 -0
  525. data/lib/puppet/parser/functions/map.rb +78 -0
  526. data/lib/puppet/parser/functions/match.rb +45 -0
  527. data/lib/puppet/parser/functions/md5.rb +7 -0
  528. data/lib/puppet/parser/functions/new.rb +992 -0
  529. data/lib/puppet/parser/functions/next.rb +40 -0
  530. data/lib/puppet/parser/functions/realize.rb +22 -0
  531. data/lib/puppet/parser/functions/reduce.rb +139 -0
  532. data/lib/puppet/parser/functions/regsubst.rb +65 -0
  533. data/lib/puppet/parser/functions/require.rb +43 -0
  534. data/lib/puppet/parser/functions/return.rb +94 -0
  535. data/lib/puppet/parser/functions/reverse_each.rb +85 -0
  536. data/lib/puppet/parser/functions/scanf.rb +40 -0
  537. data/lib/puppet/parser/functions/sha1.rb +7 -0
  538. data/lib/puppet/parser/functions/sha256.rb +7 -0
  539. data/lib/puppet/parser/functions/shellquote.rb +63 -0
  540. data/lib/puppet/parser/functions/slice.rb +41 -0
  541. data/lib/puppet/parser/functions/split.rb +29 -0
  542. data/lib/puppet/parser/functions/sprintf.rb +62 -0
  543. data/lib/puppet/parser/functions/step.rb +86 -0
  544. data/lib/puppet/parser/functions/strftime.rb +187 -0
  545. data/lib/puppet/parser/functions/tag.rb +15 -0
  546. data/lib/puppet/parser/functions/tagged.rb +24 -0
  547. data/lib/puppet/parser/functions/template.rb +42 -0
  548. data/lib/puppet/parser/functions/then.rb +75 -0
  549. data/lib/puppet/parser/functions/type.rb +55 -0
  550. data/lib/puppet/parser/functions/versioncmp.rb +31 -0
  551. data/lib/puppet/parser/functions/with.rb +30 -0
  552. data/lib/puppet/parser/functions.rb +324 -0
  553. data/lib/puppet/parser/parser_factory.rb +32 -0
  554. data/lib/puppet/parser/relationship.rb +90 -0
  555. data/lib/puppet/parser/resource/param.rb +37 -0
  556. data/lib/puppet/parser/resource.rb +353 -0
  557. data/lib/puppet/parser/scope.rb +1141 -0
  558. data/lib/puppet/parser/script_compiler.rb +123 -0
  559. data/lib/puppet/parser/templatewrapper.rb +105 -0
  560. data/lib/puppet/parser/type_loader.rb +151 -0
  561. data/lib/puppet/parser.rb +22 -0
  562. data/lib/puppet/plugins/configuration.rb +31 -0
  563. data/lib/puppet/plugins/syntax_checkers.rb +99 -0
  564. data/lib/puppet/plugins.rb +11 -0
  565. data/lib/puppet/pops/adaptable.rb +199 -0
  566. data/lib/puppet/pops/adapters.rb +159 -0
  567. data/lib/puppet/pops/evaluator/access_operator.rb +732 -0
  568. data/lib/puppet/pops/evaluator/callable_signature.rb +108 -0
  569. data/lib/puppet/pops/evaluator/closure.rb +370 -0
  570. data/lib/puppet/pops/evaluator/collector_transformer.rb +237 -0
  571. data/lib/puppet/pops/evaluator/collectors/abstract_collector.rb +88 -0
  572. data/lib/puppet/pops/evaluator/collectors/catalog_collector.rb +30 -0
  573. data/lib/puppet/pops/evaluator/collectors/exported_collector.rb +71 -0
  574. data/lib/puppet/pops/evaluator/collectors/fixed_set_collector.rb +38 -0
  575. data/lib/puppet/pops/evaluator/compare_operator.rb +269 -0
  576. data/lib/puppet/pops/evaluator/deferred_resolver.rb +227 -0
  577. data/lib/puppet/pops/evaluator/epp_evaluator.rb +121 -0
  578. data/lib/puppet/pops/evaluator/evaluator_impl.rb +1317 -0
  579. data/lib/puppet/pops/evaluator/external_syntax_support.rb +47 -0
  580. data/lib/puppet/pops/evaluator/json_strict_literal_evaluator.rb +83 -0
  581. data/lib/puppet/pops/evaluator/literal_evaluator.rb +100 -0
  582. data/lib/puppet/pops/evaluator/puppet_proc.rb +72 -0
  583. data/lib/puppet/pops/evaluator/relationship_operator.rb +188 -0
  584. data/lib/puppet/pops/evaluator/runtime3_converter.rb +225 -0
  585. data/lib/puppet/pops/evaluator/runtime3_resource_support.rb +119 -0
  586. data/lib/puppet/pops/evaluator/runtime3_support.rb +528 -0
  587. data/lib/puppet/pops/functions/dispatch.rb +107 -0
  588. data/lib/puppet/pops/functions/dispatcher.rb +76 -0
  589. data/lib/puppet/pops/functions/function.rb +137 -0
  590. data/lib/puppet/pops/issue_reporter.rb +140 -0
  591. data/lib/puppet/pops/issues.rb +933 -0
  592. data/lib/puppet/pops/label_provider.rb +92 -0
  593. data/lib/puppet/pops/loader/base_loader.rb +178 -0
  594. data/lib/puppet/pops/loader/dependency_loader.rb +95 -0
  595. data/lib/puppet/pops/loader/gem_support.rb +54 -0
  596. data/lib/puppet/pops/loader/generic_plan_instantiator.rb +30 -0
  597. data/lib/puppet/pops/loader/loader.rb +221 -0
  598. data/lib/puppet/pops/loader/loader_paths.rb +413 -0
  599. data/lib/puppet/pops/loader/module_loaders.rb +552 -0
  600. data/lib/puppet/pops/loader/predefined_loader.rb +28 -0
  601. data/lib/puppet/pops/loader/puppet_function_instantiator.rb +88 -0
  602. data/lib/puppet/pops/loader/puppet_plan_instantiator.rb +97 -0
  603. data/lib/puppet/pops/loader/puppet_resource_type_impl_instantiator.rb +80 -0
  604. data/lib/puppet/pops/loader/ruby_data_type_instantiator.rb +43 -0
  605. data/lib/puppet/pops/loader/ruby_function_instantiator.rb +49 -0
  606. data/lib/puppet/pops/loader/ruby_legacy_function_instantiator.rb +130 -0
  607. data/lib/puppet/pops/loader/runtime3_type_loader.rb +104 -0
  608. data/lib/puppet/pops/loader/simple_environment_loader.rb +20 -0
  609. data/lib/puppet/pops/loader/static_loader.rb +133 -0
  610. data/lib/puppet/pops/loader/task_instantiator.rb +46 -0
  611. data/lib/puppet/pops/loader/type_definition_instantiator.rb +104 -0
  612. data/lib/puppet/pops/loader/typed_name.rb +56 -0
  613. data/lib/puppet/pops/loader/uri_helper.rb +24 -0
  614. data/lib/puppet/pops/loaders.rb +550 -0
  615. data/lib/puppet/pops/lookup/configured_data_provider.rb +95 -0
  616. data/lib/puppet/pops/lookup/context.rb +208 -0
  617. data/lib/puppet/pops/lookup/data_adapter.rb +29 -0
  618. data/lib/puppet/pops/lookup/data_dig_function_provider.rb +146 -0
  619. data/lib/puppet/pops/lookup/data_hash_function_provider.rb +128 -0
  620. data/lib/puppet/pops/lookup/data_provider.rb +94 -0
  621. data/lib/puppet/pops/lookup/environment_data_provider.rb +37 -0
  622. data/lib/puppet/pops/lookup/explainer.rb +597 -0
  623. data/lib/puppet/pops/lookup/function_provider.rb +112 -0
  624. data/lib/puppet/pops/lookup/global_data_provider.rb +76 -0
  625. data/lib/puppet/pops/lookup/hiera_config.rb +823 -0
  626. data/lib/puppet/pops/lookup/interpolation.rb +166 -0
  627. data/lib/puppet/pops/lookup/invocation.rb +272 -0
  628. data/lib/puppet/pops/lookup/key_recorder.rb +21 -0
  629. data/lib/puppet/pops/lookup/location_resolver.rb +101 -0
  630. data/lib/puppet/pops/lookup/lookup_adapter.rb +533 -0
  631. data/lib/puppet/pops/lookup/lookup_key.rb +101 -0
  632. data/lib/puppet/pops/lookup/lookup_key_function_provider.rb +94 -0
  633. data/lib/puppet/pops/lookup/module_data_provider.rb +92 -0
  634. data/lib/puppet/pops/lookup/sub_lookup.rb +96 -0
  635. data/lib/puppet/pops/lookup.rb +102 -0
  636. data/lib/puppet/pops/merge_strategy.rb +447 -0
  637. data/lib/puppet/pops/migration/migration_checker.rb +61 -0
  638. data/lib/puppet/pops/model/ast.pp +669 -0
  639. data/lib/puppet/pops/model/ast.rb +4776 -0
  640. data/lib/puppet/pops/model/ast_transformer.rb +131 -0
  641. data/lib/puppet/pops/model/factory.rb +1157 -0
  642. data/lib/puppet/pops/model/model_label_provider.rb +137 -0
  643. data/lib/puppet/pops/model/model_tree_dumper.rb +447 -0
  644. data/lib/puppet/pops/model/pn_transformer.rb +384 -0
  645. data/lib/puppet/pops/model/tree_dumper.rb +62 -0
  646. data/lib/puppet/pops/parser/code_merger.rb +29 -0
  647. data/lib/puppet/pops/parser/egrammar.ra +889 -0
  648. data/lib/puppet/pops/parser/eparser.rb +3184 -0
  649. data/lib/puppet/pops/parser/epp_parser.rb +52 -0
  650. data/lib/puppet/pops/parser/epp_support.rb +266 -0
  651. data/lib/puppet/pops/parser/evaluating_parser.rb +166 -0
  652. data/lib/puppet/pops/parser/heredoc_support.rb +153 -0
  653. data/lib/puppet/pops/parser/interpolation_support.rb +249 -0
  654. data/lib/puppet/pops/parser/lexer2.rb +789 -0
  655. data/lib/puppet/pops/parser/lexer_support.rb +221 -0
  656. data/lib/puppet/pops/parser/locatable.rb +23 -0
  657. data/lib/puppet/pops/parser/locator.rb +361 -0
  658. data/lib/puppet/pops/parser/parser_support.rb +252 -0
  659. data/lib/puppet/pops/parser/pn_parser.rb +318 -0
  660. data/lib/puppet/pops/parser/slurp_support.rb +119 -0
  661. data/lib/puppet/pops/patterns.rb +60 -0
  662. data/lib/puppet/pops/pcore.rb +136 -0
  663. data/lib/puppet/pops/pn.rb +239 -0
  664. data/lib/puppet/pops/puppet_stack.rb +63 -0
  665. data/lib/puppet/pops/resource/param.rb +56 -0
  666. data/lib/puppet/pops/resource/resource_type_impl.rb +296 -0
  667. data/lib/puppet/pops/resource/resource_type_set.pcore +22 -0
  668. data/lib/puppet/pops/semantic_error.rb +31 -0
  669. data/lib/puppet/pops/serialization/abstract_reader.rb +182 -0
  670. data/lib/puppet/pops/serialization/abstract_writer.rb +224 -0
  671. data/lib/puppet/pops/serialization/deserializer.rb +83 -0
  672. data/lib/puppet/pops/serialization/extension.rb +166 -0
  673. data/lib/puppet/pops/serialization/from_data_converter.rb +231 -0
  674. data/lib/puppet/pops/serialization/instance_reader.rb +21 -0
  675. data/lib/puppet/pops/serialization/instance_writer.rb +16 -0
  676. data/lib/puppet/pops/serialization/json.rb +301 -0
  677. data/lib/puppet/pops/serialization/json_path.rb +129 -0
  678. data/lib/puppet/pops/serialization/object.rb +73 -0
  679. data/lib/puppet/pops/serialization/serializer.rb +144 -0
  680. data/lib/puppet/pops/serialization/time_factory.rb +68 -0
  681. data/lib/puppet/pops/serialization/to_data_converter.rb +316 -0
  682. data/lib/puppet/pops/serialization/to_stringified_converter.rb +227 -0
  683. data/lib/puppet/pops/serialization.rb +45 -0
  684. data/lib/puppet/pops/time/timespan.rb +728 -0
  685. data/lib/puppet/pops/time/timestamp.rb +167 -0
  686. data/lib/puppet/pops/types/annotatable.rb +37 -0
  687. data/lib/puppet/pops/types/annotation.rb +73 -0
  688. data/lib/puppet/pops/types/class_loader.rb +134 -0
  689. data/lib/puppet/pops/types/implementation_registry.rb +137 -0
  690. data/lib/puppet/pops/types/iterable.rb +375 -0
  691. data/lib/puppet/pops/types/p_binary_type.rb +232 -0
  692. data/lib/puppet/pops/types/p_init_type.rb +241 -0
  693. data/lib/puppet/pops/types/p_meta_type.rb +95 -0
  694. data/lib/puppet/pops/types/p_object_type.rb +1142 -0
  695. data/lib/puppet/pops/types/p_object_type_extension.rb +229 -0
  696. data/lib/puppet/pops/types/p_runtime_type.rb +117 -0
  697. data/lib/puppet/pops/types/p_sem_ver_range_type.rb +191 -0
  698. data/lib/puppet/pops/types/p_sem_ver_type.rb +155 -0
  699. data/lib/puppet/pops/types/p_sensitive_type.rb +81 -0
  700. data/lib/puppet/pops/types/p_timespan_type.rb +194 -0
  701. data/lib/puppet/pops/types/p_timestamp_type.rb +74 -0
  702. data/lib/puppet/pops/types/p_type_set_type.rb +394 -0
  703. data/lib/puppet/pops/types/p_uri_type.rb +198 -0
  704. data/lib/puppet/pops/types/puppet_object.rb +41 -0
  705. data/lib/puppet/pops/types/recursion_guard.rb +142 -0
  706. data/lib/puppet/pops/types/ruby_generator.rb +477 -0
  707. data/lib/puppet/pops/types/ruby_method.rb +32 -0
  708. data/lib/puppet/pops/types/string_converter.rb +1144 -0
  709. data/lib/puppet/pops/types/tree_iterators.rb +250 -0
  710. data/lib/puppet/pops/types/type_acceptor.rb +27 -0
  711. data/lib/puppet/pops/types/type_asserter.rb +49 -0
  712. data/lib/puppet/pops/types/type_assertion_error.rb +27 -0
  713. data/lib/puppet/pops/types/type_calculator.rb +829 -0
  714. data/lib/puppet/pops/types/type_conversion_error.rb +7 -0
  715. data/lib/puppet/pops/types/type_factory.rb +640 -0
  716. data/lib/puppet/pops/types/type_formatter.rb +796 -0
  717. data/lib/puppet/pops/types/type_mismatch_describer.rb +1105 -0
  718. data/lib/puppet/pops/types/type_parser.rb +690 -0
  719. data/lib/puppet/pops/types/type_set_reference.rb +62 -0
  720. data/lib/puppet/pops/types/type_with_members.rb +43 -0
  721. data/lib/puppet/pops/types/types.rb +3651 -0
  722. data/lib/puppet/pops/utils.rb +117 -0
  723. data/lib/puppet/pops/validation/checker4_0.rb +1155 -0
  724. data/lib/puppet/pops/validation/tasks_checker.rb +95 -0
  725. data/lib/puppet/pops/validation/validator_factory_4_0.rb +45 -0
  726. data/lib/puppet/pops/validation.rb +462 -0
  727. data/lib/puppet/pops/visitable.rb +8 -0
  728. data/lib/puppet/pops/visitor.rb +136 -0
  729. data/lib/puppet/pops.rb +124 -0
  730. data/lib/puppet/property/boolean.rb +9 -0
  731. data/lib/puppet/property/ensure.rb +107 -0
  732. data/lib/puppet/property/keyvalue.rb +159 -0
  733. data/lib/puppet/property/list.rb +71 -0
  734. data/lib/puppet/property/ordered_list.rb +30 -0
  735. data/lib/puppet/property.rb +610 -0
  736. data/lib/puppet/provider/aix_object.rb +491 -0
  737. data/lib/puppet/provider/command.rb +27 -0
  738. data/lib/puppet/provider/confine.rb +8 -0
  739. data/lib/puppet/provider/exec/posix.rb +63 -0
  740. data/lib/puppet/provider/exec/shell.rb +27 -0
  741. data/lib/puppet/provider/exec/windows.rb +57 -0
  742. data/lib/puppet/provider/exec.rb +107 -0
  743. data/lib/puppet/provider/file/posix.rb +162 -0
  744. data/lib/puppet/provider/file/windows.rb +151 -0
  745. data/lib/puppet/provider/group/aix.rb +101 -0
  746. data/lib/puppet/provider/group/directoryservice.rb +24 -0
  747. data/lib/puppet/provider/group/groupadd.rb +180 -0
  748. data/lib/puppet/provider/group/ldap.rb +51 -0
  749. data/lib/puppet/provider/group/pw.rb +52 -0
  750. data/lib/puppet/provider/group/windows_adsi.rb +116 -0
  751. data/lib/puppet/provider/ldap.rb +143 -0
  752. data/lib/puppet/provider/nameservice/directoryservice.rb +522 -0
  753. data/lib/puppet/provider/nameservice/objectadd.rb +22 -0
  754. data/lib/puppet/provider/nameservice/pw.rb +21 -0
  755. data/lib/puppet/provider/nameservice.rb +297 -0
  756. data/lib/puppet/provider/network_device.rb +74 -0
  757. data/lib/puppet/provider/package/aix.rb +171 -0
  758. data/lib/puppet/provider/package/appdmg.rb +113 -0
  759. data/lib/puppet/provider/package/apple.rb +49 -0
  760. data/lib/puppet/provider/package/apt.rb +265 -0
  761. data/lib/puppet/provider/package/aptitude.rb +35 -0
  762. data/lib/puppet/provider/package/aptrpm.rb +87 -0
  763. data/lib/puppet/provider/package/blastwave.rb +109 -0
  764. data/lib/puppet/provider/package/dnf.rb +57 -0
  765. data/lib/puppet/provider/package/dnfmodule.rb +143 -0
  766. data/lib/puppet/provider/package/dpkg.rb +191 -0
  767. data/lib/puppet/provider/package/fink.rb +99 -0
  768. data/lib/puppet/provider/package/freebsd.rb +49 -0
  769. data/lib/puppet/provider/package/gem.rb +296 -0
  770. data/lib/puppet/provider/package/hpux.rb +46 -0
  771. data/lib/puppet/provider/package/macports.rb +112 -0
  772. data/lib/puppet/provider/package/nim.rb +290 -0
  773. data/lib/puppet/provider/package/openbsd.rb +263 -0
  774. data/lib/puppet/provider/package/opkg.rb +85 -0
  775. data/lib/puppet/provider/package/pacman.rb +270 -0
  776. data/lib/puppet/provider/package/pip.rb +347 -0
  777. data/lib/puppet/provider/package/pip2.rb +18 -0
  778. data/lib/puppet/provider/package/pip3.rb +18 -0
  779. data/lib/puppet/provider/package/pkg.rb +300 -0
  780. data/lib/puppet/provider/package/pkgdmg.rb +159 -0
  781. data/lib/puppet/provider/package/pkgin.rb +88 -0
  782. data/lib/puppet/provider/package/pkgng.rb +178 -0
  783. data/lib/puppet/provider/package/pkgutil.rb +186 -0
  784. data/lib/puppet/provider/package/portage.rb +314 -0
  785. data/lib/puppet/provider/package/ports.rb +94 -0
  786. data/lib/puppet/provider/package/portupgrade.rb +233 -0
  787. data/lib/puppet/provider/package/puppet_gem.rb +25 -0
  788. data/lib/puppet/provider/package/puppetserver_gem.rb +174 -0
  789. data/lib/puppet/provider/package/rpm.rb +255 -0
  790. data/lib/puppet/provider/package/rug.rb +51 -0
  791. data/lib/puppet/provider/package/sun.rb +137 -0
  792. data/lib/puppet/provider/package/sunfreeware.rb +11 -0
  793. data/lib/puppet/provider/package/tdnf.rb +35 -0
  794. data/lib/puppet/provider/package/up2date.rb +40 -0
  795. data/lib/puppet/provider/package/urpmi.rb +57 -0
  796. data/lib/puppet/provider/package/windows/exe_package.rb +108 -0
  797. data/lib/puppet/provider/package/windows/msi_package.rb +72 -0
  798. data/lib/puppet/provider/package/windows/package.rb +113 -0
  799. data/lib/puppet/provider/package/windows.rb +131 -0
  800. data/lib/puppet/provider/package/xbps.rb +127 -0
  801. data/lib/puppet/provider/package/yum.rb +390 -0
  802. data/lib/puppet/provider/package/zypper.rb +206 -0
  803. data/lib/puppet/provider/package.rb +61 -0
  804. data/lib/puppet/provider/package_targetable.rb +71 -0
  805. data/lib/puppet/provider/parsedfile.rb +494 -0
  806. data/lib/puppet/provider/service/base.rb +135 -0
  807. data/lib/puppet/provider/service/bsd.rb +53 -0
  808. data/lib/puppet/provider/service/daemontools.rb +196 -0
  809. data/lib/puppet/provider/service/debian.rb +77 -0
  810. data/lib/puppet/provider/service/freebsd.rb +141 -0
  811. data/lib/puppet/provider/service/gentoo.rb +47 -0
  812. data/lib/puppet/provider/service/init.rb +194 -0
  813. data/lib/puppet/provider/service/launchd.rb +391 -0
  814. data/lib/puppet/provider/service/openbsd.rb +101 -0
  815. data/lib/puppet/provider/service/openrc.rb +72 -0
  816. data/lib/puppet/provider/service/openwrt.rb +37 -0
  817. data/lib/puppet/provider/service/rcng.rb +53 -0
  818. data/lib/puppet/provider/service/redhat.rb +75 -0
  819. data/lib/puppet/provider/service/runit.rb +107 -0
  820. data/lib/puppet/provider/service/service.rb +67 -0
  821. data/lib/puppet/provider/service/smf.rb +322 -0
  822. data/lib/puppet/provider/service/src.rb +147 -0
  823. data/lib/puppet/provider/service/systemd.rb +232 -0
  824. data/lib/puppet/provider/service/upstart.rb +385 -0
  825. data/lib/puppet/provider/service/windows.rb +179 -0
  826. data/lib/puppet/provider/user/aix.rb +365 -0
  827. data/lib/puppet/provider/user/directoryservice.rb +687 -0
  828. data/lib/puppet/provider/user/hpux.rb +93 -0
  829. data/lib/puppet/provider/user/ldap.rb +135 -0
  830. data/lib/puppet/provider/user/openbsd.rb +79 -0
  831. data/lib/puppet/provider/user/pw.rb +109 -0
  832. data/lib/puppet/provider/user/user_role_add.rb +243 -0
  833. data/lib/puppet/provider/user/useradd.rb +417 -0
  834. data/lib/puppet/provider/user/windows_adsi.rb +176 -0
  835. data/lib/puppet/provider.rb +613 -0
  836. data/lib/puppet/reference/configuration.rb +105 -0
  837. data/lib/puppet/reference/function.rb +19 -0
  838. data/lib/puppet/reference/indirection.rb +76 -0
  839. data/lib/puppet/reference/metaparameter.rb +35 -0
  840. data/lib/puppet/reference/providers.rb +119 -0
  841. data/lib/puppet/reference/report.rb +22 -0
  842. data/lib/puppet/reference/type.rb +111 -0
  843. data/lib/puppet/relationship.rb +85 -0
  844. data/lib/puppet/reports/http.rb +45 -0
  845. data/lib/puppet/reports/log.rb +15 -0
  846. data/lib/puppet/reports/store.rb +71 -0
  847. data/lib/puppet/reports.rb +95 -0
  848. data/lib/puppet/resource/catalog.rb +655 -0
  849. data/lib/puppet/resource/status.rb +231 -0
  850. data/lib/puppet/resource/type.rb +449 -0
  851. data/lib/puppet/resource/type_collection.rb +235 -0
  852. data/lib/puppet/resource.rb +673 -0
  853. data/lib/puppet/runtime.rb +67 -0
  854. data/lib/puppet/scheduler/job.rb +55 -0
  855. data/lib/puppet/scheduler/scheduler.rb +46 -0
  856. data/lib/puppet/scheduler/splay_job.rb +45 -0
  857. data/lib/puppet/scheduler/timer.rb +15 -0
  858. data/lib/puppet/scheduler.rb +18 -0
  859. data/lib/puppet/settings/alias_setting.rb +37 -0
  860. data/lib/puppet/settings/array_setting.rb +18 -0
  861. data/lib/puppet/settings/autosign_setting.rb +23 -0
  862. data/lib/puppet/settings/base_setting.rb +228 -0
  863. data/lib/puppet/settings/boolean_setting.rb +34 -0
  864. data/lib/puppet/settings/certificate_revocation_setting.rb +22 -0
  865. data/lib/puppet/settings/config_file.rb +148 -0
  866. data/lib/puppet/settings/directory_setting.rb +20 -0
  867. data/lib/puppet/settings/duration_setting.rb +33 -0
  868. data/lib/puppet/settings/enum_setting.rb +18 -0
  869. data/lib/puppet/settings/environment_conf.rb +228 -0
  870. data/lib/puppet/settings/errors.rb +14 -0
  871. data/lib/puppet/settings/file_or_directory_setting.rb +37 -0
  872. data/lib/puppet/settings/file_setting.rb +232 -0
  873. data/lib/puppet/settings/http_extra_headers_setting.rb +26 -0
  874. data/lib/puppet/settings/ini_file.rb +228 -0
  875. data/lib/puppet/settings/integer_setting.rb +19 -0
  876. data/lib/puppet/settings/path_setting.rb +10 -0
  877. data/lib/puppet/settings/port_setting.rb +17 -0
  878. data/lib/puppet/settings/priority_setting.rb +44 -0
  879. data/lib/puppet/settings/server_list_setting.rb +30 -0
  880. data/lib/puppet/settings/string_setting.rb +11 -0
  881. data/lib/puppet/settings/symbolic_enum_setting.rb +19 -0
  882. data/lib/puppet/settings/terminus_setting.rb +16 -0
  883. data/lib/puppet/settings/ttl_setting.rb +53 -0
  884. data/lib/puppet/settings/value_translator.rb +16 -0
  885. data/lib/puppet/settings.rb +1650 -0
  886. data/lib/puppet/ssl/base.rb +152 -0
  887. data/lib/puppet/ssl/certificate.rb +98 -0
  888. data/lib/puppet/ssl/certificate_request.rb +320 -0
  889. data/lib/puppet/ssl/certificate_request_attributes.rb +40 -0
  890. data/lib/puppet/ssl/certificate_signer.rb +39 -0
  891. data/lib/puppet/ssl/digest.rb +22 -0
  892. data/lib/puppet/ssl/error.rb +29 -0
  893. data/lib/puppet/ssl/oids.rb +199 -0
  894. data/lib/puppet/ssl/openssl_loader.rb +26 -0
  895. data/lib/puppet/ssl/ssl_context.rb +27 -0
  896. data/lib/puppet/ssl/ssl_provider.rb +354 -0
  897. data/lib/puppet/ssl/state_machine.rb +605 -0
  898. data/lib/puppet/ssl/verifier.rb +143 -0
  899. data/lib/puppet/ssl.rb +25 -0
  900. data/lib/puppet/syntax_checkers/base64.rb +42 -0
  901. data/lib/puppet/syntax_checkers/epp.rb +35 -0
  902. data/lib/puppet/syntax_checkers/json.rb +35 -0
  903. data/lib/puppet/syntax_checkers/pp.rb +35 -0
  904. data/lib/puppet/syntax_checkers.rb +5 -0
  905. data/lib/puppet/test/test_helper.rb +251 -0
  906. data/lib/puppet/thread_local.rb +6 -0
  907. data/lib/puppet/transaction/additional_resource_generator.rb +225 -0
  908. data/lib/puppet/transaction/event.rb +171 -0
  909. data/lib/puppet/transaction/event_manager.rb +180 -0
  910. data/lib/puppet/transaction/persistence.rb +119 -0
  911. data/lib/puppet/transaction/report.rb +511 -0
  912. data/lib/puppet/transaction/resource_harness.rb +331 -0
  913. data/lib/puppet/transaction.rb +493 -0
  914. data/lib/puppet/trusted_external.rb +46 -0
  915. data/lib/puppet/type/component.rb +96 -0
  916. data/lib/puppet/type/exec.rb +730 -0
  917. data/lib/puppet/type/file/checksum.rb +54 -0
  918. data/lib/puppet/type/file/checksum_value.rb +56 -0
  919. data/lib/puppet/type/file/content.rb +180 -0
  920. data/lib/puppet/type/file/ctime.rb +22 -0
  921. data/lib/puppet/type/file/data_sync.rb +101 -0
  922. data/lib/puppet/type/file/ensure.rb +194 -0
  923. data/lib/puppet/type/file/group.rb +50 -0
  924. data/lib/puppet/type/file/mode.rb +192 -0
  925. data/lib/puppet/type/file/mtime.rb +21 -0
  926. data/lib/puppet/type/file/owner.rb +52 -0
  927. data/lib/puppet/type/file/selcontext.rb +143 -0
  928. data/lib/puppet/type/file/source.rb +380 -0
  929. data/lib/puppet/type/file/target.rb +86 -0
  930. data/lib/puppet/type/file/type.rb +21 -0
  931. data/lib/puppet/type/file.rb +1139 -0
  932. data/lib/puppet/type/filebucket.rb +123 -0
  933. data/lib/puppet/type/group.rb +238 -0
  934. data/lib/puppet/type/notify.rb +48 -0
  935. data/lib/puppet/type/package.rb +715 -0
  936. data/lib/puppet/type/resources.rb +192 -0
  937. data/lib/puppet/type/schedule.rb +441 -0
  938. data/lib/puppet/type/service.rb +310 -0
  939. data/lib/puppet/type/stage.rb +29 -0
  940. data/lib/puppet/type/tidy.rb +382 -0
  941. data/lib/puppet/type/user.rb +865 -0
  942. data/lib/puppet/type/whit.rb +35 -0
  943. data/lib/puppet/type.rb +2629 -0
  944. data/lib/puppet/util/at_fork/noop.rb +20 -0
  945. data/lib/puppet/util/at_fork/solaris.rb +158 -0
  946. data/lib/puppet/util/at_fork.rb +37 -0
  947. data/lib/puppet/util/autoload.rb +221 -0
  948. data/lib/puppet/util/backups.rb +88 -0
  949. data/lib/puppet/util/character_encoding.rb +83 -0
  950. data/lib/puppet/util/checksums.rb +380 -0
  951. data/lib/puppet/util/classgen.rb +223 -0
  952. data/lib/puppet/util/colors.rb +102 -0
  953. data/lib/puppet/util/command_line/puppet_option_parser.rb +89 -0
  954. data/lib/puppet/util/command_line/trollop.rb +847 -0
  955. data/lib/puppet/util/command_line.rb +198 -0
  956. data/lib/puppet/util/constant_inflector.rb +25 -0
  957. data/lib/puppet/util/diff.rb +80 -0
  958. data/lib/puppet/util/docs.rb +132 -0
  959. data/lib/puppet/util/errors.rb +161 -0
  960. data/lib/puppet/util/execution.rb +446 -0
  961. data/lib/puppet/util/execution_stub.rb +28 -0
  962. data/lib/puppet/util/feature.rb +129 -0
  963. data/lib/puppet/util/file_watcher.rb +31 -0
  964. data/lib/puppet/util/fileparsing.rb +404 -0
  965. data/lib/puppet/util/filetype.rb +358 -0
  966. data/lib/puppet/util/http_proxy.rb +6 -0
  967. data/lib/puppet/util/inifile.rb +335 -0
  968. data/lib/puppet/util/instance_loader.rb +69 -0
  969. data/lib/puppet/util/json.rb +94 -0
  970. data/lib/puppet/util/json_lockfile.rb +47 -0
  971. data/lib/puppet/util/ldap/connection.rb +75 -0
  972. data/lib/puppet/util/ldap/generator.rb +44 -0
  973. data/lib/puppet/util/ldap/manager.rb +283 -0
  974. data/lib/puppet/util/ldap.rb +4 -0
  975. data/lib/puppet/util/libuser.conf +15 -0
  976. data/lib/puppet/util/libuser.rb +13 -0
  977. data/lib/puppet/util/limits.rb +14 -0
  978. data/lib/puppet/util/lockfile.rb +66 -0
  979. data/lib/puppet/util/log/destination.rb +50 -0
  980. data/lib/puppet/util/log/destinations.rb +253 -0
  981. data/lib/puppet/util/log.rb +436 -0
  982. data/lib/puppet/util/logging.rb +304 -0
  983. data/lib/puppet/util/metaid.rb +22 -0
  984. data/lib/puppet/util/metric.rb +68 -0
  985. data/lib/puppet/util/monkey_patches.rb +114 -0
  986. data/lib/puppet/util/multi_match.rb +55 -0
  987. data/lib/puppet/util/network_device/base.rb +24 -0
  988. data/lib/puppet/util/network_device/config.rb +105 -0
  989. data/lib/puppet/util/network_device/transport/base.rb +26 -0
  990. data/lib/puppet/util/network_device/transport.rb +7 -0
  991. data/lib/puppet/util/network_device.rb +19 -0
  992. data/lib/puppet/util/package/version/debian.rb +177 -0
  993. data/lib/puppet/util/package/version/gem.rb +18 -0
  994. data/lib/puppet/util/package/version/pip.rb +173 -0
  995. data/lib/puppet/util/package/version/range/eq.rb +17 -0
  996. data/lib/puppet/util/package/version/range/gt.rb +17 -0
  997. data/lib/puppet/util/package/version/range/gt_eq.rb +17 -0
  998. data/lib/puppet/util/package/version/range/lt.rb +17 -0
  999. data/lib/puppet/util/package/version/range/lt_eq.rb +17 -0
  1000. data/lib/puppet/util/package/version/range/min_max.rb +26 -0
  1001. data/lib/puppet/util/package/version/range/simple.rb +13 -0
  1002. data/lib/puppet/util/package/version/range.rb +57 -0
  1003. data/lib/puppet/util/package/version/rpm.rb +75 -0
  1004. data/lib/puppet/util/package.rb +43 -0
  1005. data/lib/puppet/util/pidlock.rb +103 -0
  1006. data/lib/puppet/util/platform.rb +72 -0
  1007. data/lib/puppet/util/plist.rb +161 -0
  1008. data/lib/puppet/util/posix.rb +206 -0
  1009. data/lib/puppet/util/profiler/aggregate.rb +82 -0
  1010. data/lib/puppet/util/profiler/around_profiler.rb +68 -0
  1011. data/lib/puppet/util/profiler/logging.rb +50 -0
  1012. data/lib/puppet/util/profiler/object_counts.rb +19 -0
  1013. data/lib/puppet/util/profiler/wall_clock.rb +36 -0
  1014. data/lib/puppet/util/profiler.rb +55 -0
  1015. data/lib/puppet/util/provider_features.rb +183 -0
  1016. data/lib/puppet/util/psych_support.rb +32 -0
  1017. data/lib/puppet/util/rdoc/code_objects.rb +293 -0
  1018. data/lib/puppet/util/rdoc/generators/puppet_generator.rb +902 -0
  1019. data/lib/puppet/util/rdoc/generators/template/puppet/puppet.rb +1068 -0
  1020. data/lib/puppet/util/rdoc/parser/puppet_parser_core.rb +262 -0
  1021. data/lib/puppet/util/rdoc/parser/puppet_parser_rdoc2.rb +16 -0
  1022. data/lib/puppet/util/rdoc/parser.rb +14 -0
  1023. data/lib/puppet/util/rdoc.rb +54 -0
  1024. data/lib/puppet/util/reference.rb +94 -0
  1025. data/lib/puppet/util/resource_template.rb +63 -0
  1026. data/lib/puppet/util/retry_action.rb +47 -0
  1027. data/lib/puppet/util/rpm_compare.rb +196 -0
  1028. data/lib/puppet/util/rubygems.rb +67 -0
  1029. data/lib/puppet/util/run_mode.rb +164 -0
  1030. data/lib/puppet/util/selinux.rb +331 -0
  1031. data/lib/puppet/util/skip_tags.rb +15 -0
  1032. data/lib/puppet/util/splayer.rb +20 -0
  1033. data/lib/puppet/util/storage.rb +100 -0
  1034. data/lib/puppet/util/suidmanager.rb +167 -0
  1035. data/lib/puppet/util/symbolic_file_mode.rb +156 -0
  1036. data/lib/puppet/util/tag_set.rb +29 -0
  1037. data/lib/puppet/util/tagging.rb +131 -0
  1038. data/lib/puppet/util/terminal.rb +18 -0
  1039. data/lib/puppet/util/user_attr.rb +23 -0
  1040. data/lib/puppet/util/warnings.rb +35 -0
  1041. data/lib/puppet/util/watched_file.rb +40 -0
  1042. data/lib/puppet/util/watcher/change_watcher.rb +35 -0
  1043. data/lib/puppet/util/watcher/periodic_watcher.rb +38 -0
  1044. data/lib/puppet/util/watcher/timer.rb +21 -0
  1045. data/lib/puppet/util/watcher.rb +17 -0
  1046. data/lib/puppet/util/windows/access_control_entry.rb +86 -0
  1047. data/lib/puppet/util/windows/access_control_list.rb +116 -0
  1048. data/lib/puppet/util/windows/adsi.rb +662 -0
  1049. data/lib/puppet/util/windows/com.rb +228 -0
  1050. data/lib/puppet/util/windows/daemon.rb +340 -0
  1051. data/lib/puppet/util/windows/error.rb +86 -0
  1052. data/lib/puppet/util/windows/eventlog.rb +191 -0
  1053. data/lib/puppet/util/windows/file.rb +359 -0
  1054. data/lib/puppet/util/windows/monkey_patches/process.rb +413 -0
  1055. data/lib/puppet/util/windows/principal.rb +204 -0
  1056. data/lib/puppet/util/windows/process.rb +360 -0
  1057. data/lib/puppet/util/windows/registry.rb +443 -0
  1058. data/lib/puppet/util/windows/root_certs.rb +110 -0
  1059. data/lib/puppet/util/windows/security.rb +909 -0
  1060. data/lib/puppet/util/windows/security_descriptor.rb +64 -0
  1061. data/lib/puppet/util/windows/service.rb +708 -0
  1062. data/lib/puppet/util/windows/sid.rb +291 -0
  1063. data/lib/puppet/util/windows/string.rb +17 -0
  1064. data/lib/puppet/util/windows/user.rb +551 -0
  1065. data/lib/puppet/util/windows.rb +58 -0
  1066. data/lib/puppet/util/yaml.rb +67 -0
  1067. data/lib/puppet/util.rb +759 -0
  1068. data/lib/puppet/vendor/require_vendored.rb +4 -0
  1069. data/lib/puppet/vendor.rb +59 -0
  1070. data/lib/puppet/version.rb +98 -0
  1071. data/lib/puppet/x509/cert_provider.rb +405 -0
  1072. data/lib/puppet/x509/pem_store.rb +57 -0
  1073. data/lib/puppet/x509.rb +13 -0
  1074. data/lib/puppet.rb +348 -0
  1075. data/lib/puppet_pal.rb +10 -0
  1076. data/lib/puppet_x.rb +16 -0
  1077. data/locales/config.yaml +29 -0
  1078. data/locales/en/puppet.po +19 -0
  1079. data/locales/puppet.pot +9738 -0
  1080. data/man/man5/puppet.conf.5 +1407 -0
  1081. data/man/man8/puppet-agent.8 +135 -0
  1082. data/man/man8/puppet-apply.8 +67 -0
  1083. data/man/man8/puppet-catalog.8 +194 -0
  1084. data/man/man8/puppet-config.8 +103 -0
  1085. data/man/man8/puppet-describe.8 +35 -0
  1086. data/man/man8/puppet-device.8 +83 -0
  1087. data/man/man8/puppet-doc.8 +30 -0
  1088. data/man/man8/puppet-epp.8 +232 -0
  1089. data/man/man8/puppet-facts.8 +156 -0
  1090. data/man/man8/puppet-filebucket.8 +134 -0
  1091. data/man/man8/puppet-generate.8 +54 -0
  1092. data/man/man8/puppet-help.8 +46 -0
  1093. data/man/man8/puppet-lookup.8 +71 -0
  1094. data/man/man8/puppet-module.8 +220 -0
  1095. data/man/man8/puppet-node.8 +142 -0
  1096. data/man/man8/puppet-parser.8 +87 -0
  1097. data/man/man8/puppet-plugin.8 +50 -0
  1098. data/man/man8/puppet-report.8 +84 -0
  1099. data/man/man8/puppet-resource.8 +63 -0
  1100. data/man/man8/puppet-script.8 +48 -0
  1101. data/man/man8/puppet-ssl.8 +45 -0
  1102. data/man/man8/puppet.8 +98 -0
  1103. data/tasks/tag.rake +34 -0
  1104. metadata +1336 -0
@@ -0,0 +1,1013 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Creates a new instance/object of a given data type.
4
+ #
5
+ # This function makes it possible to create new instances of
6
+ # concrete data types. If a block is given it is called with the
7
+ # just created instance as an argument.
8
+ #
9
+ # Calling this function is equivalent to directly
10
+ # calling the data type:
11
+ #
12
+ # @example `new` and calling type directly are equivalent
13
+ #
14
+ # ```puppet
15
+ # $a = Integer.new("42")
16
+ # $b = Integer("42")
17
+ # ```
18
+ #
19
+ # These would both convert the string `"42"` to the decimal value `42`.
20
+ #
21
+ # @example arguments by position or by name
22
+ #
23
+ # ```puppet
24
+ # $a = Integer.new("42", 8)
25
+ # $b = Integer({from => "42", radix => 8})
26
+ # ```
27
+ #
28
+ # This would convert the octal (radix 8) number `"42"` in string form
29
+ # to the decimal value `34`.
30
+ #
31
+ # The new function supports two ways of giving the arguments:
32
+ #
33
+ # * by name (using a hash with property to value mapping)
34
+ # * by position (as regular arguments)
35
+ #
36
+ # Note that it is not possible to create new instances of
37
+ # some abstract data types (for example `Variant`). The data type `Optional[T]` is an
38
+ # exception as it will create an instance of `T` or `undef` if the
39
+ # value to convert is `undef`.
40
+ #
41
+ # The arguments that can be given is determined by the data type.
42
+ #
43
+ # > An assertion is always made that the produced value complies with the given type constraints.
44
+ #
45
+ # @example data type constraints are checked
46
+ #
47
+ # ```puppet
48
+ # Integer[0].new("-100")
49
+ # ```
50
+ #
51
+ # Would fail with an assertion error (since value is less than 0).
52
+ #
53
+ # The following sections show the arguments and conversion rules
54
+ # per data type built into the Puppet Type System.
55
+ #
56
+ # ### Conversion to `Optional[T]` and `NotUndef[T]`
57
+ #
58
+ # Conversion to these data types is the same as a conversion to the type argument `T`.
59
+ # In the case of `Optional[T]` it is accepted that the argument to convert may be `undef`.
60
+ # It is however not acceptable to give other arguments (than `undef`) that cannot be
61
+ # converted to `T`.
62
+ #
63
+ # ### Conversion to Integer
64
+ #
65
+ # A new `Integer` can be created from `Integer`, `Float`, `Boolean`, and `String` values.
66
+ # For conversion from `String` it is possible to specify the radix (base).
67
+ #
68
+ # ```puppet
69
+ # type Radix = Variant[Default, Integer[2,2], Integer[8,8], Integer[10,10], Integer[16,16]]
70
+ #
71
+ # function Integer.new(
72
+ # String $value,
73
+ # Radix $radix = 10,
74
+ # Boolean $abs = false
75
+ # )
76
+ #
77
+ # function Integer.new(
78
+ # Variant[Numeric, Boolean] $value,
79
+ # Boolean $abs = false
80
+ # )
81
+ # ```
82
+ #
83
+ # * When converting from `String` the default radix is 10.
84
+ # * If radix is not specified an attempt is made to detect the radix from the start of the string:
85
+ # * `0b` or `0B` is taken as radix 2.
86
+ # * `0x` or `0X` is taken as radix 16.
87
+ # * `0` as radix 8.
88
+ # * All others are decimal.
89
+ # * Conversion from `String` accepts an optional sign in the string.
90
+ # * For hexadecimal (radix 16) conversion an optional leading `"0x"`, or `"0X"` is accepted.
91
+ # * For octal (radix 8) an optional leading `"0"` is accepted.
92
+ # * For binary (radix 2) an optional leading `"0b"` or `"0B"` is accepted.
93
+ # * When `radix` is set to `default`, the conversion is based on the leading.
94
+ # characters in the string. A leading `"0"` for radix 8, a leading `"0x"`, or `"0X"` for
95
+ # radix 16, and leading `"0b"` or `"0B"` for binary.
96
+ # * Conversion from `Boolean` results in `0` for `false` and `1` for `true`.
97
+ # * Conversion from `Integer`, `Float`, and `Boolean` ignores the radix.
98
+ # * `Float` value fractions are truncated (no rounding).
99
+ # * When `abs` is set to `true`, the result will be an absolute integer.
100
+ #
101
+ # @example Converting to Integer in multiple ways
102
+ #
103
+ # ```puppet
104
+ # $a_number = Integer("0xFF", 16) # results in 255
105
+ # $a_number = Integer("010") # results in 8
106
+ # $a_number = Integer("010", 10) # results in 10
107
+ # $a_number = Integer(true) # results in 1
108
+ # $a_number = Integer(-38, 10, true) # results in 38
109
+ # ```
110
+ #
111
+ # ### Conversion to Float
112
+ #
113
+ # A new `Float` can be created from `Integer`, `Float`, `Boolean`, and `String` values.
114
+ # For conversion from `String` both float and integer formats are supported.
115
+ #
116
+ # ```puppet
117
+ # function Float.new(
118
+ # Variant[Numeric, Boolean, String] $value,
119
+ # Boolean $abs = true
120
+ # )
121
+ # ```
122
+ #
123
+ # * For an integer, the floating point fraction of `.0` is added to the value.
124
+ # * A `Boolean` `true` is converted to `1.0`, and a `false` to `0.0`.
125
+ # * In `String` format, integer prefixes for hex and binary are understood (but not octal since
126
+ # floating point in string format may start with a `'0'`).
127
+ # * When `abs` is set to `true`, the result will be an absolute floating point value.
128
+ #
129
+ # ### Conversion to Numeric
130
+ #
131
+ # A new `Integer` or `Float` can be created from `Integer`, `Float`, `Boolean` and
132
+ # `String` values.
133
+ #
134
+ # ```puppet
135
+ # function Numeric.new(
136
+ # Variant[Numeric, Boolean, String] $value,
137
+ # Boolean $abs = true
138
+ # )
139
+ # ```
140
+ #
141
+ # * If the value has a decimal period, or if given in scientific notation
142
+ # (e/E), the result is a `Float`, otherwise the value is an `Integer`. The
143
+ # conversion from `String` always uses a radix based on the prefix of the string.
144
+ # * Conversion from `Boolean` results in `0` for `false` and `1` for `true`.
145
+ # * When `abs` is set to `true`, the result will be an absolute `Float`or `Integer` value.
146
+ #
147
+ # @example Converting to Numeric in different ways
148
+ #
149
+ # ```puppet
150
+ # $a_number = Numeric(true) # results in 1
151
+ # $a_number = Numeric("0xFF") # results in 255
152
+ # $a_number = Numeric("010") # results in 8
153
+ # $a_number = Numeric("3.14") # results in 3.14 (a float)
154
+ # $a_number = Numeric(-42.3, true) # results in 42.3
155
+ # $a_number = Numeric(-42, true) # results in 42
156
+ # ```
157
+ #
158
+ # ### Conversion to Timespan
159
+ #
160
+ # A new `Timespan` can be created from `Integer`, `Float`, `String`, and `Hash` values. Several variants of the constructor are provided.
161
+ #
162
+ # **Timespan from seconds**
163
+ #
164
+ # When a Float is used, the decimal part represents fractions of a second.
165
+ #
166
+ # ```puppet
167
+ # function Timespan.new(
168
+ # Variant[Float, Integer] $value
169
+ # )
170
+ # ```
171
+ #
172
+ # **Timespan from days, hours, minutes, seconds, and fractions of a second**
173
+ #
174
+ # The arguments can be passed separately in which case the first four, days, hours, minutes, and seconds are mandatory and the rest are optional.
175
+ # All values may overflow and/or be negative. The internal 128-bit nano-second integer is calculated as:
176
+ #
177
+ # ```
178
+ # (((((days * 24 + hours) * 60 + minutes) * 60 + seconds) * 1000 + milliseconds) * 1000 + microseconds) * 1000 + nanoseconds
179
+ # ```
180
+ #
181
+ # ```puppet
182
+ # function Timespan.new(
183
+ # Integer $days, Integer $hours, Integer $minutes, Integer $seconds,
184
+ # Integer $milliseconds = 0, Integer $microseconds = 0, Integer $nanoseconds = 0
185
+ # )
186
+ # ```
187
+ #
188
+ # or, all arguments can be passed as a `Hash`, in which case all entries are optional:
189
+ #
190
+ # ```puppet
191
+ # function Timespan.new(
192
+ # Struct[{
193
+ # Optional[negative] => Boolean,
194
+ # Optional[days] => Integer,
195
+ # Optional[hours] => Integer,
196
+ # Optional[minutes] => Integer,
197
+ # Optional[seconds] => Integer,
198
+ # Optional[milliseconds] => Integer,
199
+ # Optional[microseconds] => Integer,
200
+ # Optional[nanoseconds] => Integer
201
+ # }] $hash
202
+ # )
203
+ # ```
204
+ #
205
+ # **Timespan from String and format directive patterns**
206
+ #
207
+ # The first argument is parsed using the format optionally passed as a string or array of strings. When an array is used, an attempt
208
+ # will be made to parse the string using the first entry and then with each entry in succession until parsing succeeds. If the second
209
+ # argument is omitted, an array of default formats will be used.
210
+ #
211
+ # An exception is raised when no format was able to parse the given string.
212
+ #
213
+ # ```puppet
214
+ # function Timespan.new(
215
+ # String $string, Variant[String[2],Array[String[2], 1]] $format = <default format>)
216
+ # )
217
+ # ```
218
+ #
219
+ # the arguments may also be passed as a `Hash`:
220
+ #
221
+ # ```puppet
222
+ # function Timespan.new(
223
+ # Struct[{
224
+ # string => String[1],
225
+ # Optional[format] => Variant[String[2],Array[String[2], 1]]
226
+ # }] $hash
227
+ # )
228
+ # ```
229
+ #
230
+ # The directive consists of a percent (`%`) character, zero or more flags, optional minimum field width and
231
+ # a conversion specifier as follows:
232
+ # ```
233
+ # %[Flags][Width]Conversion
234
+ # ```
235
+ #
236
+ # ##### Flags:
237
+ #
238
+ # | Flag | Meaning
239
+ # | ---- | ---------------
240
+ # | - | Don't pad numerical output
241
+ # | _ | Use spaces for padding
242
+ # | 0 | Use zeros for padding
243
+ #
244
+ # ##### Format directives:
245
+ #
246
+ # | Format | Meaning |
247
+ # | ------ | ------- |
248
+ # | D | Number of Days |
249
+ # | H | Hour of the day, 24-hour clock |
250
+ # | M | Minute of the hour (00..59) |
251
+ # | S | Second of the minute (00..59) |
252
+ # | L | Millisecond of the second (000..999) |
253
+ # | N | Fractional seconds digits |
254
+ #
255
+ # The format directive that represents the highest magnitude in the format will be allowed to
256
+ # overflow. I.e. if no "%D" is used but a "%H" is present, then the hours may be more than 23.
257
+ #
258
+ # The default array contains the following patterns:
259
+ #
260
+ # ```
261
+ # ['%D-%H:%M:%S', '%D-%H:%M', '%H:%M:%S', '%H:%M']
262
+ # ```
263
+ #
264
+ # Examples - Converting to Timespan
265
+ #
266
+ # ```puppet
267
+ # $duration = Timespan(13.5) # 13 seconds and 500 milliseconds
268
+ # $duration = Timespan({days=>4}) # 4 days
269
+ # $duration = Timespan(4, 0, 0, 2) # 4 days and 2 seconds
270
+ # $duration = Timespan('13:20') # 13 hours and 20 minutes (using default pattern)
271
+ # $duration = Timespan('10:03.5', '%M:%S.%L') # 10 minutes, 3 seconds, and 5 milli-seconds
272
+ # $duration = Timespan('10:03.5', '%M:%S.%N') # 10 minutes, 3 seconds, and 5 nano-seconds
273
+ # ```
274
+ #
275
+ # ### Conversion to Timestamp
276
+ #
277
+ # A new `Timestamp` can be created from `Integer`, `Float`, `String`, and `Hash` values. Several variants of the constructor are provided.
278
+ #
279
+ # **Timestamp from seconds since epoch (1970-01-01 00:00:00 UTC)**
280
+ #
281
+ # When a Float is used, the decimal part represents fractions of a second.
282
+ #
283
+ # ```puppet
284
+ # function Timestamp.new(
285
+ # Variant[Float, Integer] $value
286
+ # )
287
+ # ```
288
+ #
289
+ # **Timestamp from String and patterns consisting of format directives**
290
+ #
291
+ # The first argument is parsed using the format optionally passed as a string or array of strings. When an array is used, an attempt
292
+ # will be made to parse the string using the first entry and then with each entry in succession until parsing succeeds. If the second
293
+ # argument is omitted, an array of default formats will be used.
294
+ #
295
+ # A third optional timezone argument can be provided. The first argument will then be parsed as if it represents a local time in that
296
+ # timezone. The timezone can be any timezone that is recognized when using the `'%z'` or `'%Z'` formats, or the word `'current'`, in which
297
+ # case the current timezone of the evaluating process will be used. The timezone argument is case insensitive.
298
+ #
299
+ # The default timezone, when no argument is provided, or when using the keyword `default`, is 'UTC'.
300
+ #
301
+ # It is illegal to provide a timezone argument other than `default` in combination with a format that contains '%z' or '%Z' since that
302
+ # would introduce an ambiguity as to which timezone to use. The one extracted from the string, or the one provided as an argument.
303
+ #
304
+ # An exception is raised when no format was able to parse the given string.
305
+ #
306
+ # ```puppet
307
+ # function Timestamp.new(
308
+ # String $string,
309
+ # Variant[String[2],Array[String[2], 1]] $format = <default format>,
310
+ # String $timezone = default)
311
+ # )
312
+ # ```
313
+ #
314
+ # the arguments may also be passed as a `Hash`:
315
+ #
316
+ # ```puppet
317
+ # function Timestamp.new(
318
+ # Struct[{
319
+ # string => String[1],
320
+ # Optional[format] => Variant[String[2],Array[String[2], 1]],
321
+ # Optional[timezone] => String[1]
322
+ # }] $hash
323
+ # )
324
+ # ```
325
+ #
326
+ # The directive consists of a percent (%) character, zero or more flags, optional minimum field width and
327
+ # a conversion specifier as follows:
328
+ # ```
329
+ # %[Flags][Width]Conversion
330
+ # ```
331
+ #
332
+ # ##### Flags:
333
+ #
334
+ # | Flag | Meaning
335
+ # | ---- | ---------------
336
+ # | - | Don't pad numerical output
337
+ # | _ | Use spaces for padding
338
+ # | 0 | Use zeros for padding
339
+ # | # | Change names to upper-case or change case of am/pm
340
+ # | ^ | Use uppercase
341
+ # | : | Use colons for `%z`
342
+ #
343
+ # ##### Format directives (names and padding can be altered using flags):
344
+ #
345
+ # **Date (Year, Month, Day):**
346
+ #
347
+ # | Format | Meaning |
348
+ # | ------ | ------- |
349
+ # | Y | Year with century, zero-padded to at least 4 digits |
350
+ # | C | year / 100 (rounded down such as `20` in `2009`) |
351
+ # | y | year % 100 (`00..99`) |
352
+ # | m | Month of the year, zero-padded (`01..12`) |
353
+ # | B | The full month name (`"January"`) |
354
+ # | b | The abbreviated month name (`"Jan"`) |
355
+ # | h | Equivalent to `%b` |
356
+ # | d | Day of the month, zero-padded (`01..31`) |
357
+ # | e | Day of the month, blank-padded (`1..31`) |
358
+ # | j | Day of the year (`001..366`) |
359
+ #
360
+ # **Time (Hour, Minute, Second, Subsecond):**
361
+ #
362
+ # | Format | Meaning |
363
+ # | ------ | ------- |
364
+ # | H | Hour of the day, 24-hour clock, zero-padded (`00..23`) |
365
+ # | k | Hour of the day, 24-hour clock, blank-padded (`0..23`) |
366
+ # | I | Hour of the day, 12-hour clock, zero-padded (`01..12`) |
367
+ # | l | Hour of the day, 12-hour clock, blank-padded (`1..12`) |
368
+ # | P | Meridian indicator, lowercase (`"am"` or `"pm"`) |
369
+ # | p | Meridian indicator, uppercase (`"AM"` or `"PM"`) |
370
+ # | M | Minute of the hour (`00..59`) |
371
+ # | S | Second of the minute (`00..60`) |
372
+ # | L | Millisecond of the second (`000..999`). Digits under millisecond are truncated to not produce 1000 |
373
+ # | N | Fractional seconds digits, default is 9 digits (nanosecond). Digits under a specified width are truncated to avoid carry up |
374
+ #
375
+ # **Time (Hour, Minute, Second, Subsecond):**
376
+ #
377
+ # | Format | Meaning |
378
+ # | ------ | ------- |
379
+ # | z | Time zone as hour and minute offset from UTC (e.g. `+0900`) |
380
+ # | :z | hour and minute offset from UTC with a colon (e.g. `+09:00`) |
381
+ # | ::z | hour, minute and second offset from UTC (e.g. `+09:00:00`) |
382
+ # | Z | Abbreviated time zone name or similar information. (OS dependent) |
383
+ #
384
+ # **Weekday:**
385
+ #
386
+ # | Format | Meaning |
387
+ # | ------ | ------- |
388
+ # | A | The full weekday name (`"Sunday"`) |
389
+ # | a | The abbreviated name (`"Sun"`) |
390
+ # | u | Day of the week (Monday is `1`, `1..7`) |
391
+ # | w | Day of the week (Sunday is `0`, `0..6`) |
392
+ #
393
+ # **ISO 8601 week-based year and week number:**
394
+ #
395
+ # The first week of YYYY starts with a Monday and includes YYYY-01-04.
396
+ # The days in the year before the first week are in the last week of
397
+ # the previous year.
398
+ #
399
+ # | Format | Meaning |
400
+ # | ------ | ------- |
401
+ # | G | The week-based year |
402
+ # | g | The last 2 digits of the week-based year (`00..99`) |
403
+ # | V | Week number of the week-based year (`01..53`) |
404
+ #
405
+ # **Week number:**
406
+ #
407
+ # The first week of YYYY that starts with a Sunday or Monday (according to %U
408
+ # or %W). The days in the year before the first week are in week 0.
409
+ #
410
+ # | Format | Meaning |
411
+ # | ------ | ------- |
412
+ # | U | Week number of the year. The week starts with Sunday. (`00..53`) |
413
+ # | W | Week number of the year. The week starts with Monday. (`00..53`) |
414
+ #
415
+ # **Seconds since the Epoch:**
416
+ #
417
+ # | Format | Meaning |
418
+ # | s | Number of seconds since 1970-01-01 00:00:00 UTC. |
419
+ #
420
+ # **Literal string:**
421
+ #
422
+ # | Format | Meaning |
423
+ # | ------ | ------- |
424
+ # | n | Newline character (`\n`) |
425
+ # | t | Tab character (`\t`) |
426
+ # | % | Literal `%` character |
427
+ #
428
+ # **Combination:**
429
+ #
430
+ # | Format | Meaning |
431
+ # | ------ | ------- |
432
+ # | c | date and time (`%a %b %e %T %Y`) |
433
+ # | D | Date (`%m/%d/%y`) |
434
+ # | F | The ISO 8601 date format (`%Y-%m-%d`) |
435
+ # | v | VMS date (`%e-%^b-%4Y`) |
436
+ # | x | Same as `%D` |
437
+ # | X | Same as `%T` |
438
+ # | r | 12-hour time (`%I:%M:%S %p`) |
439
+ # | R | 24-hour time (`%H:%M`) |
440
+ # | T | 24-hour time (`%H:%M:%S`) |
441
+ #
442
+ # The default array contains the following patterns:
443
+ #
444
+ # When a timezone argument (other than `default`) is explicitly provided:
445
+ #
446
+ # ```
447
+ # ['%FT%T.L', '%FT%T', '%F']
448
+ # ```
449
+ #
450
+ # otherwise:
451
+ #
452
+ # ```
453
+ # ['%FT%T.%L %Z', '%FT%T %Z', '%F %Z', '%FT%T.L', '%FT%T', '%F']
454
+ # ```
455
+ #
456
+ # Examples - Converting to Timestamp
457
+ #
458
+ # ```puppet
459
+ # $ts = Timestamp(1473150899) # 2016-09-06 08:34:59 UTC
460
+ # $ts = Timestamp({string=>'2015', format=>'%Y'}) # 2015-01-01 00:00:00.000 UTC
461
+ # $ts = Timestamp('Wed Aug 24 12:13:14 2016', '%c') # 2016-08-24 12:13:14 UTC
462
+ # $ts = Timestamp('Wed Aug 24 12:13:14 2016 PDT', '%c %Z') # 2016-08-24 19:13:14.000 UTC
463
+ # $ts = Timestamp('2016-08-24 12:13:14', '%F %T', 'PST') # 2016-08-24 20:13:14.000 UTC
464
+ # $ts = Timestamp('2016-08-24T12:13:14', default, 'PST') # 2016-08-24 20:13:14.000 UTC
465
+ #
466
+ # ```
467
+ #
468
+ # ### Conversion to Type
469
+ #
470
+ # A new `Type` can be created from its `String` representation.
471
+ #
472
+ # @example Creating a type from a string
473
+ #
474
+ # ```puppet
475
+ # $t = Type.new('Integer[10]')
476
+ # ```
477
+ #
478
+ # ### Conversion to String
479
+ #
480
+ # Conversion to `String` is the most comprehensive conversion as there are many
481
+ # use cases where a string representation is wanted. The defaults for the many options
482
+ # have been chosen with care to be the most basic "value in textual form" representation.
483
+ # The more advanced forms of formatting are intended to enable writing special purposes formatting
484
+ # functions in the Puppet language.
485
+ #
486
+ # A new string can be created from all other data types. The process is performed in
487
+ # several steps - first the data type of the given value is inferred, then the resulting data type
488
+ # is used to find the most significant format specified for that data type. And finally,
489
+ # the found format is used to convert the given value.
490
+ #
491
+ # The mapping from data type to format is referred to as the *format map*. This map
492
+ # allows different formatting depending on type.
493
+ #
494
+ # @example Positive Integers in Hexadecimal prefixed with `'0x'`, negative in Decimal
495
+ #
496
+ # ```puppet
497
+ # $format_map = {
498
+ # Integer[default, 0] => "%d",
499
+ # Integer[1, default] => "%#x"
500
+ # }
501
+ # String("-1", $format_map) # produces '-1'
502
+ # String("10", $format_map) # produces '0xa'
503
+ # ```
504
+ #
505
+ # A format is specified on the form:
506
+ #
507
+ # ```
508
+ # %[Flags][Width][.Precision]Format
509
+ # ```
510
+ #
511
+ # `Width` is the number of characters into which the value should be fitted. This allocated space is
512
+ # padded if value is shorter. By default it is space padded, and the flag `0` will cause padding with `0`
513
+ # for numerical formats.
514
+ #
515
+ # `Precision` is the number of fractional digits to show for floating point, and the maximum characters
516
+ # included in a string format.
517
+ #
518
+ # Note that all data type supports the formats `s` and `p` with the meaning "default string representation" and
519
+ # "default programmatic string representation" (which for example means that a String is quoted in 'p' format).
520
+ #
521
+ # **Signatures of String conversion**
522
+ #
523
+ # ```puppet
524
+ # type Format = Pattern[/^%([\s\+\-#0\[\{<\(\|]*)([1-9][0-9]*)?(?:\.([0-9]+))?([a-zA-Z])/]
525
+ # type ContainerFormat = Struct[{
526
+ # format => Optional[String],
527
+ # separator => Optional[String],
528
+ # separator2 => Optional[String],
529
+ # string_formats => Hash[Type, Format]
530
+ # }]
531
+ # type TypeMap = Hash[Type, Variant[Format, ContainerFormat]]
532
+ # type Formats = Variant[Default, String[1], TypeMap]
533
+ #
534
+ # function String.new(
535
+ # Any $value,
536
+ # Formats $string_formats
537
+ # )
538
+ # ```
539
+ #
540
+ # Where:
541
+ #
542
+ # * `separator` is the string used to separate entries in an array, or hash (extra space should not be included at
543
+ # the end), defaults to `","`
544
+ # * `separator2` is the separator between key and value in a hash entry (space padding should be included as
545
+ # wanted), defaults to `" => "`.
546
+ # * `string_formats` is a data type to format map for values contained in arrays and hashes - defaults to `{Any => "%p"}`. Note that
547
+ # these nested formats are not applicable to data types that are containers; they are always formatted as per the top level
548
+ # format specification.
549
+ #
550
+ # @example Simple Conversion to String (using defaults)
551
+ #
552
+ # ```puppet
553
+ # $str = String(10) # produces '10'
554
+ # $str = String([10]) # produces '["10"]'
555
+ # ```
556
+ #
557
+ # @example Simple Conversion to String specifying the format for the given value directly
558
+ #
559
+ # ```puppet
560
+ # $str = String(10, "%#x") # produces '0xa'
561
+ # $str = String([10], "%(a") # produces '("10")'
562
+ # ```
563
+ #
564
+ # @example Specifying type for values contained in an array
565
+ #
566
+ # ```puppet
567
+ # $formats = {
568
+ # Array => {
569
+ # format => '%(a',
570
+ # string_formats => { Integer => '%#x' }
571
+ # }
572
+ # }
573
+ # $str = String([1,2,3], $formats) # produces '(0x1, 0x2, 0x3)'
574
+ # ```
575
+ #
576
+ # The given formats are merged with the default formats, and matching of values to convert against format is based on
577
+ # the specificity of the mapped type; for example, different formats can be used for short and long arrays.
578
+ #
579
+ # **Integer to String**
580
+ #
581
+ # | Format | Integer Formats
582
+ # | ------ | ---------------
583
+ # | d | Decimal, negative values produces leading `-`.
584
+ # | x X | Hexadecimal in lower or upper case. Uses `..f/..F` for negative values unless `+` is also used. A `#` adds prefix `0x/0X`.
585
+ # | o | Octal. Uses `..0` for negative values unless `+` is also used. A `#` adds prefix `0`.
586
+ # | b B | Binary with prefix `b` or `B`. Uses `..1/..1` for negative values unless `+` is also used.
587
+ # | c | Numeric value representing a Unicode value, result is a one unicode character string, quoted if alternative flag `#` is used
588
+ # | s | Same as `d`, or `d` in quotes if alternative flag `#` is used.
589
+ # | p | Same as `d`.
590
+ # | eEfgGaA | Converts integer to float and formats using the floating point rules.
591
+ #
592
+ # Defaults to `d`.
593
+ #
594
+ # **Float to String**
595
+ #
596
+ # | Format | Float formats
597
+ # | ------ | -------------
598
+ # | f | Floating point in non exponential notation.
599
+ # | e E | Exponential notation with `e` or `E`.
600
+ # | g G | Conditional exponential with `e` or `E` if exponent `< -4` or `>=` the precision.
601
+ # | a A | Hexadecimal exponential form, using `x`/`X` as prefix and `p`/`P` before exponent.
602
+ # | s | Converted to string using format `p`, then applying string formatting rule, alternate form `#`` quotes result.
603
+ # | p | Same as `f` format with minimum significant number of fractional digits, prec has no effect.
604
+ # | dxXobBc | Converts float to integer and formats using the integer rules.
605
+ #
606
+ # Defaults to `p`.
607
+ #
608
+ # **String to String**
609
+ #
610
+ # | Format | String
611
+ # | ------ | ------
612
+ # | s | Unquoted string, verbatim output of control chars.
613
+ # | p | Programmatic representation - strings are quoted, interior quotes and control chars are escaped. Selects single or double quotes based on content, or uses double quotes if alternative flag `#` is used.
614
+ # | C | Each `::` name segment capitalized, quoted if alternative flag `#` is used.
615
+ # | c | Capitalized string, quoted if alternative flag `#` is used.
616
+ # | d | Downcased string, quoted if alternative flag `#` is used.
617
+ # | u | Upcased string, quoted if alternative flag `#` is used.
618
+ # | t | Trims leading and trailing whitespace from the string, quoted if alternative flag `#` is used.
619
+ #
620
+ # Defaults to `s` at top level and `p` inside array or hash.
621
+ #
622
+ # **Boolean to String**
623
+ #
624
+ # | Format | Boolean Formats
625
+ # | ---- | -------------------
626
+ # | t T | String `'true'/'false'` or `'True'/'False'`, first char if alternate form is used (i.e. `'t'/'f'` or `'T'/'F'`).
627
+ # | y Y | String `'yes'/'no'`, `'Yes'/'No'`, `'y'/'n'` or `'Y'/'N'` if alternative flag `#` is used.
628
+ # | dxXobB | Numeric value `0/1` in accordance with the given format which must be valid integer format.
629
+ # | eEfgGaA | Numeric value `0.0/1.0` in accordance with the given float format and flags.
630
+ # | s | String `'true'` / `'false'`.
631
+ # | p | String `'true'` / `'false'`.
632
+ #
633
+ # **Regexp to String**
634
+ #
635
+ # | Format | Regexp Formats
636
+ # | ---- | --------------
637
+ # | s | No delimiters, quoted if alternative flag `#` is used.
638
+ # | p | Delimiters `/ /`.
639
+ #
640
+ # **Undef to String**
641
+ #
642
+ # | Format | Undef formats
643
+ # | ------ | -------------
644
+ # | s | Empty string, or quoted empty string if alternative flag `#` is used.
645
+ # | p | String `'undef'`, or quoted `'"undef"'` if alternative flag `#` is used.
646
+ # | n | String `'nil'`, or `'null'` if alternative flag `#` is used.
647
+ # | dxXobB | String `'NaN'`.
648
+ # | eEfgGaA | String `'NaN'`.
649
+ # | v | String `'n/a'`.
650
+ # | V | String `'N/A'`.
651
+ # | u | String `'undef'`, or `'undefined'` if alternative `#` flag is used.
652
+ #
653
+ # **Default value to String**
654
+ #
655
+ # | Format | Default formats
656
+ # | ------ | ---------------
657
+ # | d D | String `'default'` or `'Default'`, alternative form `#` causes value to be quoted.
658
+ # | s | Same as `d`.
659
+ # | p | Same as `d`.
660
+ #
661
+ # **Binary value to String**
662
+ #
663
+ # | Format | Default formats
664
+ # | ------ | ---------------
665
+ # | s | binary as unquoted UTF-8 characters (errors if byte sequence is invalid UTF-8). Alternate form escapes non ascii bytes.
666
+ # | p | `'Binary("<base64strict>")'`
667
+ # | b | `'<base64>'` - base64 string with newlines inserted
668
+ # | B | `'<base64strict>'` - base64 strict string (without newlines inserted)
669
+ # | u | `'<base64urlsafe>'` - base64 urlsafe string
670
+ # | t | `'Binary'` - outputs the name of the type only
671
+ # | T | `'BINARY'` - output the name of the type in all caps only
672
+ #
673
+ # * The alternate form flag `#` will quote the binary or base64 text output.
674
+ # * The format `%#s` allows invalid UTF-8 characters and outputs all non ascii bytes
675
+ # as hex escaped characters on the form `\\xHH` where `H` is a hex digit.
676
+ # * The width and precision values are applied to the text part only in `%p` format.
677
+ #
678
+ # **Array & Tuple to String**
679
+ #
680
+ # | Format | Array/Tuple Formats
681
+ # | ------ | -------------
682
+ # | a | Formats with `[ ]` delimiters and `,`, alternate form `#` indents nested arrays/hashes.
683
+ # | s | Same as `a`.
684
+ # | p | Same as `a`.
685
+ #
686
+ # See "Flags" `<[({\|` for formatting of delimiters, and "Additional parameters for containers; Array and Hash" for
687
+ # more information about options.
688
+ #
689
+ # The alternate form flag `#` will cause indentation of nested array or hash containers. If width is also set
690
+ # it is taken as the maximum allowed length of a sequence of elements (not including delimiters). If this max length
691
+ # is exceeded, each element will be indented.
692
+ #
693
+ # **Hash & Struct to String**
694
+ #
695
+ # | Format | Hash/Struct Formats
696
+ # | ------ | -------------
697
+ # | h | Formats with `{ }` delimiters, `,` element separator and ` => ` inner element separator unless overridden by flags.
698
+ # | s | Same as h.
699
+ # | p | Same as h.
700
+ # | a | Converts the hash to an array of `[k,v]` tuples and formats it using array rule(s).
701
+ #
702
+ # See "Flags" `<[({\|` for formatting of delimiters, and "Additional parameters for containers; Array and Hash" for
703
+ # more information about options.
704
+ #
705
+ # The alternate form flag `#` will format each hash key/value entry indented on a separate line.
706
+ #
707
+ # **Type to String**
708
+ #
709
+ # | Format | Array/Tuple Formats
710
+ # | ------ | -------------
711
+ # | s | The same as `p`, quoted if alternative flag `#` is used.
712
+ # | p | Outputs the type in string form as specified by the Puppet Language.
713
+ #
714
+ # **Flags**
715
+ #
716
+ # | Flag | Effect
717
+ # | ------ | ------
718
+ # | (space) | A space instead of `+` for numeric output (`-` is shown), for containers skips delimiters.
719
+ # | # | Alternate format; prefix `0x/0x`, `0` (octal) and `0b/0B` for binary, Floats force decimal '.'. For g/G keep trailing `0`.
720
+ # | + | Show sign `+/-` depending on value's sign, changes `x`, `X`, `o`, `b`, `B` format to not use 2's complement form.
721
+ # | - | Left justify the value in the given width.
722
+ # | 0 | Pad with `0` instead of space for widths larger than value.
723
+ # | <[({\| | Defines an enclosing pair `<> [] () {} or \| \|` when used with a container type.
724
+ #
725
+ # ### Conversion to Boolean
726
+ #
727
+ # Accepts a single value as argument:
728
+ #
729
+ # * Float `0.0` is `false`, all other float values are `true`
730
+ # * Integer `0` is `false`, all other integer values are `true`
731
+ # * Strings
732
+ # * `true` if 'true', 'yes', 'y' (case independent compare)
733
+ # * `false` if 'false', 'no', 'n' (case independent compare)
734
+ # * Boolean is already boolean and is simply returned
735
+ #
736
+ # ### Conversion to Array and Tuple
737
+ #
738
+ # When given a single value as argument:
739
+ #
740
+ # * A non empty `Hash` is converted to an array matching `Array[Tuple[Any,Any], 1]`.
741
+ # * An empty `Hash` becomes an empty array.
742
+ # * An `Array` is simply returned.
743
+ # * An `Iterable[T]` is turned into an array of `T` instances.
744
+ # * A `Binary` is converted to an `Array[Integer[0,255]]` of byte values
745
+ #
746
+ # When given a second Boolean argument:
747
+ #
748
+ # * if `true`, a value that is not already an array is returned as a one element array.
749
+ # * if `false`, (the default), converts the first argument as shown above.
750
+ #
751
+ # @example Ensuring value is an array
752
+ #
753
+ # ```puppet
754
+ # $arr = Array($value, true)
755
+ # ```
756
+ #
757
+ # Conversion to a `Tuple` works exactly as conversion to an `Array`, only that the constructed array is
758
+ # asserted against the given tuple type.
759
+ #
760
+ # ### Conversion to Hash and Struct
761
+ #
762
+ # Accepts a single value as argument:
763
+ #
764
+ # * An empty `Array` becomes an empty `Hash`
765
+ # * An `Array` matching `Array[Tuple[Any,Any], 1]` is converted to a hash where each tuple describes a key/value entry
766
+ # * An `Array` with an even number of entries is interpreted as `[key1, val1, key2, val2, ...]`
767
+ # * An `Iterable` is turned into an `Array` and then converted to hash as per the array rules
768
+ # * A `Hash` is simply returned
769
+ #
770
+ # Alternatively, a tree can be constructed by giving two values; an array of tuples on the form `[path, value]`
771
+ # (where the `path` is the path from the root of a tree, and `value` the value at that position in the tree), and
772
+ # either the option `'tree'` (do not convert arrays to hashes except the top level), or
773
+ # `'hash_tree'` (convert all arrays to hashes).
774
+ #
775
+ # The tree/hash_tree forms of Hash creation are suited for transforming the result of an iteration
776
+ # using `tree_each` and subsequent filtering or mapping.
777
+ #
778
+ # @example Mapping a hash tree
779
+ #
780
+ # Mapping an arbitrary structure in a way that keeps the structure, but where some values are replaced
781
+ # can be done by using the `tree_each` function, mapping, and then constructing a new Hash from the result:
782
+ #
783
+ # ```puppet
784
+ # # A hash tree with 'water' at different locations
785
+ # $h = { a => { b => { x => 'water'}}, b => { y => 'water'} }
786
+ # # a helper function that turns water into wine
787
+ # function make_wine($x) { if $x == 'water' { 'wine' } else { $x } }
788
+ # # create a flattened tree with water turned into wine
789
+ # $flat_tree = $h.tree_each.map |$entry| { [$entry[0], make_wine($entry[1])] }
790
+ # # create a new Hash and log it
791
+ # notice Hash($flat_tree, 'hash_tree')
792
+ # ```
793
+ #
794
+ # Would notice the hash `{a => {b => {x => wine}}, b => {y => wine}}`
795
+ #
796
+ # Conversion to a `Struct` works exactly as conversion to a `Hash`, only that the constructed hash is
797
+ # asserted against the given struct type.
798
+ #
799
+ # ### Conversion to a Regexp
800
+ #
801
+ # A `String` can be converted into a `Regexp`
802
+ #
803
+ # **Example**: Converting a String into a Regexp
804
+ # ```puppet
805
+ # $s = '[a-z]+\.com'
806
+ # $r = Regexp($s)
807
+ # if('foo.com' =~ $r) {
808
+ # ...
809
+ # }
810
+ # ```
811
+ #
812
+ # ### Creating a SemVer
813
+ #
814
+ # A SemVer object represents a single [Semantic Version](http://semver.org/).
815
+ # It can be created from a String, individual values for its parts, or a hash specifying the value per part.
816
+ # See the specification at [semver.org](http://semver.org/) for the meaning of the SemVer's parts.
817
+ #
818
+ # The signatures are:
819
+ #
820
+ # ```puppet
821
+ # type PositiveInteger = Integer[0,default]
822
+ # type SemVerQualifier = Pattern[/\A(?<part>[0-9A-Za-z-]+)(?:\.\g<part>)*\Z/]
823
+ # type SemVerString = String[1]
824
+ # type SemVerHash =Struct[{
825
+ # major => PositiveInteger,
826
+ # minor => PositiveInteger,
827
+ # patch => PositiveInteger,
828
+ # Optional[prerelease] => SemVerQualifier,
829
+ # Optional[build] => SemVerQualifier
830
+ # }]
831
+ #
832
+ # function SemVer.new(SemVerString $str)
833
+ #
834
+ # function SemVer.new(
835
+ # PositiveInteger $major
836
+ # PositiveInteger $minor
837
+ # PositiveInteger $patch
838
+ # Optional[SemVerQualifier] $prerelease = undef
839
+ # Optional[SemVerQualifier] $build = undef
840
+ # )
841
+ #
842
+ # function SemVer.new(SemVerHash $hash_args)
843
+ # ```
844
+ #
845
+ # @example `SemVer` and `SemVerRange` usage
846
+ #
847
+ # ```puppet
848
+ # # As a type, SemVer can describe disjunct ranges which versions can be
849
+ # # matched against - here the type is constructed with two
850
+ # # SemVerRange objects.
851
+ # #
852
+ # $t = SemVer[
853
+ # SemVerRange('>=1.0.0 <2.0.0'),
854
+ # SemVerRange('>=3.0.0 <4.0.0')
855
+ # ]
856
+ # notice(SemVer('1.2.3') =~ $t) # true
857
+ # notice(SemVer('2.3.4') =~ $t) # false
858
+ # notice(SemVer('3.4.5') =~ $t) # true
859
+ # ```
860
+ #
861
+ # ### Creating a `SemVerRange`
862
+ #
863
+ # A `SemVerRange` object represents a range of `SemVer`. It can be created from
864
+ # a `String`, or from two `SemVer` instances, where either end can be given as
865
+ # a literal `default` to indicate infinity. The string format of a `SemVerRange` is specified by
866
+ # the [Semantic Version Range Grammar](https://github.com/npm/node-semver#ranges).
867
+ #
868
+ # > Use of the comparator sets described in the grammar (joining with `||`) is not supported.
869
+ #
870
+ # The signatures are:
871
+ #
872
+ # ```puppet
873
+ # type SemVerRangeString = String[1]
874
+ # type SemVerRangeHash = Struct[{
875
+ # min => Variant[Default, SemVer],
876
+ # Optional[max] => Variant[Default, SemVer],
877
+ # Optional[exclude_max] => Boolean
878
+ # }]
879
+ #
880
+ # function SemVerRange.new(
881
+ # SemVerRangeString $semver_range_string
882
+ # )
883
+ #
884
+ # function SemVerRange.new(
885
+ # Variant[Default,SemVer] $min
886
+ # Variant[Default,SemVer] $max
887
+ # Optional[Boolean] $exclude_max = undef
888
+ # )
889
+ #
890
+ # function SemVerRange.new(
891
+ # SemVerRangeHash $semver_range_hash
892
+ # )
893
+ # ```
894
+ #
895
+ # For examples of `SemVerRange` use see "Creating a SemVer"
896
+ #
897
+ # ### Creating a Binary
898
+ #
899
+ # A `Binary` object represents a sequence of bytes and it can be created from a String in Base64 format,
900
+ # an Array containing byte values. A Binary can also be created from a Hash containing the value to convert to
901
+ # a `Binary`.
902
+ #
903
+ # The signatures are:
904
+ #
905
+ # ```puppet
906
+ # type ByteInteger = Integer[0,255]
907
+ # type Base64Format = Enum["%b", "%u", "%B", "%s"]
908
+ # type StringHash = Struct[{value => String, "format" => Optional[Base64Format]}]
909
+ # type ArrayHash = Struct[{value => Array[ByteInteger]}]
910
+ # type BinaryArgsHash = Variant[StringHash, ArrayHash]
911
+ #
912
+ # function Binary.new(
913
+ # String $base64_str,
914
+ # Optional[Base64Format] $format
915
+ # )
916
+ #
917
+ #
918
+ # function Binary.new(
919
+ # Array[ByteInteger] $byte_array
920
+ # }
921
+ #
922
+ # # Same as for String, or for Array, but where arguments are given in a Hash.
923
+ # function Binary.new(BinaryArgsHash $hash_args)
924
+ # ```
925
+ #
926
+ # The formats have the following meaning:
927
+ #
928
+ # | format | explanation |
929
+ # | ---- | ---- |
930
+ # | B | The data is in base64 strict encoding
931
+ # | u | The data is in URL safe base64 encoding
932
+ # | b | The data is in base64 encoding, padding as required by base64 strict, is added by default
933
+ # | s | The data is a puppet string. The string must be valid UTF-8, or convertible to UTF-8 or an error is raised.
934
+ # | r | (Ruby Raw) the byte sequence in the given string is used verbatim irrespective of possible encoding errors
935
+ #
936
+ # * The default format is `%B`.
937
+ # * Note that the format `%r` should be used sparingly, or not at all. It exists for backwards compatibility reasons when someone receiving
938
+ # a string from some function and that string should be treated as Binary. Such code should be changed to return a Binary instead of a String.
939
+ #
940
+ # @example Creating a Binary
941
+ #
942
+ # ```puppet
943
+ # # create the binary content "abc"
944
+ # $a = Binary('YWJj')
945
+ #
946
+ # # create the binary content from content in a module's file
947
+ # $b = binary_file('mymodule/mypicture.jpg')
948
+ # ```
949
+ #
950
+ # * Since 4.5.0
951
+ # * Binary type since 4.8.0
952
+ #
953
+ # ### Creating an instance of a `Type` using the `Init` type
954
+ #
955
+ # The type `Init[T]` describes a value that can be used when instantiating a type. When used as the first argument in a call to `new`, it
956
+ # will dispatch the call to its contained type and optionally augment the parameter list with additional arguments.
957
+ #
958
+ # @example Creating an instance of Integer using Init[Integer]
959
+ #
960
+ # ```puppet
961
+ # # The following declaration
962
+ # $x = Init[Integer].new('128')
963
+ # # is exactly the same as
964
+ # $x = Integer.new('128')
965
+ # ```
966
+ #
967
+ # or, with base 16 and using implicit new
968
+ #
969
+ # ```puppet
970
+ # # The following declaration
971
+ # $x = Init[Integer,16]('80')
972
+ # # is exactly the same as
973
+ # $x = Integer('80', 16)
974
+ # ```
975
+ #
976
+ # @example Creating an instance of String using a predefined format
977
+ #
978
+ # ```puppet
979
+ # $fmt = Init[String,'%#x']
980
+ # notice($fmt(256)) # will notice '0x100'
981
+ # ```
982
+ #
983
+ # @since 4.5.0
984
+ #
985
+ Puppet::Functions.create_function(:new, Puppet::Functions::InternalFunction) do
986
+ dispatch :new_instance do
987
+ scope_param
988
+ param 'Type', :type
989
+ repeated_param 'Any', :args
990
+ optional_block_param
991
+ end
992
+
993
+ def new_instance(scope, t, *args)
994
+ return args[0] if args.size == 1 && !t.is_a?(Puppet::Pops::Types::PInitType) && t.instance?(args[0])
995
+
996
+ result = assert_type(t, new_function_for_type(t).call(scope, *args))
997
+ block_given? ? yield(result) : result
998
+ end
999
+
1000
+ def new_function_for_type(t)
1001
+ @new_function_cache ||= {}
1002
+
1003
+ unless @new_function_cache.key?(t)
1004
+ @new_function_cache[t] = t.new_function.new(nil, loader)
1005
+ end
1006
+
1007
+ @new_function_cache[t]
1008
+ end
1009
+
1010
+ def assert_type(type, value)
1011
+ Puppet::Pops::Types::TypeAsserter.assert_instance_of(['Converted value from %s.new()', type], type, value)
1012
+ end
1013
+ end