puppet 4.5.3-x86-mingw32 → 4.6.1-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of puppet might be problematic. Click here for more details.

Files changed (422) hide show
  1. checksums.yaml +7 -0
  2. data/Gemfile +10 -1
  3. data/ext/debian/control +2 -4
  4. data/ext/project_data.yaml +4 -4
  5. data/install.rb +6 -2
  6. data/lib/puppet.rb +3 -1
  7. data/lib/puppet/agent/locker.rb +1 -1
  8. data/lib/puppet/application.rb +6 -4
  9. data/lib/puppet/application/agent.rb +2 -1
  10. data/lib/puppet/application/cert.rb +35 -2
  11. data/lib/puppet/application/device.rb +1 -1
  12. data/lib/puppet/application/generate.rb +5 -0
  13. data/lib/puppet/application/lookup.rb +3 -3
  14. data/lib/puppet/application_support.rb +1 -1
  15. data/lib/puppet/compilable_resource_type.rb +15 -0
  16. data/lib/puppet/configurer.rb +67 -10
  17. data/lib/puppet/configurer/plugin_handler.rb +2 -4
  18. data/lib/puppet/data_providers/hiera_config.rb +1 -1
  19. data/lib/puppet/defaults.rb +34 -7
  20. data/lib/puppet/environments.rb +4 -2
  21. data/lib/puppet/error.rb +1 -1
  22. data/lib/puppet/external/dot.rb +1 -1
  23. data/lib/puppet/face/ca.rb +4 -1
  24. data/lib/puppet/face/certificate.rb +7 -1
  25. data/lib/puppet/face/epp.rb +5 -5
  26. data/lib/puppet/face/generate.rb +64 -0
  27. data/lib/puppet/face/help.rb +19 -13
  28. data/lib/puppet/face/man.rb +1 -1
  29. data/lib/puppet/feature/external_facts.rb +1 -1
  30. data/lib/puppet/file_system.rb +16 -0
  31. data/lib/puppet/file_system/file_impl.rb +5 -0
  32. data/lib/puppet/file_system/memory_impl.rb +4 -0
  33. data/lib/puppet/file_system/path_pattern.rb +1 -0
  34. data/lib/puppet/file_system/windows.rb +19 -0
  35. data/lib/puppet/functions.rb +3 -5
  36. data/lib/puppet/functions/assert_type.rb +1 -1
  37. data/lib/puppet/functions/defined.rb +7 -5
  38. data/lib/puppet/functions/dig.rb +2 -18
  39. data/lib/puppet/functions/hiera.rb +1 -1
  40. data/lib/puppet/functions/lest.rb +1 -37
  41. data/lib/puppet/functions/new.rb +2 -473
  42. data/lib/puppet/functions/reverse_each.rb +2 -59
  43. data/lib/puppet/functions/scanf.rb +4 -4
  44. data/lib/puppet/functions/step.rb +1 -63
  45. data/lib/puppet/functions/then.rb +1 -61
  46. data/lib/puppet/functions/type.rb +1 -40
  47. data/lib/puppet/functions/unwrap.rb +40 -0
  48. data/lib/puppet/generate/models/type/property.rb +70 -0
  49. data/lib/puppet/generate/models/type/type.rb +57 -0
  50. data/lib/puppet/generate/templates/type/pcore.erb +41 -0
  51. data/lib/puppet/generate/type.rb +239 -0
  52. data/lib/puppet/graph/simple_graph.rb +2 -6
  53. data/lib/puppet/indirector/catalog/static_compiler.rb +5 -2
  54. data/lib/puppet/indirector/facts/facter.rb +1 -1
  55. data/lib/puppet/indirector/key/ca.rb +2 -2
  56. data/lib/puppet/indirector/request.rb +25 -4
  57. data/lib/puppet/indirector/rest.rb +73 -3
  58. data/lib/puppet/info_service/class_information_service.rb +1 -2
  59. data/lib/puppet/interface/documentation.rb +1 -1
  60. data/lib/puppet/loaders.rb +2 -0
  61. data/lib/puppet/metatype/manager.rb +6 -6
  62. data/lib/puppet/module.rb +8 -1
  63. data/lib/puppet/module_tool.rb +2 -2
  64. data/lib/puppet/module_tool/checksums.rb +1 -1
  65. data/lib/puppet/module_tool/errors/installer.rb +2 -2
  66. data/lib/puppet/module_tool/metadata.rb +1 -1
  67. data/lib/puppet/network/http/api/indirected_routes.rb +23 -32
  68. data/lib/puppet/network/http/rack/rest.rb +15 -1
  69. data/lib/puppet/network/rights.rb +1 -11
  70. data/lib/puppet/node/environment.rb +7 -3
  71. data/lib/puppet/node/facts.rb +1 -1
  72. data/lib/puppet/parameter.rb +23 -3
  73. data/lib/puppet/parameter/boolean.rb +1 -1
  74. data/lib/puppet/parameter/value.rb +1 -1
  75. data/lib/puppet/parser.rb +0 -1
  76. data/lib/puppet/parser/ast/pops_bridge.rb +1 -1
  77. data/lib/puppet/parser/ast/resource.rb +5 -0
  78. data/lib/puppet/parser/ast/resource_instance.rb +5 -1
  79. data/lib/puppet/parser/ast/resourceparam.rb +5 -0
  80. data/lib/puppet/parser/compiler.rb +14 -17
  81. data/lib/puppet/parser/compiler/catalog_validator/relationship_validator.rb +1 -1
  82. data/lib/puppet/parser/environment_compiler.rb +10 -0
  83. data/lib/puppet/parser/functions/create_resources.rb +39 -24
  84. data/lib/puppet/parser/functions/defined.rb +2 -26
  85. data/lib/puppet/parser/functions/dig.rb +29 -0
  86. data/lib/puppet/parser/functions/lest.rb +49 -0
  87. data/lib/puppet/parser/functions/new.rb +530 -0
  88. data/lib/puppet/parser/functions/require.rb +1 -1
  89. data/lib/puppet/parser/functions/reverse_each.rb +83 -0
  90. data/lib/puppet/parser/functions/scanf.rb +4 -4
  91. data/lib/puppet/parser/functions/step.rb +84 -0
  92. data/lib/puppet/parser/functions/then.rb +73 -0
  93. data/lib/puppet/parser/functions/type.rb +53 -0
  94. data/lib/puppet/parser/resource.rb +16 -7
  95. data/lib/puppet/parser/scope.rb +36 -28
  96. data/lib/puppet/parser/type_loader.rb +1 -1
  97. data/lib/puppet/plugins/data_providers/data_provider.rb +1 -1
  98. data/lib/puppet/pops.rb +13 -0
  99. data/lib/puppet/pops/adapters.rb +49 -49
  100. data/lib/puppet/pops/binder/scheme_handler/confdir_scheme.rb +1 -1
  101. data/lib/puppet/pops/evaluator/access_operator.rb +39 -2
  102. data/lib/puppet/pops/evaluator/closure.rb +39 -13
  103. data/lib/puppet/pops/evaluator/collector_transformer.rb +10 -1
  104. data/lib/puppet/pops/evaluator/evaluator_impl.rb +16 -11
  105. data/lib/puppet/pops/evaluator/external_syntax_support.rb +1 -1
  106. data/lib/puppet/pops/evaluator/json_strict_literal_evaluator.rb +0 -1
  107. data/lib/puppet/pops/evaluator/literal_evaluator.rb +0 -1
  108. data/lib/puppet/pops/evaluator/relationship_operator.rb +1 -2
  109. data/lib/puppet/pops/evaluator/runtime3_resource_support.rb +119 -0
  110. data/lib/puppet/pops/evaluator/runtime3_support.rb +19 -45
  111. data/lib/puppet/pops/functions/function.rb +5 -0
  112. data/lib/puppet/pops/issues.rb +1 -1
  113. data/lib/puppet/pops/label_provider.rb +2 -2
  114. data/lib/puppet/pops/loader/base_loader.rb +12 -15
  115. data/lib/puppet/pops/loader/loader.rb +15 -50
  116. data/lib/puppet/pops/loader/loader_paths.rb +28 -2
  117. data/lib/puppet/pops/loader/module_loaders.rb +16 -1
  118. data/lib/puppet/pops/loader/null_loader.rb +17 -1
  119. data/lib/puppet/pops/loader/puppet_function_instantiator.rb +12 -11
  120. data/lib/puppet/pops/loader/puppet_resource_type_impl_instantiator.rb +80 -0
  121. data/lib/puppet/pops/loader/ruby_function_instantiator.rb +2 -3
  122. data/lib/puppet/pops/loader/runtime3_type_loader.rb +52 -13
  123. data/lib/puppet/pops/loader/static_loader.rb +55 -0
  124. data/lib/puppet/pops/loader/type_definition_instantiator.rb +30 -14
  125. data/lib/puppet/pops/loader/typed_name.rb +50 -0
  126. data/lib/puppet/pops/loaders.rb +64 -19
  127. data/lib/puppet/pops/merge_strategy.rb +7 -7
  128. data/lib/puppet/pops/migration/migration_checker.rb +4 -0
  129. data/lib/puppet/pops/model/model_label_provider.rb +2 -0
  130. data/lib/puppet/pops/parser/egrammar.ra +8 -5
  131. data/lib/puppet/pops/parser/eparser.rb +1550 -1498
  132. data/lib/puppet/pops/parser/evaluating_parser.rb +1 -1
  133. data/lib/puppet/pops/parser/interpolation_support.rb +7 -0
  134. data/lib/puppet/pops/parser/lexer2.rb +14 -1
  135. data/lib/puppet/pops/parser/locator.rb +30 -1
  136. data/lib/puppet/pops/parser/parser_support.rb +0 -3
  137. data/lib/puppet/pops/parser/slurp_support.rb +3 -3
  138. data/lib/puppet/pops/patterns.rb +9 -1
  139. data/lib/puppet/pops/pcore.rb +67 -11
  140. data/lib/puppet/pops/puppet_stack.rb +43 -0
  141. data/lib/puppet/pops/resource/param.rb +51 -0
  142. data/lib/puppet/pops/resource/resource_type_impl.rb +301 -0
  143. data/lib/puppet/pops/resource/resource_type_set.pcore +21 -0
  144. data/lib/puppet/pops/serialization.rb +17 -0
  145. data/lib/puppet/pops/serialization/abstract_reader.rb +149 -0
  146. data/lib/puppet/pops/serialization/abstract_writer.rb +179 -0
  147. data/lib/puppet/pops/serialization/deserializer.rb +60 -0
  148. data/lib/puppet/pops/serialization/extension.rb +126 -0
  149. data/lib/puppet/pops/serialization/instance_reader.rb +19 -0
  150. data/lib/puppet/pops/serialization/instance_writer.rb +14 -0
  151. data/lib/puppet/pops/serialization/json.rb +247 -0
  152. data/lib/puppet/pops/serialization/object.rb +63 -0
  153. data/lib/puppet/pops/serialization/rgen.rb +151 -0
  154. data/lib/puppet/pops/serialization/serializer.rb +91 -0
  155. data/lib/puppet/pops/serialization/time_factory.rb +66 -0
  156. data/lib/puppet/pops/types/annotatable.rb +36 -0
  157. data/lib/puppet/pops/types/implementation_registry.rb +3 -8
  158. data/lib/puppet/pops/types/p_meta_type.rb +83 -0
  159. data/lib/puppet/pops/types/p_object_type.rb +110 -117
  160. data/lib/puppet/pops/types/p_runtime_type.rb +13 -0
  161. data/lib/puppet/pops/types/p_sem_ver_range_type.rb +23 -0
  162. data/lib/puppet/pops/types/p_sem_ver_type.rb +30 -2
  163. data/lib/puppet/pops/types/p_sensitive_type.rb +69 -0
  164. data/lib/puppet/pops/types/p_type_set_type.rb +361 -0
  165. data/lib/puppet/pops/types/puppet_object.rb +0 -5
  166. data/lib/puppet/pops/types/ruby_generator.rb +9 -2
  167. data/lib/puppet/pops/types/type_calculator.rb +6 -1
  168. data/lib/puppet/pops/types/type_factory.rb +14 -12
  169. data/lib/puppet/pops/types/type_formatter.rb +78 -33
  170. data/lib/puppet/pops/types/type_mismatch_describer.rb +0 -2
  171. data/lib/puppet/pops/types/type_parser.rb +27 -2
  172. data/lib/puppet/pops/types/type_set_reference.rb +59 -0
  173. data/lib/puppet/pops/types/types.rb +366 -13
  174. data/lib/puppet/pops/validation.rb +4 -4
  175. data/lib/puppet/pops/validation/checker4_0.rb +5 -2
  176. data/lib/puppet/pops/visitor.rb +2 -2
  177. data/lib/puppet/property.rb +64 -5
  178. data/lib/puppet/provider.rb +1 -1
  179. data/lib/puppet/provider/aixobject.rb +3 -3
  180. data/lib/puppet/provider/group/aix.rb +4 -4
  181. data/lib/puppet/provider/macauthorization/macauthorization.rb +1 -1
  182. data/lib/puppet/provider/mailalias/aliases.rb +1 -1
  183. data/lib/puppet/provider/mcx/mcxcontent.rb +2 -2
  184. data/lib/puppet/provider/mount/parsed.rb +1 -1
  185. data/lib/puppet/provider/nameservice/directoryservice.rb +5 -5
  186. data/lib/puppet/provider/package/appdmg.rb +3 -3
  187. data/lib/puppet/provider/package/apple.rb +1 -1
  188. data/lib/puppet/provider/package/dnf.rb +5 -0
  189. data/lib/puppet/provider/package/nim.rb +1 -1
  190. data/lib/puppet/provider/package/pacman.rb +2 -2
  191. data/lib/puppet/provider/package/pip.rb +5 -3
  192. data/lib/puppet/provider/package/pip3.rb +1 -1
  193. data/lib/puppet/provider/package/pkg.rb +5 -5
  194. data/lib/puppet/provider/package/pkgdmg.rb +4 -4
  195. data/lib/puppet/provider/package/pkgin.rb +1 -1
  196. data/lib/puppet/provider/package/pkgutil.rb +1 -1
  197. data/lib/puppet/provider/package/portage.rb +48 -8
  198. data/lib/puppet/provider/package/sun.rb +1 -1
  199. data/lib/puppet/provider/package/tdnf.rb +28 -0
  200. data/lib/puppet/provider/package/yum.rb +22 -4
  201. data/lib/puppet/provider/parsedfile.rb +2 -2
  202. data/lib/puppet/provider/service/base.rb +1 -1
  203. data/lib/puppet/provider/service/bsd.rb +1 -1
  204. data/lib/puppet/provider/service/daemontools.rb +2 -2
  205. data/lib/puppet/provider/service/debian.rb +3 -3
  206. data/lib/puppet/provider/service/init.rb +5 -3
  207. data/lib/puppet/provider/service/launchd.rb +16 -2
  208. data/lib/puppet/provider/service/runit.rb +1 -1
  209. data/lib/puppet/provider/service/smf.rb +8 -1
  210. data/lib/puppet/provider/service/systemd.rb +39 -6
  211. data/lib/puppet/provider/ssh_authorized_key/parsed.rb +1 -1
  212. data/lib/puppet/provider/user/aix.rb +3 -2
  213. data/lib/puppet/provider/user/directoryservice.rb +4 -3
  214. data/lib/puppet/provider/user/hpux.rb +1 -1
  215. data/lib/puppet/provider/user/user_role_add.rb +1 -1
  216. data/lib/puppet/provider/user/windows_adsi.rb +3 -0
  217. data/lib/puppet/provider/zfs/zfs.rb +1 -1
  218. data/lib/puppet/reference/type.rb +1 -1
  219. data/lib/puppet/resource.rb +33 -7
  220. data/lib/puppet/resource/capability_finder.rb +74 -54
  221. data/lib/puppet/resource/status.rb +11 -2
  222. data/lib/puppet/settings.rb +17 -6
  223. data/lib/puppet/settings/environment_conf.rb +1 -1
  224. data/lib/puppet/settings/server_list_setting.rb +20 -0
  225. data/lib/puppet/ssl/certificate_authority.rb +32 -9
  226. data/lib/puppet/ssl/certificate_authority/interface.rb +164 -24
  227. data/lib/puppet/ssl/host.rb +3 -3
  228. data/lib/puppet/ssl/oids.rb +10 -0
  229. data/lib/puppet/ssl/validator/default_validator.rb +2 -2
  230. data/lib/puppet/test/test_helper.rb +2 -2
  231. data/lib/puppet/transaction.rb +12 -0
  232. data/lib/puppet/transaction/additional_resource_generator.rb +1 -1
  233. data/lib/puppet/transaction/event.rb +29 -2
  234. data/lib/puppet/transaction/event_manager.rb +1 -1
  235. data/lib/puppet/transaction/persistence.rb +84 -0
  236. data/lib/puppet/transaction/report.rb +49 -2
  237. data/lib/puppet/transaction/resource_harness.rb +98 -18
  238. data/lib/puppet/type.rb +63 -21
  239. data/lib/puppet/type/augeas.rb +3 -3
  240. data/lib/puppet/type/cron.rb +1 -1
  241. data/lib/puppet/type/file.rb +39 -2
  242. data/lib/puppet/type/file/data_sync.rb +13 -5
  243. data/lib/puppet/type/host.rb +1 -1
  244. data/lib/puppet/type/mount.rb +2 -6
  245. data/lib/puppet/type/notify.rb +1 -1
  246. data/lib/puppet/type/package.rb +1 -1
  247. data/lib/puppet/type/resources.rb +1 -1
  248. data/lib/puppet/type/scheduled_task.rb +1 -1
  249. data/lib/puppet/type/ssh_authorized_key.rb +2 -2
  250. data/lib/puppet/type/tidy.rb +1 -1
  251. data/lib/puppet/type/yumrepo.rb +3 -3
  252. data/lib/puppet/type/zone.rb +1 -1
  253. data/lib/puppet/util.rb +2 -2
  254. data/lib/puppet/util/classgen.rb +1 -1
  255. data/lib/puppet/util/command_line.rb +6 -2
  256. data/lib/puppet/util/command_line/trollop.rb +1 -1
  257. data/lib/puppet/util/execution.rb +2 -2
  258. data/lib/puppet/util/http_proxy.rb +1 -1
  259. data/lib/puppet/util/inifile.rb +1 -1
  260. data/lib/puppet/util/instance_loader.rb +1 -1
  261. data/lib/puppet/util/logging.rb +1 -1
  262. data/lib/puppet/util/multi_match.rb +1 -1
  263. data/lib/puppet/util/plist.rb +15 -5
  264. data/lib/puppet/util/profiler.rb +1 -1
  265. data/lib/puppet/util/profiler/around_profiler.rb +1 -1
  266. data/lib/puppet/util/psych_support.rb +1 -1
  267. data/lib/puppet/util/rdoc.rb +2 -2
  268. data/lib/puppet/util/rubygems.rb +1 -1
  269. data/lib/puppet/util/watcher/periodic_watcher.rb +2 -2
  270. data/lib/puppet/util/windows/access_control_entry.rb +1 -1
  271. data/lib/puppet/util/windows/adsi.rb +30 -8
  272. data/lib/puppet/util/windows/api_types.rb +1 -1
  273. data/lib/puppet/util/windows/file.rb +59 -0
  274. data/lib/puppet/util/windows/process.rb +10 -0
  275. data/lib/puppet/util/windows/security.rb +1 -1
  276. data/lib/puppet/util/windows/user.rb +22 -4
  277. data/lib/puppet/util/yaml.rb +15 -3
  278. data/lib/puppet/vendor/deep_merge/test/test_deep_merge.rb +1 -1
  279. data/lib/puppet/vendor/rgen_patch.rb +1 -1
  280. data/lib/puppet/version.rb +2 -2
  281. data/spec/fixtures/unit/pops/loaders/loaders/no_modules/manifests/site.pp +10 -0
  282. data/spec/integration/agent/logging_spec.rb +15 -14
  283. data/spec/integration/application/apply_spec.rb +1 -0
  284. data/spec/integration/directory_environments_spec.rb +16 -0
  285. data/spec/integration/environments/settings_spec.rb +32 -4
  286. data/spec/integration/faces/documentation_spec.rb +1 -1
  287. data/spec/integration/network/http/api/indirected_routes_spec.rb +33 -0
  288. data/spec/integration/node/environment_spec.rb +21 -0
  289. data/spec/integration/parser/collection_spec.rb +10 -0
  290. data/spec/integration/parser/compiler_spec.rb +76 -840
  291. data/spec/integration/parser/functions/require_spec.rb +3 -3
  292. data/spec/integration/parser/parameter_defaults_spec.rb +6 -2
  293. data/spec/integration/parser/pcore_resource_spec.rb +208 -0
  294. data/spec/integration/parser/resource_expressions_spec.rb +4 -2
  295. data/spec/integration/provider/yumrepo_spec.rb +4 -1
  296. data/spec/integration/transaction/report_spec.rb +666 -0
  297. data/spec/integration/type/file_spec.rb +11 -12
  298. data/spec/integration/util/windows/adsi_spec.rb +99 -0
  299. data/spec/integration/util/windows/principal_spec.rb +109 -60
  300. data/spec/integration/util/windows/process_spec.rb +4 -2
  301. data/spec/integration/util/windows/security_spec.rb +34 -8
  302. data/spec/integration/util/windows/user_spec.rb +26 -4
  303. data/spec/lib/puppet_spec/files.rb +2 -2
  304. data/spec/lib/puppet_spec/network.rb +12 -8
  305. data/spec/shared_examples/rhel_package_provider.rb +341 -0
  306. data/spec/spec_helper.rb +8 -2
  307. data/spec/unit/application/cert_spec.rb +20 -0
  308. data/spec/unit/configurer/plugin_handler_spec.rb +0 -26
  309. data/spec/unit/configurer_spec.rb +46 -0
  310. data/spec/unit/defaults_spec.rb +14 -0
  311. data/spec/unit/face/generate_spec.rb +230 -0
  312. data/spec/unit/face/help_spec.rb +53 -0
  313. data/spec/unit/face/parser_spec.rb +6 -0
  314. data/spec/unit/face/plugin_spec.rb +0 -4
  315. data/spec/unit/file_system_spec.rb +85 -0
  316. data/spec/unit/functions/lookup_spec.rb +4 -4
  317. data/spec/unit/functions/match_spec.rb +2 -2
  318. data/spec/unit/functions/regsubst_spec.rb +1 -1
  319. data/spec/unit/functions/split_spec.rb +1 -1
  320. data/spec/unit/functions/unwrap_spec.rb +29 -0
  321. data/spec/unit/functions/versioncmp_spec.rb +1 -1
  322. data/spec/unit/functions4_spec.rb +8 -8
  323. data/spec/unit/indirector/facts/facter_spec.rb +1 -9
  324. data/spec/unit/indirector/rest_spec.rb +95 -9
  325. data/spec/unit/module_spec.rb +43 -7
  326. data/spec/unit/module_tool/applications/installer_spec.rb +10 -1
  327. data/spec/unit/module_tool/applications/unpacker_spec.rb +2 -1
  328. data/spec/unit/module_tool/applications/upgrader_spec.rb +8 -0
  329. data/spec/unit/module_tool/tar/mini_spec.rb +3 -3
  330. data/spec/unit/network/http/api/indirected_routes_spec.rb +49 -58
  331. data/spec/unit/network/http/api/master/v3_spec.rb +7 -4
  332. data/spec/unit/network/rights_spec.rb +1 -1
  333. data/spec/unit/parameter_spec.rb +11 -0
  334. data/spec/unit/parser/compiler_spec.rb +19 -33
  335. data/spec/unit/{appmgmt_spec.rb → parser/environment_compiler_spec.rb} +12 -1
  336. data/spec/unit/parser/functions/create_resources_spec.rb +76 -4
  337. data/spec/unit/parser/functions/require_spec.rb +2 -2
  338. data/spec/unit/parser/resource_spec.rb +21 -11
  339. data/spec/unit/parser/scope_spec.rb +1 -5
  340. data/spec/unit/pops/evaluator/evaluating_parser_spec.rb +1 -1
  341. data/spec/unit/pops/loaders/dependency_loader_spec.rb +1 -1
  342. data/spec/unit/pops/loaders/loader_paths_spec.rb +1 -1
  343. data/spec/unit/pops/loaders/loaders_spec.rb +63 -5
  344. data/spec/unit/pops/loaders/module_loaders_spec.rb +2 -2
  345. data/spec/unit/pops/loaders/static_loader_spec.rb +1 -1
  346. data/spec/unit/pops/parser/lexer2_spec.rb +27 -3
  347. data/spec/unit/pops/parser/parse_basic_expressions_spec.rb +8 -0
  348. data/spec/unit/pops/parser/parse_calls_spec.rb +9 -0
  349. data/spec/unit/pops/puppet_stack_spec.rb +79 -0
  350. data/spec/unit/pops/resource/resource_type_impl_spec.rb +37 -0
  351. data/spec/unit/pops/serialization/packer_spec.rb +153 -0
  352. data/spec/unit/pops/serialization/rgen_spec.rb +88 -0
  353. data/spec/unit/pops/serialization/serialization_spec.rb +228 -0
  354. data/spec/unit/pops/types/p_object_type_spec.rb +44 -2
  355. data/spec/unit/pops/types/p_sem_ver_type_spec.rb +42 -0
  356. data/spec/unit/pops/types/p_sensitive_type_spec.rb +139 -0
  357. data/spec/unit/pops/types/p_type_set_type_spec.rb +424 -0
  358. data/spec/unit/pops/types/ruby_generator_spec.rb +497 -181
  359. data/spec/unit/pops/types/type_calculator_spec.rb +10 -4
  360. data/spec/unit/pops/types/type_formatter_spec.rb +1 -1
  361. data/spec/unit/pops/types/type_mismatch_describer_spec.rb +2 -2
  362. data/spec/unit/pops/types/type_parser_spec.rb +1 -1
  363. data/spec/unit/pops/types/types_spec.rb +1 -1
  364. data/spec/unit/pops/validator/validator_spec.rb +18 -1
  365. data/spec/unit/property_spec.rb +48 -11
  366. data/spec/unit/provider/group/windows_adsi_spec.rb +11 -1
  367. data/spec/unit/provider/package/dnf_spec.rb +1 -99
  368. data/spec/unit/provider/package/pacman_spec.rb +4 -4
  369. data/spec/unit/provider/package/pip_spec.rb +14 -0
  370. data/spec/unit/provider/package/pkg_spec.rb +6 -0
  371. data/spec/unit/provider/package/pkgdmg_spec.rb +0 -3
  372. data/spec/unit/provider/package/portage_spec.rb +64 -8
  373. data/spec/unit/provider/package/tdnf_spec.rb +18 -0
  374. data/spec/unit/provider/package/windows/package_spec.rb +4 -1
  375. data/spec/unit/provider/package/windows_spec.rb +8 -2
  376. data/spec/unit/provider/package/yum_spec.rb +6 -377
  377. data/spec/unit/provider/service/base_spec.rb +6 -0
  378. data/spec/unit/provider/service/debian_spec.rb +16 -7
  379. data/spec/unit/provider/service/gentoo_spec.rb +6 -0
  380. data/spec/unit/provider/service/init_spec.rb +7 -0
  381. data/spec/unit/provider/service/launchd_spec.rb +35 -4
  382. data/spec/unit/provider/service/openrc_spec.rb +6 -0
  383. data/spec/unit/provider/service/smf_spec.rb +31 -6
  384. data/spec/unit/provider/service/src_spec.rb +6 -0
  385. data/spec/unit/provider/service/systemd_spec.rb +70 -20
  386. data/spec/unit/provider/service/upstart_spec.rb +6 -0
  387. data/spec/unit/provider/user/aix_spec.rb +7 -0
  388. data/spec/unit/provider/user/directoryservice_spec.rb +30 -1
  389. data/spec/unit/provider/user/windows_adsi_spec.rb +19 -0
  390. data/spec/unit/resource/capability_finder_spec.rb +51 -3
  391. data/spec/unit/resource/catalog_spec.rb +5 -0
  392. data/spec/unit/resource/type_spec.rb +2 -2
  393. data/spec/unit/resource_spec.rb +19 -0
  394. data/spec/unit/settings_spec.rb +13 -0
  395. data/spec/unit/ssl/certificate_authority/interface_spec.rb +176 -10
  396. data/spec/unit/ssl/certificate_authority_spec.rb +63 -22
  397. data/spec/unit/ssl/host_spec.rb +1 -1
  398. data/spec/unit/ssl/oids_spec.rb +24 -21
  399. data/spec/unit/transaction/event_spec.rb +3 -1
  400. data/spec/unit/transaction/persistence_spec.rb +173 -0
  401. data/spec/unit/transaction/report_spec.rb +64 -1
  402. data/spec/unit/transaction/resource_harness_spec.rb +91 -0
  403. data/spec/unit/type/file/content_spec.rb +47 -15
  404. data/spec/unit/type/file_spec.rb +28 -0
  405. data/spec/unit/type/mount_spec.rb +5 -12
  406. data/spec/unit/type/yumrepo_spec.rb +1 -5
  407. data/spec/unit/type_spec.rb +32 -0
  408. data/spec/unit/util/command_line_spec.rb +11 -0
  409. data/spec/unit/util/execution_spec.rb +1 -1
  410. data/spec/unit/util/plist_spec.rb +16 -3
  411. data/spec/unit/util/storage_spec.rb +4 -1
  412. data/spec/unit/util/windows/adsi_spec.rb +23 -2
  413. data/spec/unit/util/windows/file_spec.rb +56 -1
  414. data/spec/unit/util/windows/sid_spec.rb +31 -7
  415. data/spec/unit/util/yaml_spec.rb +12 -0
  416. data/spec/unit/util_spec.rb +87 -20
  417. metadata +91 -48
  418. data/ext/puppetlisten/puppetlisten.rb +0 -77
  419. data/ext/puppetlisten/puppetrun.rb +0 -38
  420. data/lib/puppet/resource/type_collection_helper.rb +0 -7
  421. data/spec/unit/parser/functions/defined_spec.rb +0 -120
  422. data/spec/unit/resource/type_collection_helper_spec.rb +0 -24
@@ -44,7 +44,7 @@
44
44
  # When the function is called, puppet searches the signatures for one that
45
45
  # matches the supplied arguments. Each signature is part of a dispatch, which
46
46
  # specifies the method that should be called for that signature. When a
47
- # matching signature is found, the corrosponding method is called.
47
+ # matching signature is found, the corresponding method is called.
48
48
  #
49
49
  # Documentation for the function should be placed as comments to the
50
50
  # implementation method(s).
@@ -272,9 +272,8 @@ module Puppet::Functions
272
272
 
273
273
  # @api private
274
274
  def self.builder
275
- @type_parser ||= Puppet::Pops::Types::TypeParser.new
276
275
  @all_callables ||= Puppet::Pops::Types::TypeFactory.all_callables
277
- DispatcherBuilder.new(dispatcher, @type_parser, @all_callables, loader)
276
+ DispatcherBuilder.new(dispatcher, Puppet::Pops::Types::TypeParser.singleton, @all_callables, loader)
278
277
  end
279
278
 
280
279
  # Dispatch any calls that match the signature to the provided method name.
@@ -602,9 +601,8 @@ module Puppet::Functions
602
601
  class InternalFunction < Function
603
602
  # @api private
604
603
  def self.builder
605
- @type_parser ||= Puppet::Pops::Types::TypeParser.new
606
604
  @all_callables ||= Puppet::Pops::Types::TypeFactory.all_callables
607
- InternalDispatchBuilder.new(dispatcher, @type_parser, @all_callables, loader)
605
+ InternalDispatchBuilder.new(dispatcher, Puppet::Pops::Types::TypeParser.singleton, @all_callables, loader)
608
606
  end
609
607
 
610
608
  # Defines class level injected attribute with reader method
@@ -89,7 +89,7 @@ Puppet::Functions.create_function(:assert_type, Puppet::Functions::InternalFunct
89
89
  # @param value [Object] the value to assert
90
90
  #
91
91
  def assert_type_s(scope, type_string, value, &proc)
92
- t = Puppet::Pops::Types::TypeParser.new.parse(type_string, scope)
92
+ t = Puppet::Pops::Types::TypeParser.singleton.parse(type_string, scope)
93
93
  block_given? ? assert_type(t, value, &proc) : assert_type(t, value)
94
94
  end
95
95
  end
@@ -105,6 +105,7 @@ Puppet::Functions.create_function(:'defined', Puppet::Functions::InternalFunctio
105
105
  end
106
106
 
107
107
  def is_defined(scope, *vals)
108
+ env = scope.environment
108
109
  vals.any? do |val|
109
110
  case val
110
111
  when String
@@ -116,11 +117,11 @@ Puppet::Functions.create_function(:'defined', Puppet::Functions::InternalFunctio
116
117
  next nil
117
118
  when 'main'
118
119
  # Find the main class (known as ''), it does not have to be in the catalog
119
- scope.find_hostclass('')
120
+ Puppet::Pops::Evaluator::Runtime3ResourceSupport.find_main_class(scope)
120
121
  else
121
122
  # Find a resource type, definition or class definition
122
- scope.find_resource_type(val) || scope.find_definition(val) || scope.find_hostclass(val)
123
- #scope.compiler.findresource(:class, val)
123
+ krt = scope.environment.known_resource_types
124
+ Puppet::Pops::Evaluator::Runtime3ResourceSupport.find_resource_type_or_class(scope, val)
124
125
  end
125
126
  end
126
127
  when Puppet::Resource
@@ -130,7 +131,7 @@ Puppet::Functions.create_function(:'defined', Puppet::Functions::InternalFunctio
130
131
  when Puppet::Pops::Types::PResourceType
131
132
  raise ArgumentError, 'The given resource type is a reference to all kind of types' if val.type_name.nil?
132
133
  if val.title.nil?
133
- scope.find_builtin_resource_type(val.type_name) || scope.find_definition(val.type_name)
134
+ Puppet::Pops::Evaluator::Runtime3ResourceSupport.find_resource_type(scope, val.type_name)
134
135
  else
135
136
  scope.compiler.findresource(val.type_name, val.title)
136
137
  end
@@ -151,7 +152,8 @@ Puppet::Functions.create_function(:'defined', Puppet::Functions::InternalFunctio
151
152
  # (this is the same as asking for just the class' name, but with the added certainty that it cannot be a defined type.
152
153
  #
153
154
  raise ArgumentError, 'The given class type is a reference to all classes' if val.type.class_name.nil?
154
- scope.find_hostclass(val.type.class_name)
155
+ Puppet::Pops::Evaluator::Runtime3ResourceSupport.find_hostclass(scope, val.type.class_name)
156
+ #scope.environment.known_resource_types.find_hostclass(val.type.class_name)
155
157
  end
156
158
  else
157
159
  raise ArgumentError, "Invalid argument of type '#{val.class}' to 'defined'"
@@ -1,21 +1,5 @@
1
- # Returns a value for a sequence of given keys/indexes into a structure.
2
- # This function is used to "dig into" a complex data structure by
3
- # using a sequence of keys / indexes to access a value from which
4
- # the next key/index is accessed recursively.
5
- #
6
- # The first encountered `undef` value or key stops the "dig" and `undef` is returned.
7
- #
8
- # An error is raised if an attempt is made to "dig" into
9
- # something other than an `undef` (which immediately returns `undef`), an Array or a Hash.
10
- #
11
- # @example Using `dig`
12
- #
13
- # ~~~ puppet
14
- # $data = {a => { b => [{x => 10, y => 20}, {x => 100, y => 200}]}}
15
- # notice $data.dig(a, b, 1, x)
16
- # ~~~
17
- #
18
- # Would notice the value 100.
1
+ # Digs into a data structure.
2
+ # (Documented in 3.x stub)
19
3
  #
20
4
  # @since 4.5.0
21
5
  #
@@ -15,7 +15,7 @@ require 'hiera/puppet_function'
15
15
  # searching the rest of the hierarchy.
16
16
  #
17
17
  # The `hiera` function does **not** find all matches throughout a hierarchy, instead
18
- # returining the first specific value starting at the top of the hierarchy. To search
18
+ # returning the first specific value starting at the top of the hierarchy. To search
19
19
  # throughout a hierarchy, use the `hiera_array` or `hiera_hash` functions.
20
20
  #
21
21
  # @example Using `hiera`
@@ -1,40 +1,4 @@
1
- # Call a [lambda](https://docs.puppet.com/puppet/latest/reference/lang_lambdas.html)
2
- # (which should accept no arguments) if the argument given to the function is `undef`.
3
- # Returns the result of calling the lambda if the argument is `undef`, otherwwise the
4
- # given argument.
5
- #
6
- # The `lest` function is useful in a chain of `then` calls, or in general
7
- # as a guard against `undef` values. The function can be used to call `fail`, or to
8
- # return a default value.
9
- #
10
- # These two expressions are equivalent:
11
- # ~~~puppet
12
- # if $x == undef { do_things() }
13
- # lest($x) || { do_things() }
14
- # ~~
15
- #
16
- # @example Using `lest`
17
- #
18
- # ~~~ puppet
19
- # $data = {a => [ b, c ] }
20
- # notice $data.dig(a, b, c)
21
- # .then |$x| { $x * 2 }
22
- # .lest || { fail("no value for $data[a][b][c]" }
23
- # ~~~
24
- #
25
- # Would fail the operation because $data[a][b][c] results in `undef`
26
- #
27
- # In contrast - this example:
28
- #
29
- # ~~~ puppet
30
- # $data = {a => { b => { c => 10 } } }
31
- # notice $data.dig(a, b, c)
32
- # .then |$x| { $x * 2 }
33
- # .lest || { fail("no value for $data[a][b][c]" }
34
- # ~~~
35
- #
36
- # Would notice the value 20
37
- #
1
+ # (Documented in 3.x stub)
38
2
  # @since 4.5.0
39
3
  #
40
4
  Puppet::Functions.create_function(:lest) do
@@ -1,476 +1,5 @@
1
- # Creates a new instance/object of a given type.
2
- #
3
- # This functions makes it possible to create new instances of
4
- # concrete types. If a block is given it is called with the
5
- # just created instance as an argument.
6
- #
7
- # Calling this function is equivalent to directly
8
- # calling the type:
9
- #
10
- # @ example new and calling type directly are equivalent
11
- #
12
- # ~~~ puppet
13
- # $a = Integer.new("42")
14
- # $b = Integer("42")
15
- # ~~~
16
- #
17
- # This would convert the string "42" to the decimal value 42.
18
- #
19
- # @ example arguments by position or by name
20
- #
21
- # ~~~ puppet
22
- # $a = Integer.new("42", 8)
23
- # $b = Integer({from => "42", radix => 8})
24
- # ~~~
25
- #
26
- # This would convert the octal (radix 8) number "42" in string form
27
- # to the decimal value 34.
28
- #
29
- # The new function supports two ways of giving the arguments:
30
- #
31
- # * by name (using a hash with property to value mapping)
32
- # * by position (as regular arguments)
33
- #
34
- # Note that it is not possible to create new instances of
35
- # some abstract classes (e.g. `Variant`). The type Optional[T] is an
36
- # exception as it will create an instance of T or `undef` if the
37
- # value to convert is `undef`.
38
- #
39
- # The arguments that can be given to each type is
40
- # determined by the type.
41
- #
42
- # An assertion is always made that
43
- # the produced value complies with the given type constraints.
44
- #
45
- # @example type constraints are checked:
46
- #
47
- # ~~~ puppet
48
- # Integer[0].new("-100")
49
- # ~~~
50
- #
51
- # Would fail with an assertion error.
52
- #
53
- # The following sections show the arguments and conversion rules
54
- # per type built into the Puppet Type System.
55
- #
56
- # Conversion to Optional[T] and NotUndef[T]
57
- # -----------------------------------------
58
- # Conversion to these types is the same as a conversion to the type argument `T`. In the case of `Optional[T]`
59
- # it accepted that the result may be `undef` (i.e. not possible to convert).
60
- #
61
- # Conversion to Integer
62
- # ---------------------
63
- #
64
- # A new `Integer` can be created from `Integer`, `Float`, `Boolean`, and `String` values.
65
- # For conversion `from` String it is possible to specify the radix.
66
- #
67
- # ~~~ puppet
68
- # type Radix = Variant[Default, Integer[2,2], Integer[8,8], Integer[10,10], Integer[16,16]]
69
- # Callable[String, Radix, 1, 2]
70
- # Callable[Variant[Numeric, Boolean]]
71
- # ~~~
72
- #
73
- # * When converting from String the default radix is 10
74
- # * If radix is not specified an attempt is made to detect the radix from the start of the string:
75
- # * `0b` or `0B` is taken as radix 2,
76
- # * `0x` or `0X` is taken as radix 16,
77
- # * `0` as radix 8,
78
- # * all other are decimal
79
- # * Conversion from String accepts an optional sign in the string.
80
- # * For hexadecimal (radix 16) conversion an optional leading "0x", or "0X" is accepted
81
- # * for octal (radix 8) an optional leading "0" is accepted
82
- # * for binary (radix 2) an optional leading "0b" or "0B" is accepted
83
- # * When `radix` is set to `default`, the conversion is based on the leading
84
- # characters in the string. A leading "0" for radix 8, a leading "0x", or "0X" for
85
- # radix 16, and leading "0b" or "0B" for binary.
86
- # * Conversion from Boolean results in 0 for `false` and 1 for `true`.
87
- # * Conversion from Integer, Float, and Boolean ignores the radix.
88
- # * Float value fractions are truncated (no rounding)
89
- #
90
- # @example Converting to Integer
91
- #
92
- # ~~~ puppet
93
- # $a_number = Integer("0xFF", 16) # results in 255
94
- # $a_number = Numeric("010") # results in 8
95
- # $a_number = Numeric("010", 10) # results in 10
96
- # $a_number = Integer("true") # results in 1
97
- # ~~~
98
- #
99
- # Conversion to Float
100
- # -------------------
101
- #
102
- # A new `Float` can be created from `Integer`, `Float`, `Boolean`, and `String` values.
103
- # For conversion `from` String both float and integer formats are supported.
104
- #
105
- # * For an integer, the floating point fraction of .0 is added to the value.
106
- # * A Boolean true is converted to 1.0, and a false to 0.0
107
- # * In String format, integer prefixes for hex and binary are understood (but not octal since
108
- # floating point in string format may start with a '0').
109
- #
110
- # Conversion to Numeric
111
- # ---------------------
112
- #
113
- # A new Integer or Float can be created from Integer, Float, Boolean and
114
- # String values.
115
- #
116
- # ~~~ puppet
117
- # Callable[Variant[Numeric, Boolean, String]]
118
- # ~~~
119
- #
120
- # * If the value has a decimal period, or if given in scientific notation
121
- # (e/E), the result is a `Float`, otherwise the value is an `Integer`. The
122
- # conversion from `String` always uses a radix based on the prefix of the string.
123
- # * Conversion from Boolean results in 0 for `false` and 1 for `true`.
124
- #
125
- # @example Converting to Numeric
126
- #
127
- # ~~~ puppet
128
- # $a_number = Numeric("true") # results in 1
129
- # $a_number = Numeric("0xFF") # results in 255
130
- # $a_number = Numeric("010") # results in 8
131
- # $a_number = Numeric("3.14") # results in 3.14 (a float)
132
- # ~~~
133
- #
134
- # Conversion to String
135
- # --------------------
136
- #
137
- # Conversion to String is the most comprehensive conversion as there are many
138
- # use cases where a String representation is wanted. The defaults for the many options
139
- # have been chosen with care to be the most basic "value in textual form" representation.
140
- #
141
- # A new String can be created from all other data types. The process is performed in
142
- # several steps - first the type of the given value is inferred, then the resulting type
143
- # is used to find the most significant format specified for that type. And finally,
144
- # the found format is used to convert the given value.
145
- #
146
- # The mapping from type to format is referred to as the format map. This map
147
- # allows different formatting depending on type.
148
- #
149
- # @example Positive Integers in Hexadecimal prefixed with '0x', negative in Decimal
150
- #
151
- # ~~~ puppet
152
- # $format_map = { Integer[default, 0] => "%d",
153
- # Integer[1, default] => "%#x"
154
- # }
155
- # String("-1", $format_map) # produces '-1'
156
- # String("10", $format_map) # produces '0xa'
157
- # ~~~
158
- #
159
- # A format is specified on the form:
160
- #
161
- # ~~~
162
- # %[Flags][Width][.Precision]Format
163
- # ~~~
164
- #
165
- # `Width` is the number of characters into which the value should be fitted. This allocated space is
166
- # padded if value is shorter. By default it is space padded, and the flag 0 will cause padding with 0
167
- # for numerical formats.
168
- #
169
- # `Precision` is the number of fractional digits to show for floating point, and the maximum characters
170
- # included in a string format.
171
- #
172
- # Note that all data type supports the formats `s` and `p` with the meaning "default to string" and
173
- # "default programmatic string representation" (which for example means that a String is quoted in 'p' format).
174
- #
175
- # ### Signatures of String conversion
176
- #
177
- # ~~~ puppet
178
- # type Format = Pattern[/^%([\s\+\-#0\[\{<\(\|]*)([1-9][0-9]*)?(?:\.([0-9]+))?([a-zA-Z])/]
179
- # type ContainerFormat = Struct[{
180
- # format => Optional[String],
181
- # separator => Optional[String],
182
- # separator2 => Optional[String],
183
- # string_formats => Hash[Type, Format]
184
- # }]
185
- # type TypeMap = Hash[Type, Variant[Format, ContainerFormat]]
186
- # type Formats = Variant[Default, String[1], TypeMap]
187
- #
188
- # Callable[Any, Formats]
189
- # ~~~
190
- #
191
- # Where:
192
- # * `separator` is the string used to separate entries in an array, or hash (extra space should not be included at
193
- # then end), defaults to `","`
194
- # * `separator2` is the separator between key and value in a hash entry (space padding should be included as
195
- # wanted), defaults to `" => ".
196
- # * `string_formats` is a type to format map for values contained in arrays and hashes - defaults to `{Any => "%p"}`. Note that
197
- # these nested formats are not applicable to containers which are always formatted as per the top level format specification.
198
- #
199
- # @example Simple Conversion to String (using defaults)
200
- #
201
- # ~~~ puppet
202
- # $str = String(10) # produces '10'
203
- # $str = String([10]) # produces '["10"]'
204
- # ~~~
205
- #
206
- # @example Simple Conversion to String specifying the format for the given value directly
207
- #
208
- # ~~~ puppet
209
- # $str = String(10, "%#x") # produces '0x10'
210
- # $str = String([10], "%(a") # produces '("10")'
211
- # ~~~
212
- #
213
- # @example Specifying type for values contained in an array
214
- #
215
- # ~~~ puppet
216
- # $formats = { Array => {format => '%(a', string_formats => { Integer => '%#x' } }
217
- # $str = String([1,2,3], $formats) # produces '(0x1, 0x2, 0x3)'
218
- # ~~~
219
- #
220
- # Given formats are merged with the default formats, and matching of values to convert against format is based on
221
- # the specificity of the mapped type; for example, different formats can be used for short and long arrays.
222
- #
223
- # ### Integer to String
224
- #
225
- # | Format | Integer Formats
226
- # | ------ | ---------------
227
- # | d | Decimal, negative values produces leading '-'
228
- # | x X | Hexadecimal in lower or upper case. Uses ..f/..F for negative values unless # is also used
229
- # | o | Octal. Uses ..0 for negative values unless # is also used
230
- # | b B | Binary with prefix 'b' or 'B'. Uses ..1/..1 for negative values unless # is also used
231
- # | c | numeric value representing a Unicode value, result is a one unicode character string, quoted if alternative flag # is used
232
- # | s | same as d, or d in quotes if alternative flag # is used
233
- # | p | same as d
234
- # | eEfgGaA | converts integer to float and formats using the floating point rules
235
- #
236
- # Defaults to `d`
237
- #
238
- # ### Float to String
239
- #
240
- # | Format | Float formats
241
- # | ------ | -------------
242
- # | f | floating point in non exponential notation
243
- # | e E | exponential notation with 'e' or 'E'
244
- # | g G | conditional exponential with 'e' or 'E' if exponent < -4 or >= the precision
245
- # | a A | hexadecimal exponential form, using 'x'/'X' as prefix and 'p'/'P' before exponent
246
- # | s | converted to string using format p, then applying string formatting rule, alternate form # quotes result
247
- # | p | f format with minimum significant number of fractional digits, prec has no effect
248
- # | dxXobBc | converts float to integer and formats using the integer rules
249
- #
250
- # Defaults to `p`
251
- #
252
- # ### String to String
253
- #
254
- # | Format | String
255
- # | ------ | ------
256
- # | s | unquoted string, verbatim output of control chars
257
- # | p | programmatic representation - strings are quoted, interior quotes and control chars are escaped
258
- # | C | each :: name segment capitalized, quoted if alternative flag # is used
259
- # | c | capitalized string, quoted if alternative flag # is used
260
- # | d | downcased string, quoted if alternative flag # is used
261
- # | u | upcased string, quoted if alternative flag # is used
262
- # | t | trims leading and trailing whitespace from the string, quoted if alternative flag # is used
263
- #
264
- # Defaults to `s` at top level and `p` inside array or hash.
265
- #
266
- # ### Boolean to String
267
- #
268
- # | Format | Boolean Formats
269
- # | ---- | -------------------
270
- # | t T | 'true'/'false' or 'True'/'False' , first char if alternate form is used (i.e. 't'/'f' or 'T'/'F').
271
- # | y Y | 'yes'/'no', 'Yes'/'No', 'y'/'n' or 'Y'/'N' if alternative flag # is used
272
- # | dxXobB | numeric value 0/1 in accordance with the given format which must be valid integer format
273
- # | eEfgGaA | numeric value 0.0/1.0 in accordance with the given float format and flags
274
- # | s | 'true' / 'false'
275
- # | p | 'true' / 'false'
276
- #
277
- # ### Regexp to String
278
- #
279
- # | Format | Regexp Formats (%/)
280
- # | ---- | ------------------
281
- # | s | / / delimiters, alternate flag replaces / delimiters with quotes
282
- # | p | / / delimiters
283
- #
284
- # ### Undef to String
285
- #
286
- # | Format | Undef formats
287
- # | ------ | -------------
288
- # | s | empty string, or quoted empty string if alternative flag # is used
289
- # | p | 'undef', or quoted '"undef"' if alternative flag # is used
290
- # | n | 'nil', or 'null' if alternative flag # is used
291
- # | dxXobB | 'NaN'
292
- # | eEfgGaA | 'NaN'
293
- # | v | 'n/a'
294
- # | V | 'N/A'
295
- # | u | 'undef', or 'undefined' if alternative # flag is used
296
- #
297
- # ### Default value to String
298
- #
299
- # | Format | Default formats
300
- # | ------ | ---------------
301
- # | d D | 'default' or 'Default', alternative form # causes value to be quoted
302
- # | s | same as d
303
- # | p | same as d
304
- #
305
- # ### Array & Tuple to String
306
- #
307
- # | Format | Array/Tuple Formats
308
- # | ------ | -------------
309
- # | a | formats with `[ ]` delimiters and `,`, alternate form `#` indents nested arrays/hashes
310
- # | s | same as a
311
- # | p | same as a
312
- #
313
- # See "Flags" `<[({\|` for formatting of delimiters, and "Additional parameters for containers; Array and Hash" for
314
- # more information about options.
315
- #
316
- # The alternate form flag `#` will cause indentation of nested array or hash containers. If width is also set
317
- # it is taken as the maximum allowed length of a sequence of elements (not including delimiters). If this max length
318
- # is exceeded, each element will be indented.
319
- #
320
- # ### Hash & Struct to String
321
- #
322
- # | Format | Hash/Struct Formats
323
- # | ------ | -------------
324
- # | h | formats with `{ }` delimiters, `,` element separator and ` => ` inner element separator unless overridden by flags
325
- # | s | same as h
326
- # | p | same as h
327
- # | a | converts the hash to an array of [k,v] tuples and formats it using array rule(s)
328
- #
329
- # See "Flags" `<[({\|` for formatting of delimiters, and "Additional parameters for containers; Array and Hash" for
330
- # more information about options.
331
- #
332
- # The alternate form flag `#` will format each hash key/value entry indented on a separate line.
333
- #
334
- # ### Type to String
335
- #
336
- # | Format | Array/Tuple Formats
337
- # | ------ | -------------
338
- # | s | The same as p, quoted if alternative flag # is used
339
- # | p | Outputs the type in string form as specified by the Puppet Language
340
- #
341
- # ### Flags
342
- #
343
- # | Flag | Effect
344
- # | ------ | ------
345
- # | (space) | space instead of + for numeric output (- is shown), for containers skips delimiters
346
- # | # | alternate format; prefix 0x/0x, 0 (octal) and 0b/0B for binary, Floats force decimal '.'. For g/G keep trailing 0.
347
- # | + | show sign +/- depending on value's sign, changes x,X, o,b, B format to not use 2's complement form
348
- # | - | left justify the value in the given width
349
- # | 0 | pad with 0 instead of space for widths larger than value
350
- # | <[({\| | defines an enclosing pair <> [] () {} or \| \| when used with a container type
351
- #
352
- # Conversion to Boolean
353
- # ---
354
- #
355
- # Accepts a single value as argument:
356
- # * Float 0.0 is `false`, all other float values are `true`
357
- # * Integer 0 is `false`, all other integer values are `true`
358
- # * Strings
359
- # * `true` if 'true', 'yes', 'y' (case independent compare)
360
- # * `false` if 'false', 'no', 'n' (case independent compare)
361
- # * Boolean is already boolean and is simply returned
362
- #
363
- # Conversion to Array and Tuple
364
- # ---
365
- #
366
- # When given a single value as argument:
367
- #
368
- # * A non empty `Hash` is converted to an array matching `Array[Tuple[Any,Any], 1]`
369
- # * An empty `Hash` becomes an empty array
370
- # * An `Array` is simply returned
371
- # * An `Iterable[T]` is turned into an array of `T` instances
372
- #
373
- # When given a second Boolean argument
374
- # * if `true`, a value that is not already an array is returned as a one element array
375
- # * if `false`, (the default), converts the first argument as shown above.
376
- #
377
- # @example ensuring value is array
378
- #
379
- # ~~~ puppet
380
- # $arr = Array($value, true)
381
- # ~~~
382
- #
383
- # Conversion to a `Tuple` works exactly as conversion to an `Array`, only that the constructed array is
384
- # asserted against the given tuple type.
385
- #
386
- # Conversion to Hash and Struct
387
- # ---
388
- # Accepts a single value as argument:
389
- #
390
- # * An empty `Array` becomes an empty hash
391
- # * An `Array` matching `Array[Tuple[Any,Any], 1]` is converted to a hash where each tuple describes a key/value entry
392
- # * An `Array` with an even number of entries is interpreted as `[key1, val1, key2, val2, ...]`
393
- # * An `Iterable` is turned into an `Array` and then converted to hash as per the array rules
394
- # * A `Hash` is simply returned
395
- #
396
- # Conversion to a `Struct` works exactly as conversion to a `Hash`, only that the constructed hash is
397
- # asserted against the given struct type.
398
- #
399
- # Creating a SemVer
400
- # ---
401
- # A SemVer object represents a single [Semantic Version](http://semver.org/).
402
- # It can be created from a String, individual values for its parts, or a hash specifying the value per part.
403
- # See the specification at [semver.org](http://semver.org/) for the meaning of the SemVer's parts.
404
- #
405
- # The signatures are:
406
- #
407
- # ~~~ puppet
408
- #
409
- # type PositiveInteger = Integer[0,default]
410
- # type SemVerQualifier = Pattern[/\A(?<part>[0-9A-Za-z-]+)(?:\.\g<part>)*\Z/]
411
- # type SemVerString = String[1]
412
- # type SemVerHash =Struct[{
413
- # major => PositiveInteger,
414
- # minor => PositiveInteger,
415
- # patch => PositiveInteger,
416
- # Optional[prerelease] => SemVerQualifier,
417
- # Optional[build] => SemVerQualifier
418
- # }]
419
- #
420
- # function SemVer.new(SemVerString $str)
421
- # function SemVer.new(
422
- # PositiveInteger $major
423
- # PositiveInteger $minor
424
- # PositiveInteger $patch
425
- # Optional[SemVerQualifier] $prerelease = undef
426
- # Optional[SemVerQualifier] $build = undef
427
- # )
428
- # function SemVer.new(SemVerHash $hash_args)
429
- #
430
- # ~~~
431
- #
432
- # Examples of SemVer and SemVerRange usage:
433
- #
434
- # ~~~ puppet
435
- #
436
- # # As a type, SemVer can describe disjunct ranges which versions can be matched
437
- # # against - here the type is constructed with two SemVerRange objects.
438
- # $t = SemVer[SemVerRange('>=1.0.0 <2.0.0'), SemVerRange('>=3.0.0 <4.0.0')]
439
- # notice(SemVer('1.2.3') =~ $t) # true
440
- # notice(SemVer('2.3.4') =~ $t) # false
441
- # notice(SemVer('3.4.5') =~ $t) # true
442
- #
443
- # ~~~
444
- #
445
- # Creating a SemVerRange
446
- # ---
447
- # A SemVerRange object represents a range of SemVer. It can be created from
448
- # a String, from two SemVer instances, where either end can be given as
449
- # a literal `default` to indicate infinity. The string format of a SemVerRange is specified by
450
- # the [Semantic Version Range Grammar](https://github.com/npm/node-semver#ranges).
451
- # Use of the comparator sets described in the grammar (joining with `||`) is not supported.
452
- #
453
- # The signatures are:
454
- #
455
- # ~~~ puppet
456
- # type SemVerRangeString = String[1]
457
- # type SemVerRangeHash = Struct[{
458
- # min => Variant[default, SemVer],
459
- # Optional[max] => Variant[default, SemVer],
460
- # Optional[exclude_max] => Boolean
461
- # }]
462
- #
463
- # function SemVerRange.new( SemVerRangeString $semver_range_string)
464
- #
465
- # function SemVerRange.new(
466
- # Variant[default,SemVer] $min
467
- # Variant[default,SemVer] $max
468
- # Optional[Boolean] $exclude_max = undef
469
- # }
470
- # function SemVerRange.new(SemVerRangeHash $semver_range_hash)
471
- # ~~~
472
- #
473
- # For examples, see `SemVer.new`.
1
+ # Returns a new instance of a data type.
2
+ # (The documentation is maintained in the corresponding 3.x stub)
474
3
  #
475
4
  # @since 4.5.0
476
5
  #