pdk 2.3.0 → 2.4.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 (153) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +1329 -1321
  3. data/LICENSE +201 -201
  4. data/README.md +163 -163
  5. data/exe/pdk +10 -10
  6. data/lib/pdk/analytics/client/google_analytics.rb +143 -143
  7. data/lib/pdk/analytics/client/noop.rb +25 -25
  8. data/lib/pdk/analytics/util.rb +19 -19
  9. data/lib/pdk/analytics.rb +30 -30
  10. data/lib/pdk/answer_file.rb +12 -12
  11. data/lib/pdk/bolt.rb +19 -19
  12. data/lib/pdk/cli/build.rb +82 -82
  13. data/lib/pdk/cli/bundle.rb +48 -48
  14. data/lib/pdk/cli/config/get.rb +26 -26
  15. data/lib/pdk/cli/config.rb +22 -22
  16. data/lib/pdk/cli/console.rb +148 -148
  17. data/lib/pdk/cli/convert.rb +52 -52
  18. data/lib/pdk/cli/env.rb +52 -52
  19. data/lib/pdk/cli/errors.rb +25 -25
  20. data/lib/pdk/cli/exec/command.rb +293 -293
  21. data/lib/pdk/cli/exec/interactive_command.rb +114 -114
  22. data/lib/pdk/cli/exec.rb +84 -84
  23. data/lib/pdk/cli/exec_group.rb +104 -104
  24. data/lib/pdk/cli/get/config.rb +24 -24
  25. data/lib/pdk/cli/get.rb +20 -20
  26. data/lib/pdk/cli/module/build.rb +12 -12
  27. data/lib/pdk/cli/module/generate.rb +47 -47
  28. data/lib/pdk/cli/module.rb +14 -14
  29. data/lib/pdk/cli/new/class.rb +32 -32
  30. data/lib/pdk/cli/new/defined_type.rb +32 -32
  31. data/lib/pdk/cli/new/fact.rb +29 -29
  32. data/lib/pdk/cli/new/function.rb +29 -29
  33. data/lib/pdk/cli/new/module.rb +53 -53
  34. data/lib/pdk/cli/new/provider.rb +29 -29
  35. data/lib/pdk/cli/new/task.rb +34 -34
  36. data/lib/pdk/cli/new/test.rb +52 -52
  37. data/lib/pdk/cli/new/transport.rb +27 -27
  38. data/lib/pdk/cli/new.rb +21 -21
  39. data/lib/pdk/cli/release/prep.rb +39 -39
  40. data/lib/pdk/cli/release/publish.rb +50 -50
  41. data/lib/pdk/cli/release.rb +194 -194
  42. data/lib/pdk/cli/remove/config.rb +80 -80
  43. data/lib/pdk/cli/remove.rb +20 -20
  44. data/lib/pdk/cli/set/config.rb +119 -119
  45. data/lib/pdk/cli/set.rb +20 -20
  46. data/lib/pdk/cli/test/unit.rb +90 -90
  47. data/lib/pdk/cli/test.rb +11 -11
  48. data/lib/pdk/cli/update.rb +64 -64
  49. data/lib/pdk/cli/util/command_redirector.rb +27 -27
  50. data/lib/pdk/cli/util/interview.rb +72 -72
  51. data/lib/pdk/cli/util/option_normalizer.rb +55 -55
  52. data/lib/pdk/cli/util/option_validator.rb +68 -68
  53. data/lib/pdk/cli/util/spinner.rb +13 -13
  54. data/lib/pdk/cli/util/update_manager_printer.rb +82 -82
  55. data/lib/pdk/cli/util.rb +305 -305
  56. data/lib/pdk/cli/validate.rb +116 -116
  57. data/lib/pdk/cli.rb +175 -175
  58. data/lib/pdk/config/analytics_schema.json +26 -26
  59. data/lib/pdk/config/errors.rb +5 -5
  60. data/lib/pdk/config/ini_file.rb +183 -183
  61. data/lib/pdk/config/ini_file_setting.rb +39 -39
  62. data/lib/pdk/config/json.rb +34 -34
  63. data/lib/pdk/config/json_schema_namespace.rb +142 -142
  64. data/lib/pdk/config/json_schema_setting.rb +53 -53
  65. data/lib/pdk/config/json_with_schema.rb +49 -49
  66. data/lib/pdk/config/namespace.rb +354 -354
  67. data/lib/pdk/config/setting.rb +135 -135
  68. data/lib/pdk/config/validator.rb +31 -31
  69. data/lib/pdk/config/yaml.rb +46 -46
  70. data/lib/pdk/config/yaml_with_schema.rb +59 -59
  71. data/lib/pdk/config.rb +390 -390
  72. data/lib/pdk/context/control_repo.rb +60 -60
  73. data/lib/pdk/context/module.rb +28 -28
  74. data/lib/pdk/context/none.rb +22 -22
  75. data/lib/pdk/context.rb +99 -99
  76. data/lib/pdk/control_repo.rb +90 -90
  77. data/lib/pdk/generate/defined_type.rb +43 -43
  78. data/lib/pdk/generate/fact.rb +25 -25
  79. data/lib/pdk/generate/function.rb +48 -48
  80. data/lib/pdk/generate/module.rb +352 -352
  81. data/lib/pdk/generate/provider.rb +28 -28
  82. data/lib/pdk/generate/puppet_class.rb +43 -43
  83. data/lib/pdk/generate/puppet_object.rb +232 -232
  84. data/lib/pdk/generate/task.rb +68 -68
  85. data/lib/pdk/generate/transport.rb +33 -33
  86. data/lib/pdk/generate.rb +24 -24
  87. data/lib/pdk/i18n.rb +4 -4
  88. data/lib/pdk/logger.rb +45 -45
  89. data/lib/pdk/module/build.rb +322 -322
  90. data/lib/pdk/module/convert.rb +296 -296
  91. data/lib/pdk/module/metadata.rb +202 -202
  92. data/lib/pdk/module/release.rb +260 -260
  93. data/lib/pdk/module/update.rb +131 -131
  94. data/lib/pdk/module/update_manager.rb +227 -227
  95. data/lib/pdk/module.rb +30 -30
  96. data/lib/pdk/report/event.rb +370 -370
  97. data/lib/pdk/report.rb +121 -121
  98. data/lib/pdk/template/fetcher/git.rb +85 -85
  99. data/lib/pdk/template/fetcher/local.rb +28 -28
  100. data/lib/pdk/template/fetcher.rb +98 -98
  101. data/lib/pdk/template/renderer/v1/legacy_template_dir.rb +116 -116
  102. data/lib/pdk/template/renderer/v1/renderer.rb +132 -132
  103. data/lib/pdk/template/renderer/v1/template_file.rb +102 -102
  104. data/lib/pdk/template/renderer/v1.rb +25 -25
  105. data/lib/pdk/template/renderer.rb +96 -96
  106. data/lib/pdk/template/template_dir.rb +67 -67
  107. data/lib/pdk/template.rb +59 -59
  108. data/lib/pdk/tests/unit.rb +252 -252
  109. data/lib/pdk/util/bundler.rb +259 -259
  110. data/lib/pdk/util/changelog_generator.rb +137 -137
  111. data/lib/pdk/util/env.rb +47 -47
  112. data/lib/pdk/util/filesystem.rb +138 -138
  113. data/lib/pdk/util/git.rb +179 -179
  114. data/lib/pdk/util/json_finder.rb +85 -85
  115. data/lib/pdk/util/puppet_strings.rb +125 -125
  116. data/lib/pdk/util/puppet_version.rb +266 -266
  117. data/lib/pdk/util/ruby_version.rb +179 -179
  118. data/lib/pdk/util/template_uri.rb +295 -295
  119. data/lib/pdk/util/vendored_file.rb +93 -93
  120. data/lib/pdk/util/version.rb +43 -43
  121. data/lib/pdk/util/windows/api_types.rb +82 -82
  122. data/lib/pdk/util/windows/file.rb +36 -36
  123. data/lib/pdk/util/windows/process.rb +79 -79
  124. data/lib/pdk/util/windows/string.rb +16 -16
  125. data/lib/pdk/util/windows.rb +15 -15
  126. data/lib/pdk/util.rb +278 -277
  127. data/lib/pdk/validate/control_repo/control_repo_validator_group.rb +23 -23
  128. data/lib/pdk/validate/control_repo/environment_conf_validator.rb +98 -98
  129. data/lib/pdk/validate/external_command_validator.rb +208 -208
  130. data/lib/pdk/validate/internal_ruby_validator.rb +100 -100
  131. data/lib/pdk/validate/invokable_validator.rb +228 -228
  132. data/lib/pdk/validate/metadata/metadata_json_lint_validator.rb +86 -86
  133. data/lib/pdk/validate/metadata/metadata_syntax_validator.rb +78 -78
  134. data/lib/pdk/validate/metadata/metadata_validator_group.rb +20 -20
  135. data/lib/pdk/validate/puppet/puppet_epp_validator.rb +133 -133
  136. data/lib/pdk/validate/puppet/puppet_lint_validator.rb +66 -66
  137. data/lib/pdk/validate/puppet/puppet_syntax_validator.rb +137 -137
  138. data/lib/pdk/validate/puppet/puppet_validator_group.rb +21 -21
  139. data/lib/pdk/validate/ruby/ruby_rubocop_validator.rb +80 -80
  140. data/lib/pdk/validate/ruby/ruby_validator_group.rb +19 -19
  141. data/lib/pdk/validate/tasks/tasks_metadata_lint_validator.rb +88 -88
  142. data/lib/pdk/validate/tasks/tasks_name_validator.rb +50 -50
  143. data/lib/pdk/validate/tasks/tasks_validator_group.rb +20 -20
  144. data/lib/pdk/validate/validator.rb +118 -118
  145. data/lib/pdk/validate/validator_group.rb +104 -104
  146. data/lib/pdk/validate/yaml/yaml_syntax_validator.rb +95 -95
  147. data/lib/pdk/validate/yaml/yaml_validator_group.rb +19 -19
  148. data/lib/pdk/validate.rb +94 -94
  149. data/lib/pdk/version.rb +4 -4
  150. data/lib/pdk.rb +76 -76
  151. data/locales/config.yaml +21 -21
  152. data/locales/pdk.pot +2094 -2094
  153. metadata +5 -6
@@ -1,179 +1,179 @@
1
- require 'pdk'
2
- require 'forwardable'
3
-
4
- module PDK
5
- module Util
6
- class RubyVersion
7
- class << self
8
- extend Forwardable
9
-
10
- def_delegators :instance, :gem_path, :gem_paths_raw, :gem_home, :available_puppet_versions, :bin_path
11
-
12
- # TODO: resolve this
13
- # rubocop:disable Lint/DuplicateMethods
14
- attr_reader :instance
15
-
16
- def instance(version = nil)
17
- use(version) unless version.nil?
18
-
19
- if @instance.nil?
20
- @instance = {}
21
- @instance.default_proc = proc do |hash, key|
22
- hash[key] = new(key)
23
- end
24
- end
25
- @instance[active_ruby_version]
26
- end
27
- # rubocop:enable Lint/DuplicateMethods
28
-
29
- def active_ruby_version
30
- @active_ruby_version || default_ruby_version
31
- end
32
-
33
- def use(version)
34
- if versions.key?(version)
35
- @active_ruby_version = version
36
- else
37
- raise ArgumentError, _('Unknown Ruby version "%{ruby_version}"') % {
38
- ruby_version: version,
39
- }
40
- end
41
- end
42
-
43
- def scan_for_packaged_rubies
44
- require 'pdk/util'
45
-
46
- ruby_basedir = File.join(PDK::Util.pdk_package_basedir, 'private', 'ruby', '*')
47
- PDK::Util::Filesystem.glob(ruby_basedir).sort.map { |ruby_dir|
48
- version = File.basename(ruby_dir)
49
- [version, version.split('.').take(2).concat(['0']).join('.')]
50
- }.reverse.to_h
51
- end
52
-
53
- def default_ruby_version
54
- require 'pdk/util'
55
- require 'pdk/util/puppet_version'
56
-
57
- @default_ruby_version ||= if PDK::Util.package_install?
58
- # Default to the ruby that supports the latest puppet gem. If you wish to default to a
59
- # specific Puppet Gem version use the following example;
60
- #
61
- # PDK::Util::PuppetVersion.find_gem_for('5.5.10')[:ruby_version]
62
- #
63
- # For using the latest puppet gem:
64
- # PDK::Util::PuppetVersion.latest_available[:ruby_version]
65
- #
66
- # Temporarily lock to Ruby 2.5.x as default until 2.7.x ecosystem is sorted
67
- versions.keys.detect { |v| v =~ %r{^2\.5} }
68
- else
69
- # TODO: may not be a safe assumption that highest available version should be default
70
- # WARNING Do NOT use PDK::Util::PuppetVersion.*** methods as it can recurse into this
71
- # method and cause Stack Level Too Deep errors.
72
- latest_ruby_version
73
- end
74
- end
75
-
76
- def latest_ruby_version
77
- versions.keys.sort { |a, b| Gem::Version.new(b) <=> Gem::Version.new(a) }.first
78
- end
79
-
80
- def versions
81
- require 'pdk/util'
82
-
83
- @versions ||= if PDK::Util.package_install?
84
- scan_for_packaged_rubies
85
- else
86
- { RbConfig::CONFIG['RUBY_PROGRAM_VERSION'] => RbConfig::CONFIG['ruby_version'] }
87
- end
88
- end
89
- end
90
-
91
- attr_reader :ruby_version
92
-
93
- def initialize(ruby_version = nil)
94
- @ruby_version = ruby_version || default_ruby_version
95
- end
96
-
97
- def bin_path
98
- require 'pdk/util'
99
-
100
- if PDK::Util.package_install?
101
- File.join(PDK::Util.pdk_package_basedir, 'private', 'ruby', ruby_version, 'bin')
102
- else
103
- RbConfig::CONFIG['bindir']
104
- end
105
- end
106
-
107
- def gem_paths_raw
108
- require 'pdk/util'
109
-
110
- if PDK::Util.package_install?
111
- # Subprocesses use their own set of gems which are managed by pdk or
112
- # installed with the package. We also include the separate gem path
113
- # where our packaged multi-puppet installations live.
114
- [
115
- File.join(PDK::Util.pdk_package_basedir, 'private', 'ruby', ruby_version, 'lib', 'ruby', 'gems', versions[ruby_version]),
116
- File.join(PDK::Util.package_cachedir, 'ruby', versions[ruby_version]),
117
- File.join(PDK::Util.pdk_package_basedir, 'private', 'puppet', 'ruby', versions[ruby_version]),
118
- ]
119
- else
120
- # This allows the subprocess to find the 'bundler' gem, which isn't
121
- # in GEM_HOME for gem installs.
122
- [File.absolute_path(File.join(bundler_basedir, '..', '..', '..'))]
123
- end
124
- end
125
-
126
- def gem_path
127
- gem_paths_raw.join(File::PATH_SEPARATOR)
128
- end
129
-
130
- def gem_home
131
- require 'pdk/util'
132
-
133
- # TODO: bundle install --path is deprecated
134
- # `bundle install --path` ignores all "system" installed gems and
135
- # causes unnecessary package installs. `bundle install` (without
136
- # --path) installs into GEM_HOME, which by default is non-user
137
- # writeable.
138
- # To still use the pre-installed packages, but allow folks to install
139
- # additional gems, we set GEM_HOME to the user's cachedir and put all
140
- # other cache locations onto GEM_PATH.
141
- # See https://stackoverflow.com/a/11277228 for background
142
- File.join(PDK::Util.cachedir, 'ruby', versions[ruby_version])
143
- end
144
-
145
- def available_puppet_versions
146
- return @available_puppet_versions unless @available_puppet_versions.nil?
147
-
148
- puppet_spec_files = PDK::Util::Filesystem.glob(File.join(gem_home, 'specifications', '**', 'puppet*.gemspec'))
149
-
150
- gem_path.split(File::PATH_SEPARATOR).each do |path|
151
- puppet_spec_files += PDK::Util::Filesystem.glob(File.join(path, 'specifications', '**', 'puppet*.gemspec'))
152
- end
153
-
154
- puppet_specs = []
155
-
156
- puppet_spec_files.each do |specfile|
157
- spec = Gem::Specification.load(specfile)
158
- puppet_specs << spec if spec.name == 'puppet'
159
- end
160
-
161
- @available_puppet_versions = puppet_specs.map(&:version).sort { |a, b| b <=> a }
162
- end
163
-
164
- private
165
-
166
- def default_ruby_version
167
- self.class.default_ruby_version
168
- end
169
-
170
- def versions
171
- self.class.versions
172
- end
173
-
174
- def bundler_basedir
175
- Gem::Specification.latest_specs.find { |spec| spec.name.eql?('bundler') }.base_dir
176
- end
177
- end
178
- end
179
- end
1
+ require 'pdk'
2
+ require 'forwardable'
3
+
4
+ module PDK
5
+ module Util
6
+ class RubyVersion
7
+ class << self
8
+ extend Forwardable
9
+
10
+ def_delegators :instance, :gem_path, :gem_paths_raw, :gem_home, :available_puppet_versions, :bin_path
11
+
12
+ # TODO: resolve this
13
+ # rubocop:disable Lint/DuplicateMethods
14
+ attr_reader :instance
15
+
16
+ def instance(version = nil)
17
+ use(version) unless version.nil?
18
+
19
+ if @instance.nil?
20
+ @instance = {}
21
+ @instance.default_proc = proc do |hash, key|
22
+ hash[key] = new(key)
23
+ end
24
+ end
25
+ @instance[active_ruby_version]
26
+ end
27
+ # rubocop:enable Lint/DuplicateMethods
28
+
29
+ def active_ruby_version
30
+ @active_ruby_version || default_ruby_version
31
+ end
32
+
33
+ def use(version)
34
+ if versions.key?(version)
35
+ @active_ruby_version = version
36
+ else
37
+ raise ArgumentError, _('Unknown Ruby version "%{ruby_version}"') % {
38
+ ruby_version: version,
39
+ }
40
+ end
41
+ end
42
+
43
+ def scan_for_packaged_rubies
44
+ require 'pdk/util'
45
+
46
+ ruby_basedir = File.join(PDK::Util.pdk_package_basedir, 'private', 'ruby', '*')
47
+ PDK::Util::Filesystem.glob(ruby_basedir).sort.map { |ruby_dir|
48
+ version = File.basename(ruby_dir)
49
+ [version, version.split('.').take(2).concat(['0']).join('.')]
50
+ }.reverse.to_h
51
+ end
52
+
53
+ def default_ruby_version
54
+ require 'pdk/util'
55
+ require 'pdk/util/puppet_version'
56
+
57
+ @default_ruby_version ||= if PDK::Util.package_install?
58
+ # Default to the ruby that supports the latest puppet gem. If you wish to default to a
59
+ # specific Puppet Gem version use the following example;
60
+ #
61
+ # PDK::Util::PuppetVersion.find_gem_for('5.5.10')[:ruby_version]
62
+ #
63
+ # For using the latest puppet gem:
64
+ # PDK::Util::PuppetVersion.latest_available[:ruby_version]
65
+ #
66
+ # Temporarily lock to Ruby 2.5.x as default until 2.7.x ecosystem is sorted
67
+ versions.keys.detect { |v| v =~ %r{^2\.5} }
68
+ else
69
+ # TODO: may not be a safe assumption that highest available version should be default
70
+ # WARNING Do NOT use PDK::Util::PuppetVersion.*** methods as it can recurse into this
71
+ # method and cause Stack Level Too Deep errors.
72
+ latest_ruby_version
73
+ end
74
+ end
75
+
76
+ def latest_ruby_version
77
+ versions.keys.sort { |a, b| Gem::Version.new(b) <=> Gem::Version.new(a) }.first
78
+ end
79
+
80
+ def versions
81
+ require 'pdk/util'
82
+
83
+ @versions ||= if PDK::Util.package_install?
84
+ scan_for_packaged_rubies
85
+ else
86
+ { RbConfig::CONFIG['RUBY_PROGRAM_VERSION'] => RbConfig::CONFIG['ruby_version'] }
87
+ end
88
+ end
89
+ end
90
+
91
+ attr_reader :ruby_version
92
+
93
+ def initialize(ruby_version = nil)
94
+ @ruby_version = ruby_version || default_ruby_version
95
+ end
96
+
97
+ def bin_path
98
+ require 'pdk/util'
99
+
100
+ if PDK::Util.package_install?
101
+ File.join(PDK::Util.pdk_package_basedir, 'private', 'ruby', ruby_version, 'bin')
102
+ else
103
+ RbConfig::CONFIG['bindir']
104
+ end
105
+ end
106
+
107
+ def gem_paths_raw
108
+ require 'pdk/util'
109
+
110
+ if PDK::Util.package_install?
111
+ # Subprocesses use their own set of gems which are managed by pdk or
112
+ # installed with the package. We also include the separate gem path
113
+ # where our packaged multi-puppet installations live.
114
+ [
115
+ File.join(PDK::Util.pdk_package_basedir, 'private', 'ruby', ruby_version, 'lib', 'ruby', 'gems', versions[ruby_version]),
116
+ File.join(PDK::Util.package_cachedir, 'ruby', versions[ruby_version]),
117
+ File.join(PDK::Util.pdk_package_basedir, 'private', 'puppet', 'ruby', versions[ruby_version]),
118
+ ]
119
+ else
120
+ # This allows the subprocess to find the 'bundler' gem, which isn't
121
+ # in GEM_HOME for gem installs.
122
+ [File.absolute_path(File.join(bundler_basedir, '..', '..', '..'))]
123
+ end
124
+ end
125
+
126
+ def gem_path
127
+ gem_paths_raw.join(File::PATH_SEPARATOR)
128
+ end
129
+
130
+ def gem_home
131
+ require 'pdk/util'
132
+
133
+ # TODO: bundle install --path is deprecated
134
+ # `bundle install --path` ignores all "system" installed gems and
135
+ # causes unnecessary package installs. `bundle install` (without
136
+ # --path) installs into GEM_HOME, which by default is non-user
137
+ # writeable.
138
+ # To still use the pre-installed packages, but allow folks to install
139
+ # additional gems, we set GEM_HOME to the user's cachedir and put all
140
+ # other cache locations onto GEM_PATH.
141
+ # See https://stackoverflow.com/a/11277228 for background
142
+ File.join(PDK::Util.cachedir, 'ruby', versions[ruby_version])
143
+ end
144
+
145
+ def available_puppet_versions
146
+ return @available_puppet_versions unless @available_puppet_versions.nil?
147
+
148
+ puppet_spec_files = PDK::Util::Filesystem.glob(File.join(gem_home, 'specifications', '**', 'puppet*.gemspec'))
149
+
150
+ gem_path.split(File::PATH_SEPARATOR).each do |path|
151
+ puppet_spec_files += PDK::Util::Filesystem.glob(File.join(path, 'specifications', '**', 'puppet*.gemspec'))
152
+ end
153
+
154
+ puppet_specs = []
155
+
156
+ puppet_spec_files.each do |specfile|
157
+ spec = Gem::Specification.load(specfile)
158
+ puppet_specs << spec if spec.name == 'puppet'
159
+ end
160
+
161
+ @available_puppet_versions = puppet_specs.map(&:version).sort { |a, b| b <=> a }
162
+ end
163
+
164
+ private
165
+
166
+ def default_ruby_version
167
+ self.class.default_ruby_version
168
+ end
169
+
170
+ def versions
171
+ self.class.versions
172
+ end
173
+
174
+ def bundler_basedir
175
+ Gem::Specification.latest_specs.find { |spec| spec.name.eql?('bundler') }.base_dir
176
+ end
177
+ end
178
+ end
179
+ end