pdk 2.4.0 → 2.5.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +1336 -1329
- data/LICENSE +201 -201
- data/README.md +163 -163
- data/exe/pdk +10 -10
- data/lib/pdk/analytics/client/google_analytics.rb +143 -143
- data/lib/pdk/analytics/client/noop.rb +25 -25
- data/lib/pdk/analytics/util.rb +19 -19
- data/lib/pdk/analytics.rb +30 -30
- data/lib/pdk/answer_file.rb +12 -12
- data/lib/pdk/bolt.rb +19 -19
- data/lib/pdk/cli/build.rb +82 -82
- data/lib/pdk/cli/bundle.rb +48 -48
- data/lib/pdk/cli/config/get.rb +26 -26
- data/lib/pdk/cli/config.rb +22 -22
- data/lib/pdk/cli/console.rb +148 -148
- data/lib/pdk/cli/convert.rb +52 -52
- data/lib/pdk/cli/env.rb +52 -52
- data/lib/pdk/cli/errors.rb +25 -25
- data/lib/pdk/cli/exec/command.rb +293 -293
- data/lib/pdk/cli/exec/interactive_command.rb +114 -114
- data/lib/pdk/cli/exec.rb +84 -84
- data/lib/pdk/cli/exec_group.rb +104 -104
- data/lib/pdk/cli/get/config.rb +24 -24
- data/lib/pdk/cli/get.rb +20 -20
- data/lib/pdk/cli/module/build.rb +12 -12
- data/lib/pdk/cli/module/generate.rb +47 -47
- data/lib/pdk/cli/module.rb +14 -14
- data/lib/pdk/cli/new/class.rb +32 -32
- data/lib/pdk/cli/new/defined_type.rb +32 -32
- data/lib/pdk/cli/new/fact.rb +29 -29
- data/lib/pdk/cli/new/function.rb +29 -29
- data/lib/pdk/cli/new/module.rb +53 -53
- data/lib/pdk/cli/new/provider.rb +29 -29
- data/lib/pdk/cli/new/task.rb +34 -34
- data/lib/pdk/cli/new/test.rb +52 -52
- data/lib/pdk/cli/new/transport.rb +27 -27
- data/lib/pdk/cli/new.rb +21 -21
- data/lib/pdk/cli/release/prep.rb +39 -39
- data/lib/pdk/cli/release/publish.rb +50 -50
- data/lib/pdk/cli/release.rb +194 -194
- data/lib/pdk/cli/remove/config.rb +80 -80
- data/lib/pdk/cli/remove.rb +20 -20
- data/lib/pdk/cli/set/config.rb +119 -119
- data/lib/pdk/cli/set.rb +20 -20
- data/lib/pdk/cli/test/unit.rb +90 -90
- data/lib/pdk/cli/test.rb +11 -11
- data/lib/pdk/cli/update.rb +64 -64
- data/lib/pdk/cli/util/command_redirector.rb +27 -27
- data/lib/pdk/cli/util/interview.rb +72 -72
- data/lib/pdk/cli/util/option_normalizer.rb +55 -55
- data/lib/pdk/cli/util/option_validator.rb +68 -68
- data/lib/pdk/cli/util/spinner.rb +13 -13
- data/lib/pdk/cli/util/update_manager_printer.rb +82 -82
- data/lib/pdk/cli/util.rb +305 -305
- data/lib/pdk/cli/validate.rb +116 -116
- data/lib/pdk/cli.rb +175 -175
- data/lib/pdk/config/analytics_schema.json +26 -26
- data/lib/pdk/config/errors.rb +5 -5
- data/lib/pdk/config/ini_file.rb +183 -183
- data/lib/pdk/config/ini_file_setting.rb +39 -39
- data/lib/pdk/config/json.rb +34 -34
- data/lib/pdk/config/json_schema_namespace.rb +142 -142
- data/lib/pdk/config/json_schema_setting.rb +53 -53
- data/lib/pdk/config/json_with_schema.rb +49 -49
- data/lib/pdk/config/namespace.rb +354 -354
- data/lib/pdk/config/setting.rb +135 -135
- data/lib/pdk/config/validator.rb +31 -31
- data/lib/pdk/config/yaml.rb +46 -46
- data/lib/pdk/config/yaml_with_schema.rb +59 -59
- data/lib/pdk/config.rb +390 -390
- data/lib/pdk/context/control_repo.rb +60 -60
- data/lib/pdk/context/module.rb +28 -28
- data/lib/pdk/context/none.rb +22 -22
- data/lib/pdk/context.rb +99 -99
- data/lib/pdk/control_repo.rb +90 -90
- data/lib/pdk/generate/defined_type.rb +43 -43
- data/lib/pdk/generate/fact.rb +25 -25
- data/lib/pdk/generate/function.rb +48 -48
- data/lib/pdk/generate/module.rb +352 -352
- data/lib/pdk/generate/provider.rb +28 -28
- data/lib/pdk/generate/puppet_class.rb +43 -43
- data/lib/pdk/generate/puppet_object.rb +232 -232
- data/lib/pdk/generate/task.rb +68 -68
- data/lib/pdk/generate/transport.rb +33 -33
- data/lib/pdk/generate.rb +24 -24
- data/lib/pdk/i18n.rb +4 -4
- data/lib/pdk/logger.rb +45 -45
- data/lib/pdk/module/build.rb +322 -322
- data/lib/pdk/module/convert.rb +296 -296
- data/lib/pdk/module/metadata.rb +202 -202
- data/lib/pdk/module/release.rb +260 -260
- data/lib/pdk/module/update.rb +131 -131
- data/lib/pdk/module/update_manager.rb +227 -227
- data/lib/pdk/module.rb +30 -30
- data/lib/pdk/report/event.rb +370 -370
- data/lib/pdk/report.rb +121 -121
- data/lib/pdk/template/fetcher/git.rb +85 -85
- data/lib/pdk/template/fetcher/local.rb +28 -28
- data/lib/pdk/template/fetcher.rb +98 -98
- data/lib/pdk/template/renderer/v1/legacy_template_dir.rb +116 -116
- data/lib/pdk/template/renderer/v1/renderer.rb +132 -132
- data/lib/pdk/template/renderer/v1/template_file.rb +102 -102
- data/lib/pdk/template/renderer/v1.rb +25 -25
- data/lib/pdk/template/renderer.rb +96 -96
- data/lib/pdk/template/template_dir.rb +67 -67
- data/lib/pdk/template.rb +59 -59
- data/lib/pdk/tests/unit.rb +252 -252
- data/lib/pdk/util/bundler.rb +259 -259
- data/lib/pdk/util/changelog_generator.rb +137 -137
- data/lib/pdk/util/env.rb +47 -47
- data/lib/pdk/util/filesystem.rb +138 -138
- data/lib/pdk/util/git.rb +179 -179
- data/lib/pdk/util/json_finder.rb +85 -85
- data/lib/pdk/util/puppet_strings.rb +125 -125
- data/lib/pdk/util/puppet_version.rb +266 -266
- data/lib/pdk/util/ruby_version.rb +179 -179
- data/lib/pdk/util/template_uri.rb +295 -295
- data/lib/pdk/util/vendored_file.rb +93 -93
- data/lib/pdk/util/version.rb +43 -43
- data/lib/pdk/util/windows/api_types.rb +82 -82
- data/lib/pdk/util/windows/file.rb +36 -36
- data/lib/pdk/util/windows/process.rb +79 -79
- data/lib/pdk/util/windows/string.rb +16 -16
- data/lib/pdk/util/windows.rb +15 -15
- data/lib/pdk/util.rb +278 -278
- data/lib/pdk/validate/control_repo/control_repo_validator_group.rb +23 -23
- data/lib/pdk/validate/control_repo/environment_conf_validator.rb +98 -98
- data/lib/pdk/validate/external_command_validator.rb +208 -208
- data/lib/pdk/validate/internal_ruby_validator.rb +100 -100
- data/lib/pdk/validate/invokable_validator.rb +228 -228
- data/lib/pdk/validate/metadata/metadata_json_lint_validator.rb +86 -86
- data/lib/pdk/validate/metadata/metadata_syntax_validator.rb +78 -78
- data/lib/pdk/validate/metadata/metadata_validator_group.rb +20 -20
- data/lib/pdk/validate/puppet/puppet_epp_validator.rb +133 -133
- data/lib/pdk/validate/puppet/puppet_lint_validator.rb +66 -66
- data/lib/pdk/validate/puppet/puppet_syntax_validator.rb +137 -137
- data/lib/pdk/validate/puppet/puppet_validator_group.rb +21 -21
- data/lib/pdk/validate/ruby/ruby_rubocop_validator.rb +80 -80
- data/lib/pdk/validate/ruby/ruby_validator_group.rb +19 -19
- data/lib/pdk/validate/tasks/tasks_metadata_lint_validator.rb +88 -88
- data/lib/pdk/validate/tasks/tasks_name_validator.rb +50 -50
- data/lib/pdk/validate/tasks/tasks_validator_group.rb +20 -20
- data/lib/pdk/validate/validator.rb +118 -118
- data/lib/pdk/validate/validator_group.rb +104 -104
- data/lib/pdk/validate/yaml/yaml_syntax_validator.rb +95 -95
- data/lib/pdk/validate/yaml/yaml_validator_group.rb +19 -19
- data/lib/pdk/validate.rb +94 -94
- data/lib/pdk/version.rb +4 -4
- data/lib/pdk.rb +76 -76
- data/locales/config.yaml +21 -21
- data/locales/pdk.pot +2111 -2094
- metadata +3 -3
data/lib/pdk/generate/module.rb
CHANGED
@@ -1,352 +1,352 @@
|
|
1
|
-
require 'pdk'
|
2
|
-
|
3
|
-
module PDK
|
4
|
-
module Generate
|
5
|
-
class Module
|
6
|
-
def self.validate_options(opts)
|
7
|
-
require 'pdk/cli/util/option_validator'
|
8
|
-
|
9
|
-
unless PDK::CLI::Util::OptionValidator.valid_module_name?(opts[:module_name])
|
10
|
-
error_msg = _(
|
11
|
-
"'%{module_name}' is not a valid module name.\n" \
|
12
|
-
'Module names must begin with a lowercase letter and can only include lowercase letters, digits, and underscores.',
|
13
|
-
) % { module_name: opts[:module_name] }
|
14
|
-
raise PDK::CLI::ExitWithError, error_msg
|
15
|
-
end
|
16
|
-
|
17
|
-
target_dir = PDK::Util::Filesystem.expand_path(opts[:target_dir])
|
18
|
-
raise PDK::CLI::ExitWithError, _("The destination directory '%{dir}' already exists") % { dir: target_dir } if PDK::Util::Filesystem.exist?(target_dir)
|
19
|
-
end
|
20
|
-
|
21
|
-
def self.invoke(opts = {})
|
22
|
-
require 'pdk/util'
|
23
|
-
require 'pdk/util/template_uri'
|
24
|
-
require 'pathname'
|
25
|
-
|
26
|
-
validate_options(opts) unless opts[:module_name].nil?
|
27
|
-
|
28
|
-
metadata = prepare_metadata(opts)
|
29
|
-
|
30
|
-
target_dir = PDK::Util::Filesystem.expand_path(opts[:target_dir] || opts[:module_name])
|
31
|
-
parent_dir = File.dirname(target_dir)
|
32
|
-
|
33
|
-
begin
|
34
|
-
test_file = File.join(parent_dir, '.pdk-test-writable')
|
35
|
-
PDK::Util::Filesystem.write_file(test_file, 'This file was created by the Puppet Development Kit to test if this folder was writable, you can safely remove this file.')
|
36
|
-
PDK::Util::Filesystem.rm_f(test_file)
|
37
|
-
rescue Errno::EACCES
|
38
|
-
raise PDK::CLI::FatalError, _("You do not have permission to write to '%{parent_dir}'") % {
|
39
|
-
parent_dir: parent_dir,
|
40
|
-
}
|
41
|
-
end
|
42
|
-
|
43
|
-
temp_target_dir = PDK::Util.make_tmpdir_name('pdk-module-target')
|
44
|
-
|
45
|
-
prepare_module_directory(temp_target_dir)
|
46
|
-
|
47
|
-
template_uri = PDK::Util::TemplateURI.new(opts)
|
48
|
-
|
49
|
-
if template_uri.default? && template_uri.default_ref?
|
50
|
-
PDK.logger.info _('Using the default template-url and template-ref.')
|
51
|
-
else
|
52
|
-
PDK.logger.info _(
|
53
|
-
"Using the %{method} template-url and template-ref '%{template_uri}'." % {
|
54
|
-
method: opts.key?(:'template-url') ? _('specified') : _('saved'),
|
55
|
-
template_uri: template_uri.metadata_format,
|
56
|
-
},
|
57
|
-
)
|
58
|
-
end
|
59
|
-
|
60
|
-
begin
|
61
|
-
context = PDK::Context::None.new(temp_target_dir)
|
62
|
-
PDK::Template.with(template_uri, context) do |template_dir|
|
63
|
-
template_dir.render_new_module(metadata.data['name'], metadata.data) do |relative_file_path, file_content, file_status|
|
64
|
-
next if [:delete, :unmanage].include?(file_status)
|
65
|
-
file = Pathname.new(temp_target_dir) + relative_file_path
|
66
|
-
file.dirname.mkpath
|
67
|
-
PDK::Util::Filesystem.write_file(file, file_content)
|
68
|
-
end
|
69
|
-
|
70
|
-
# Add information about the template used to generate the module to the
|
71
|
-
# metadata (for a future update command).
|
72
|
-
metadata.update!(template_dir.metadata)
|
73
|
-
|
74
|
-
metadata.write!(File.join(temp_target_dir, 'metadata.json'))
|
75
|
-
end
|
76
|
-
rescue ArgumentError => e
|
77
|
-
raise PDK::CLI::ExitWithError, e
|
78
|
-
end
|
79
|
-
|
80
|
-
# Only update the answers files after metadata has been written.
|
81
|
-
require 'pdk/answer_file'
|
82
|
-
if template_uri.default? && template_uri.default_ref?
|
83
|
-
# If the user specifies our default template url via the command
|
84
|
-
# line, remove the saved template-url answer so that the template_uri
|
85
|
-
# resolution can find new default URLs in the future.
|
86
|
-
PDK.config.set(%w[user module_defaults template-url], nil) if opts.key?(:'template-url')
|
87
|
-
else
|
88
|
-
# Save the template-url answers if the module was generated using a
|
89
|
-
# template/reference other than ours.
|
90
|
-
PDK.config.set(%w[user module_defaults template-url], template_uri.metadata_format)
|
91
|
-
end
|
92
|
-
|
93
|
-
begin
|
94
|
-
if PDK::Util::Filesystem.mv(temp_target_dir, target_dir)
|
95
|
-
unless opts[:'skip-bundle-install']
|
96
|
-
Dir.chdir(target_dir) do
|
97
|
-
require 'pdk/util/bundler'
|
98
|
-
PDK::Util::Bundler.ensure_bundle!
|
99
|
-
end
|
100
|
-
end
|
101
|
-
|
102
|
-
PDK.logger.info _("Module '%{name}' generated at path '%{path}'.") % {
|
103
|
-
name: opts[:module_name],
|
104
|
-
path: target_dir,
|
105
|
-
}
|
106
|
-
PDK.logger.info _(
|
107
|
-
"In your module directory, add classes with the 'pdk new class' command.",
|
108
|
-
)
|
109
|
-
end
|
110
|
-
rescue Errno::EACCES => e
|
111
|
-
raise PDK::CLI::FatalError, _("Failed to move '%{source}' to '%{target}': %{message}") % {
|
112
|
-
source: temp_target_dir,
|
113
|
-
target: target_dir,
|
114
|
-
message: e.message,
|
115
|
-
}
|
116
|
-
end
|
117
|
-
end
|
118
|
-
|
119
|
-
def self.username_from_login
|
120
|
-
require 'etc'
|
121
|
-
|
122
|
-
login = Etc.getlogin || ''
|
123
|
-
login_clean = login.downcase.gsub(%r{[^0-9a-z]}i, '')
|
124
|
-
login_clean = 'username' if login_clean.empty?
|
125
|
-
|
126
|
-
if login_clean != login
|
127
|
-
PDK.logger.debug _('Your username is not a valid Forge username. Proceeding with the username %{username}. You can fix this later in metadata.json.') % {
|
128
|
-
username: login_clean,
|
129
|
-
}
|
130
|
-
end
|
131
|
-
|
132
|
-
login_clean
|
133
|
-
end
|
134
|
-
|
135
|
-
def self.prepare_metadata(opts = {})
|
136
|
-
require 'pdk/answer_file'
|
137
|
-
require 'pdk/module/metadata'
|
138
|
-
|
139
|
-
opts[:username] = (opts[:username] || PDK.config.get_within_scopes('module_defaults.forge_username') || username_from_login).downcase
|
140
|
-
|
141
|
-
defaults = PDK::Module::Metadata::DEFAULTS.dup
|
142
|
-
|
143
|
-
defaults['name'] = "#{opts[:username]}-#{opts[:module_name]}" unless opts[:module_name].nil?
|
144
|
-
PDK.config.with_scoped_value('module_defaults.author') { |val| defaults['author'] = val }
|
145
|
-
PDK.config.with_scoped_value('module_defaults.license') { |val| defaults['license'] = val }
|
146
|
-
defaults['license'] = opts[:license] if opts.key?(:license)
|
147
|
-
|
148
|
-
metadata = PDK::Module::Metadata.new(defaults)
|
149
|
-
module_interview(metadata, opts) unless opts[:'skip-interview']
|
150
|
-
|
151
|
-
metadata
|
152
|
-
end
|
153
|
-
|
154
|
-
def self.prepare_module_directory(target_dir)
|
155
|
-
[
|
156
|
-
File.join(target_dir, 'examples'),
|
157
|
-
File.join(target_dir, 'files'),
|
158
|
-
File.join(target_dir, 'manifests'),
|
159
|
-
File.join(target_dir, 'templates'),
|
160
|
-
File.join(target_dir, 'tasks'),
|
161
|
-
].each do |dir|
|
162
|
-
begin
|
163
|
-
PDK::Util::Filesystem.mkdir_p(dir)
|
164
|
-
rescue SystemCallError => e
|
165
|
-
raise PDK::CLI::FatalError, _("Unable to create directory '%{dir}': %{message}") % {
|
166
|
-
dir: dir,
|
167
|
-
message: e.message,
|
168
|
-
}
|
169
|
-
end
|
170
|
-
end
|
171
|
-
end
|
172
|
-
|
173
|
-
def self.module_interview(metadata, opts = {})
|
174
|
-
require 'pdk/module/metadata'
|
175
|
-
require 'pdk/cli/util/interview'
|
176
|
-
|
177
|
-
questions = [
|
178
|
-
{
|
179
|
-
name: 'module_name',
|
180
|
-
question: _('If you have a name for your module, add it here.'),
|
181
|
-
help: _('This is the name that will be associated with your module, it should be relevant to the modules content.'),
|
182
|
-
required: true,
|
183
|
-
validate_pattern: %r{\A[a-z][a-z0-9_]*\Z}i,
|
184
|
-
validate_message: _('Module names must begin with a lowercase letter and can only include lowercase letters, numbers, and underscores.'),
|
185
|
-
},
|
186
|
-
{
|
187
|
-
name: 'forge_username',
|
188
|
-
question: _('If you have a Puppet Forge username, add it here.'),
|
189
|
-
help: _('We can use this to upload your module to the Forge when it\'s complete.'),
|
190
|
-
required: true,
|
191
|
-
validate_pattern: %r{\A[a-z0-9]+\Z}i,
|
192
|
-
validate_message: _('Forge usernames can only contain lowercase letters and numbers'),
|
193
|
-
default: opts[:username],
|
194
|
-
},
|
195
|
-
{
|
196
|
-
name: 'version',
|
197
|
-
question: _('What version is this module?'),
|
198
|
-
help: _('Puppet uses Semantic Versioning (semver.org) to version modules.'),
|
199
|
-
required: true,
|
200
|
-
validate_pattern: %r{\A[0-9]+\.[0-9]+\.[0-9]+},
|
201
|
-
validate_message: _('Semantic Version numbers must be in the form MAJOR.MINOR.PATCH'),
|
202
|
-
default: metadata.data['version'],
|
203
|
-
forge_only: true,
|
204
|
-
},
|
205
|
-
{
|
206
|
-
name: 'author',
|
207
|
-
question: _('Who wrote this module?'),
|
208
|
-
help: _('This is used to credit the module\'s author.'),
|
209
|
-
required: true,
|
210
|
-
default: metadata.data['author'],
|
211
|
-
},
|
212
|
-
{
|
213
|
-
name: 'license',
|
214
|
-
question: _('What license does this module code fall under?'),
|
215
|
-
help: _('This should be an identifier from https://spdx.org/licenses/. Common values are "Apache-2.0", "MIT", or "proprietary".'),
|
216
|
-
required: true,
|
217
|
-
default: metadata.data['license'],
|
218
|
-
},
|
219
|
-
{
|
220
|
-
name: 'operatingsystem_support',
|
221
|
-
question: _('What operating systems does this module support?'),
|
222
|
-
help: _('Use the up and down keys to move between the choices, space to select and enter to continue.'),
|
223
|
-
required: true,
|
224
|
-
type: :multi_select,
|
225
|
-
choices: PDK::Module::Metadata::OPERATING_SYSTEMS,
|
226
|
-
default: PDK::Module::Metadata::DEFAULT_OPERATING_SYSTEMS.map do |os_name|
|
227
|
-
# tty-prompt uses a 1-index
|
228
|
-
PDK::Module::Metadata::OPERATING_SYSTEMS.keys.index(os_name) + 1
|
229
|
-
end,
|
230
|
-
},
|
231
|
-
{
|
232
|
-
name: 'summary',
|
233
|
-
question: _('Summarize the purpose of this module in a single sentence.'),
|
234
|
-
help: _('This helps other Puppet users understand what the module does.'),
|
235
|
-
required: true,
|
236
|
-
default: metadata.data['summary'],
|
237
|
-
forge_only: true,
|
238
|
-
},
|
239
|
-
{
|
240
|
-
name: 'source',
|
241
|
-
question: _('If there is a source code repository for this module, enter the URL here.'),
|
242
|
-
help: _('Skip this if no repository exists yet. You can update this later in the metadata.json.'),
|
243
|
-
required: true,
|
244
|
-
default: metadata.data['source'],
|
245
|
-
forge_only: true,
|
246
|
-
},
|
247
|
-
{
|
248
|
-
name: 'project_page',
|
249
|
-
question: _('If there is a URL where others can learn more about this module, enter it here.'),
|
250
|
-
help: _('Optional. You can update this later in the metadata.json.'),
|
251
|
-
default: metadata.data['project_page'],
|
252
|
-
forge_only: true,
|
253
|
-
},
|
254
|
-
{
|
255
|
-
name: 'issues_url',
|
256
|
-
question: _('If there is a public issue tracker for this module, enter its URL here.'),
|
257
|
-
help: _('Optional. You can update this later in the metadata.json.'),
|
258
|
-
default: metadata.data['issues_url'],
|
259
|
-
forge_only: true,
|
260
|
-
},
|
261
|
-
]
|
262
|
-
|
263
|
-
prompt = TTY::Prompt.new(help_color: :cyan)
|
264
|
-
|
265
|
-
interview = PDK::CLI::Util::Interview.new(prompt)
|
266
|
-
|
267
|
-
if opts[:only_ask]
|
268
|
-
questions.reject! do |question|
|
269
|
-
if %w[module_name forge_username].include?(question[:name])
|
270
|
-
metadata.data['name'] && metadata.data['name'] =~ %r{\A[a-z0-9]+-[a-z][a-z0-9_]*\Z}i
|
271
|
-
else
|
272
|
-
!opts[:only_ask].include?(question[:name])
|
273
|
-
end
|
274
|
-
end
|
275
|
-
else
|
276
|
-
questions.reject! { |q| q[:name] == 'module_name' } if opts.key?(:module_name)
|
277
|
-
questions.reject! { |q| q[:name] == 'license' } if opts.key?(:license)
|
278
|
-
questions.reject! { |q| q[:forge_only] } unless opts[:'full-interview']
|
279
|
-
end
|
280
|
-
|
281
|
-
interview.add_questions(questions)
|
282
|
-
|
283
|
-
if PDK::Util::Filesystem.file?('metadata.json')
|
284
|
-
puts _(
|
285
|
-
"\nWe need to update the metadata.json file for this module, so we\'re going to ask you %{count} " \
|
286
|
-
"questions.\n",
|
287
|
-
) % {
|
288
|
-
count: interview.num_questions,
|
289
|
-
}
|
290
|
-
else
|
291
|
-
puts _(
|
292
|
-
"\nWe need to create the metadata.json file for this module, so we\'re going to ask you %{count} " \
|
293
|
-
"questions.\n",
|
294
|
-
) % {
|
295
|
-
count: interview.num_questions,
|
296
|
-
}
|
297
|
-
end
|
298
|
-
|
299
|
-
puts _(
|
300
|
-
'If the question is not applicable to this module, accept the default option ' \
|
301
|
-
'shown after each question. You can modify any answers at any time by manually updating ' \
|
302
|
-
"the metadata.json file.\n\n",
|
303
|
-
)
|
304
|
-
|
305
|
-
answers = interview.run
|
306
|
-
|
307
|
-
if answers.nil?
|
308
|
-
PDK.logger.info _('No answers given, interview cancelled.')
|
309
|
-
exit 0
|
310
|
-
end
|
311
|
-
|
312
|
-
unless answers['forge_username'].nil?
|
313
|
-
opts[:username] = answers['forge_username']
|
314
|
-
|
315
|
-
unless answers['module_name'].nil?
|
316
|
-
opts[:module_name] = answers['module_name']
|
317
|
-
|
318
|
-
answers.delete('module_name')
|
319
|
-
end
|
320
|
-
|
321
|
-
answers['name'] = "#{opts[:username]}-" + (opts[:module_name])
|
322
|
-
answers.delete('forge_username')
|
323
|
-
end
|
324
|
-
|
325
|
-
answers['license'] = opts[:license] if opts.key?(:license)
|
326
|
-
answers['operatingsystem_support'].flatten! if answers.key?('operatingsystem_support')
|
327
|
-
|
328
|
-
metadata.update!(answers)
|
329
|
-
|
330
|
-
if opts[:prompt].nil? || opts[:prompt]
|
331
|
-
require 'pdk/cli/util'
|
332
|
-
|
333
|
-
continue = PDK::CLI::Util.prompt_for_yes(
|
334
|
-
_('Metadata will be generated based on this information, continue?'),
|
335
|
-
prompt: prompt,
|
336
|
-
cancel_message: _('Interview cancelled; exiting.'),
|
337
|
-
)
|
338
|
-
|
339
|
-
unless continue
|
340
|
-
PDK.logger.info _('Process cancelled; exiting.')
|
341
|
-
exit 0
|
342
|
-
end
|
343
|
-
end
|
344
|
-
|
345
|
-
require 'pdk/answer_file'
|
346
|
-
PDK.config.set(%w[user module_defaults forge_username], opts[:username]) unless opts[:username].nil?
|
347
|
-
PDK.config.set(%w[user module_defaults author], answers['author']) unless answers['author'].nil?
|
348
|
-
PDK.config.set(%w[user module_defaults license], answers['license']) unless answers['license'].nil?
|
349
|
-
end
|
350
|
-
end
|
351
|
-
end
|
352
|
-
end
|
1
|
+
require 'pdk'
|
2
|
+
|
3
|
+
module PDK
|
4
|
+
module Generate
|
5
|
+
class Module
|
6
|
+
def self.validate_options(opts)
|
7
|
+
require 'pdk/cli/util/option_validator'
|
8
|
+
|
9
|
+
unless PDK::CLI::Util::OptionValidator.valid_module_name?(opts[:module_name])
|
10
|
+
error_msg = _(
|
11
|
+
"'%{module_name}' is not a valid module name.\n" \
|
12
|
+
'Module names must begin with a lowercase letter and can only include lowercase letters, digits, and underscores.',
|
13
|
+
) % { module_name: opts[:module_name] }
|
14
|
+
raise PDK::CLI::ExitWithError, error_msg
|
15
|
+
end
|
16
|
+
|
17
|
+
target_dir = PDK::Util::Filesystem.expand_path(opts[:target_dir])
|
18
|
+
raise PDK::CLI::ExitWithError, _("The destination directory '%{dir}' already exists") % { dir: target_dir } if PDK::Util::Filesystem.exist?(target_dir)
|
19
|
+
end
|
20
|
+
|
21
|
+
def self.invoke(opts = {})
|
22
|
+
require 'pdk/util'
|
23
|
+
require 'pdk/util/template_uri'
|
24
|
+
require 'pathname'
|
25
|
+
|
26
|
+
validate_options(opts) unless opts[:module_name].nil?
|
27
|
+
|
28
|
+
metadata = prepare_metadata(opts)
|
29
|
+
|
30
|
+
target_dir = PDK::Util::Filesystem.expand_path(opts[:target_dir] || opts[:module_name])
|
31
|
+
parent_dir = File.dirname(target_dir)
|
32
|
+
|
33
|
+
begin
|
34
|
+
test_file = File.join(parent_dir, '.pdk-test-writable')
|
35
|
+
PDK::Util::Filesystem.write_file(test_file, 'This file was created by the Puppet Development Kit to test if this folder was writable, you can safely remove this file.')
|
36
|
+
PDK::Util::Filesystem.rm_f(test_file)
|
37
|
+
rescue Errno::EACCES
|
38
|
+
raise PDK::CLI::FatalError, _("You do not have permission to write to '%{parent_dir}'") % {
|
39
|
+
parent_dir: parent_dir,
|
40
|
+
}
|
41
|
+
end
|
42
|
+
|
43
|
+
temp_target_dir = PDK::Util.make_tmpdir_name('pdk-module-target')
|
44
|
+
|
45
|
+
prepare_module_directory(temp_target_dir)
|
46
|
+
|
47
|
+
template_uri = PDK::Util::TemplateURI.new(opts)
|
48
|
+
|
49
|
+
if template_uri.default? && template_uri.default_ref?
|
50
|
+
PDK.logger.info _('Using the default template-url and template-ref.')
|
51
|
+
else
|
52
|
+
PDK.logger.info _(
|
53
|
+
"Using the %{method} template-url and template-ref '%{template_uri}'." % {
|
54
|
+
method: opts.key?(:'template-url') ? _('specified') : _('saved'),
|
55
|
+
template_uri: template_uri.metadata_format,
|
56
|
+
},
|
57
|
+
)
|
58
|
+
end
|
59
|
+
|
60
|
+
begin
|
61
|
+
context = PDK::Context::None.new(temp_target_dir)
|
62
|
+
PDK::Template.with(template_uri, context) do |template_dir|
|
63
|
+
template_dir.render_new_module(metadata.data['name'], metadata.data) do |relative_file_path, file_content, file_status|
|
64
|
+
next if [:delete, :unmanage].include?(file_status)
|
65
|
+
file = Pathname.new(temp_target_dir) + relative_file_path
|
66
|
+
file.dirname.mkpath
|
67
|
+
PDK::Util::Filesystem.write_file(file, file_content)
|
68
|
+
end
|
69
|
+
|
70
|
+
# Add information about the template used to generate the module to the
|
71
|
+
# metadata (for a future update command).
|
72
|
+
metadata.update!(template_dir.metadata)
|
73
|
+
|
74
|
+
metadata.write!(File.join(temp_target_dir, 'metadata.json'))
|
75
|
+
end
|
76
|
+
rescue ArgumentError => e
|
77
|
+
raise PDK::CLI::ExitWithError, e
|
78
|
+
end
|
79
|
+
|
80
|
+
# Only update the answers files after metadata has been written.
|
81
|
+
require 'pdk/answer_file'
|
82
|
+
if template_uri.default? && template_uri.default_ref?
|
83
|
+
# If the user specifies our default template url via the command
|
84
|
+
# line, remove the saved template-url answer so that the template_uri
|
85
|
+
# resolution can find new default URLs in the future.
|
86
|
+
PDK.config.set(%w[user module_defaults template-url], nil) if opts.key?(:'template-url')
|
87
|
+
else
|
88
|
+
# Save the template-url answers if the module was generated using a
|
89
|
+
# template/reference other than ours.
|
90
|
+
PDK.config.set(%w[user module_defaults template-url], template_uri.metadata_format)
|
91
|
+
end
|
92
|
+
|
93
|
+
begin
|
94
|
+
if PDK::Util::Filesystem.mv(temp_target_dir, target_dir)
|
95
|
+
unless opts[:'skip-bundle-install']
|
96
|
+
Dir.chdir(target_dir) do
|
97
|
+
require 'pdk/util/bundler'
|
98
|
+
PDK::Util::Bundler.ensure_bundle!
|
99
|
+
end
|
100
|
+
end
|
101
|
+
|
102
|
+
PDK.logger.info _("Module '%{name}' generated at path '%{path}'.") % {
|
103
|
+
name: opts[:module_name],
|
104
|
+
path: target_dir,
|
105
|
+
}
|
106
|
+
PDK.logger.info _(
|
107
|
+
"In your module directory, add classes with the 'pdk new class' command.",
|
108
|
+
)
|
109
|
+
end
|
110
|
+
rescue Errno::EACCES => e
|
111
|
+
raise PDK::CLI::FatalError, _("Failed to move '%{source}' to '%{target}': %{message}") % {
|
112
|
+
source: temp_target_dir,
|
113
|
+
target: target_dir,
|
114
|
+
message: e.message,
|
115
|
+
}
|
116
|
+
end
|
117
|
+
end
|
118
|
+
|
119
|
+
def self.username_from_login
|
120
|
+
require 'etc'
|
121
|
+
|
122
|
+
login = Etc.getlogin || ''
|
123
|
+
login_clean = login.downcase.gsub(%r{[^0-9a-z]}i, '')
|
124
|
+
login_clean = 'username' if login_clean.empty?
|
125
|
+
|
126
|
+
if login_clean != login
|
127
|
+
PDK.logger.debug _('Your username is not a valid Forge username. Proceeding with the username %{username}. You can fix this later in metadata.json.') % {
|
128
|
+
username: login_clean,
|
129
|
+
}
|
130
|
+
end
|
131
|
+
|
132
|
+
login_clean
|
133
|
+
end
|
134
|
+
|
135
|
+
def self.prepare_metadata(opts = {})
|
136
|
+
require 'pdk/answer_file'
|
137
|
+
require 'pdk/module/metadata'
|
138
|
+
|
139
|
+
opts[:username] = (opts[:username] || PDK.config.get_within_scopes('module_defaults.forge_username') || username_from_login).downcase
|
140
|
+
|
141
|
+
defaults = PDK::Module::Metadata::DEFAULTS.dup
|
142
|
+
|
143
|
+
defaults['name'] = "#{opts[:username]}-#{opts[:module_name]}" unless opts[:module_name].nil?
|
144
|
+
PDK.config.with_scoped_value('module_defaults.author') { |val| defaults['author'] = val }
|
145
|
+
PDK.config.with_scoped_value('module_defaults.license') { |val| defaults['license'] = val }
|
146
|
+
defaults['license'] = opts[:license] if opts.key?(:license)
|
147
|
+
|
148
|
+
metadata = PDK::Module::Metadata.new(defaults)
|
149
|
+
module_interview(metadata, opts) unless opts[:'skip-interview']
|
150
|
+
|
151
|
+
metadata
|
152
|
+
end
|
153
|
+
|
154
|
+
def self.prepare_module_directory(target_dir)
|
155
|
+
[
|
156
|
+
File.join(target_dir, 'examples'),
|
157
|
+
File.join(target_dir, 'files'),
|
158
|
+
File.join(target_dir, 'manifests'),
|
159
|
+
File.join(target_dir, 'templates'),
|
160
|
+
File.join(target_dir, 'tasks'),
|
161
|
+
].each do |dir|
|
162
|
+
begin
|
163
|
+
PDK::Util::Filesystem.mkdir_p(dir)
|
164
|
+
rescue SystemCallError => e
|
165
|
+
raise PDK::CLI::FatalError, _("Unable to create directory '%{dir}': %{message}") % {
|
166
|
+
dir: dir,
|
167
|
+
message: e.message,
|
168
|
+
}
|
169
|
+
end
|
170
|
+
end
|
171
|
+
end
|
172
|
+
|
173
|
+
def self.module_interview(metadata, opts = {})
|
174
|
+
require 'pdk/module/metadata'
|
175
|
+
require 'pdk/cli/util/interview'
|
176
|
+
|
177
|
+
questions = [
|
178
|
+
{
|
179
|
+
name: 'module_name',
|
180
|
+
question: _('If you have a name for your module, add it here.'),
|
181
|
+
help: _('This is the name that will be associated with your module, it should be relevant to the modules content.'),
|
182
|
+
required: true,
|
183
|
+
validate_pattern: %r{\A[a-z][a-z0-9_]*\Z}i,
|
184
|
+
validate_message: _('Module names must begin with a lowercase letter and can only include lowercase letters, numbers, and underscores.'),
|
185
|
+
},
|
186
|
+
{
|
187
|
+
name: 'forge_username',
|
188
|
+
question: _('If you have a Puppet Forge username, add it here.'),
|
189
|
+
help: _('We can use this to upload your module to the Forge when it\'s complete.'),
|
190
|
+
required: true,
|
191
|
+
validate_pattern: %r{\A[a-z0-9]+\Z}i,
|
192
|
+
validate_message: _('Forge usernames can only contain lowercase letters and numbers'),
|
193
|
+
default: opts[:username],
|
194
|
+
},
|
195
|
+
{
|
196
|
+
name: 'version',
|
197
|
+
question: _('What version is this module?'),
|
198
|
+
help: _('Puppet uses Semantic Versioning (semver.org) to version modules.'),
|
199
|
+
required: true,
|
200
|
+
validate_pattern: %r{\A[0-9]+\.[0-9]+\.[0-9]+},
|
201
|
+
validate_message: _('Semantic Version numbers must be in the form MAJOR.MINOR.PATCH'),
|
202
|
+
default: metadata.data['version'],
|
203
|
+
forge_only: true,
|
204
|
+
},
|
205
|
+
{
|
206
|
+
name: 'author',
|
207
|
+
question: _('Who wrote this module?'),
|
208
|
+
help: _('This is used to credit the module\'s author.'),
|
209
|
+
required: true,
|
210
|
+
default: metadata.data['author'],
|
211
|
+
},
|
212
|
+
{
|
213
|
+
name: 'license',
|
214
|
+
question: _('What license does this module code fall under?'),
|
215
|
+
help: _('This should be an identifier from https://spdx.org/licenses/. Common values are "Apache-2.0", "MIT", or "proprietary".'),
|
216
|
+
required: true,
|
217
|
+
default: metadata.data['license'],
|
218
|
+
},
|
219
|
+
{
|
220
|
+
name: 'operatingsystem_support',
|
221
|
+
question: _('What operating systems does this module support?'),
|
222
|
+
help: _('Use the up and down keys to move between the choices, space to select and enter to continue.'),
|
223
|
+
required: true,
|
224
|
+
type: :multi_select,
|
225
|
+
choices: PDK::Module::Metadata::OPERATING_SYSTEMS,
|
226
|
+
default: PDK::Module::Metadata::DEFAULT_OPERATING_SYSTEMS.map do |os_name|
|
227
|
+
# tty-prompt uses a 1-index
|
228
|
+
PDK::Module::Metadata::OPERATING_SYSTEMS.keys.index(os_name) + 1
|
229
|
+
end,
|
230
|
+
},
|
231
|
+
{
|
232
|
+
name: 'summary',
|
233
|
+
question: _('Summarize the purpose of this module in a single sentence.'),
|
234
|
+
help: _('This helps other Puppet users understand what the module does.'),
|
235
|
+
required: true,
|
236
|
+
default: metadata.data['summary'],
|
237
|
+
forge_only: true,
|
238
|
+
},
|
239
|
+
{
|
240
|
+
name: 'source',
|
241
|
+
question: _('If there is a source code repository for this module, enter the URL here.'),
|
242
|
+
help: _('Skip this if no repository exists yet. You can update this later in the metadata.json.'),
|
243
|
+
required: true,
|
244
|
+
default: metadata.data['source'],
|
245
|
+
forge_only: true,
|
246
|
+
},
|
247
|
+
{
|
248
|
+
name: 'project_page',
|
249
|
+
question: _('If there is a URL where others can learn more about this module, enter it here.'),
|
250
|
+
help: _('Optional. You can update this later in the metadata.json.'),
|
251
|
+
default: metadata.data['project_page'],
|
252
|
+
forge_only: true,
|
253
|
+
},
|
254
|
+
{
|
255
|
+
name: 'issues_url',
|
256
|
+
question: _('If there is a public issue tracker for this module, enter its URL here.'),
|
257
|
+
help: _('Optional. You can update this later in the metadata.json.'),
|
258
|
+
default: metadata.data['issues_url'],
|
259
|
+
forge_only: true,
|
260
|
+
},
|
261
|
+
]
|
262
|
+
|
263
|
+
prompt = TTY::Prompt.new(help_color: :cyan)
|
264
|
+
|
265
|
+
interview = PDK::CLI::Util::Interview.new(prompt)
|
266
|
+
|
267
|
+
if opts[:only_ask]
|
268
|
+
questions.reject! do |question|
|
269
|
+
if %w[module_name forge_username].include?(question[:name])
|
270
|
+
metadata.data['name'] && metadata.data['name'] =~ %r{\A[a-z0-9]+-[a-z][a-z0-9_]*\Z}i
|
271
|
+
else
|
272
|
+
!opts[:only_ask].include?(question[:name])
|
273
|
+
end
|
274
|
+
end
|
275
|
+
else
|
276
|
+
questions.reject! { |q| q[:name] == 'module_name' } if opts.key?(:module_name)
|
277
|
+
questions.reject! { |q| q[:name] == 'license' } if opts.key?(:license)
|
278
|
+
questions.reject! { |q| q[:forge_only] } unless opts[:'full-interview']
|
279
|
+
end
|
280
|
+
|
281
|
+
interview.add_questions(questions)
|
282
|
+
|
283
|
+
if PDK::Util::Filesystem.file?('metadata.json')
|
284
|
+
puts _(
|
285
|
+
"\nWe need to update the metadata.json file for this module, so we\'re going to ask you %{count} " \
|
286
|
+
"questions.\n",
|
287
|
+
) % {
|
288
|
+
count: interview.num_questions,
|
289
|
+
}
|
290
|
+
else
|
291
|
+
puts _(
|
292
|
+
"\nWe need to create the metadata.json file for this module, so we\'re going to ask you %{count} " \
|
293
|
+
"questions.\n",
|
294
|
+
) % {
|
295
|
+
count: interview.num_questions,
|
296
|
+
}
|
297
|
+
end
|
298
|
+
|
299
|
+
puts _(
|
300
|
+
'If the question is not applicable to this module, accept the default option ' \
|
301
|
+
'shown after each question. You can modify any answers at any time by manually updating ' \
|
302
|
+
"the metadata.json file.\n\n",
|
303
|
+
)
|
304
|
+
|
305
|
+
answers = interview.run
|
306
|
+
|
307
|
+
if answers.nil?
|
308
|
+
PDK.logger.info _('No answers given, interview cancelled.')
|
309
|
+
exit 0
|
310
|
+
end
|
311
|
+
|
312
|
+
unless answers['forge_username'].nil?
|
313
|
+
opts[:username] = answers['forge_username']
|
314
|
+
|
315
|
+
unless answers['module_name'].nil?
|
316
|
+
opts[:module_name] = answers['module_name']
|
317
|
+
|
318
|
+
answers.delete('module_name')
|
319
|
+
end
|
320
|
+
|
321
|
+
answers['name'] = "#{opts[:username]}-" + (opts[:module_name])
|
322
|
+
answers.delete('forge_username')
|
323
|
+
end
|
324
|
+
|
325
|
+
answers['license'] = opts[:license] if opts.key?(:license)
|
326
|
+
answers['operatingsystem_support'].flatten! if answers.key?('operatingsystem_support')
|
327
|
+
|
328
|
+
metadata.update!(answers)
|
329
|
+
|
330
|
+
if opts[:prompt].nil? || opts[:prompt]
|
331
|
+
require 'pdk/cli/util'
|
332
|
+
|
333
|
+
continue = PDK::CLI::Util.prompt_for_yes(
|
334
|
+
_('Metadata will be generated based on this information, continue?'),
|
335
|
+
prompt: prompt,
|
336
|
+
cancel_message: _('Interview cancelled; exiting.'),
|
337
|
+
)
|
338
|
+
|
339
|
+
unless continue
|
340
|
+
PDK.logger.info _('Process cancelled; exiting.')
|
341
|
+
exit 0
|
342
|
+
end
|
343
|
+
end
|
344
|
+
|
345
|
+
require 'pdk/answer_file'
|
346
|
+
PDK.config.set(%w[user module_defaults forge_username], opts[:username]) unless opts[:username].nil?
|
347
|
+
PDK.config.set(%w[user module_defaults author], answers['author']) unless answers['author'].nil?
|
348
|
+
PDK.config.set(%w[user module_defaults license], answers['license']) unless answers['license'].nil?
|
349
|
+
end
|
350
|
+
end
|
351
|
+
end
|
352
|
+
end
|