Class: Kettle::Family::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/kettle/family/config.rb

Constant Summary collapse

DEFAULT_PATHS = 
[".kettle-family.yml", ".structuredmerge/kettle-family.yml"].freeze
DEFAULT_MEMBER_EXCLUDES = 
[
  "vendor/**",
  "**/vendor/**",
  "benchmarks/**",
  "**/benchmarks/**",
  "tmp/**",
  "**/tmp/**",
  "spec/**",
  "**/spec/**",
  "test/**",
  "**/test/**"
].freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(root:, path:, data:) ⇒ Config

Returns a new instance of Config.



35
36
37
38
39
 
# File 'lib/kettle/family/config.rb', line 35

def initialize(root:, path:, data:)
  @root = root
  @path = path
  @data = stringify_keys(data)
end

Instance Attribute Details

#data ⇒ Object (readonly)

Returns the value of attribute data.



22
23
24
 
# File 'lib/kettle/family/config.rb', line 22

def data
  @data
end

#path ⇒ Object (readonly)

Returns the value of attribute path.



22
23
24
 
# File 'lib/kettle/family/config.rb', line 22

def path
  @path
end

#root ⇒ Object (readonly)

Returns the value of attribute root.



22
23
24
 
# File 'lib/kettle/family/config.rb', line 22

def root
  @root
end

Class Method Details

.load(root:, path: nil) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
 
# File 'lib/kettle/family/config.rb', line 24

def self.load(root:, path: nil)
  expanded_root = File.expand_path(root)
  config_path = path && File.expand_path(path, expanded_root)
  config_path ||= DEFAULT_PATHS
    .map { |candidate| File.join(expanded_root, candidate) }
    .find { |candidate| File.file?(candidate) }

  data = config_path ? YAML.load_file(config_path) : {}
  new(root: expanded_root, path: config_path, data: data || {})
end

Instance Method Details

#branch_lanes ⇒ Object 



281
282
283
 
# File 'lib/kettle/family/config.rb', line 281

def branch_lanes
  fetch_path("branch_lanes") || fetch_path("branches", "lanes") || {}
end

#changelog_env ⇒ Object 



171
172
173
174
175
176
177
 
# File 'lib/kettle/family/config.rb', line 171

def changelog_env
  env = {}
  env["K_CHANGELOG_VERSION_FILE"] = changelog_version_file.to_s if changelog_version_file
  env["K_CHANGELOG_GEM_NAME"] = family_name.to_s if shared_changelog?

  env
end

#changelog_full_path(member) ⇒ Object 



167
168
169
 
# File 'lib/kettle/family/config.rb', line 167

def changelog_full_path(member)
  File.expand_path(changelog_path, shared_changelog? ? root : member.root)
end

#changelog_mode ⇒ Object 



147
148
149
 
# File 'lib/kettle/family/config.rb', line 147

def changelog_mode
  fetch_path("changelog", "mode") || "member"
end

#changelog_path ⇒ Object 



155
156
157
 
# File 'lib/kettle/family/config.rb', line 155

def changelog_path
  fetch_path("changelog", "path") || "CHANGELOG.md"
end

#changelog_version_file ⇒ Object 



159
160
161
 
# File 'lib/kettle/family/config.rb', line 159

def changelog_version_file
  fetch_path("changelog", "version_file")
end

#changelog_workdir(_member = nil) ⇒ Object 



163
164
165
 
# File 'lib/kettle/family/config.rb', line 163

def changelog_workdir(_member = nil)
  shared_changelog? ? root : nil
end

#check_forbidden_tracked_member_dirs ⇒ Object 



131
132
133
 
# File 'lib/kettle/family/config.rb', line 131

def check_forbidden_tracked_member_dirs
  fetch_path("check", "forbidden_tracked_member_dirs") || []
end

#check_forbidden_tracked_member_dirs_except ⇒ Object 



135
136
137
 
# File 'lib/kettle/family/config.rb', line 135

def check_forbidden_tracked_member_dirs_except
  fetch_path("check", "forbidden_tracked_member_dirs_except") || []
end

#check_member_required_dirs ⇒ Object 



127
128
129
 
# File 'lib/kettle/family/config.rb', line 127

def check_member_required_dirs
  fetch_path("check", "member_required_dirs") || []
end

#check_readme_links ⇒ Object 



139
140
141
 
# File 'lib/kettle/family/config.rb', line 139

def check_readme_links
  fetch_path("check", "readme_links") || {}
end

#check_required_bins ⇒ Object 



119
120
121
 
# File 'lib/kettle/family/config.rb', line 119

def check_required_bins
  fetch_path("check", "required_bins") || ReadinessCheck::REQUIRED_BINS
end

#check_required_files ⇒ Object 



115
116
117
 
# File 'lib/kettle/family/config.rb', line 115

def check_required_files
  fetch_path("check", "required_files") || ReadinessCheck::REQUIRED_FILES
end

#check_root_required_files ⇒ Object 



123
124
125
 
# File 'lib/kettle/family/config.rb', line 123

def check_root_required_files
  fetch_path("check", "root_required_files") || []
end

#command_for(name) ⇒ Object 



111
112
113
 
# File 'lib/kettle/family/config.rb', line 111

def command_for(name)
  fetch_path("commands", name)
end

#discover_members? ⇒ Boolean

Returns:

  • (Boolean) 


92
93
94
95
 
# File 'lib/kettle/family/config.rb', line 92

def discover_members?
  members = data.fetch("members", {})
  members.fetch("discover", true)
end

#explicit_members ⇒ Object 



82
83
84
85
86
87
88
89
90
 
# File 'lib/kettle/family/config.rb', line 82

def explicit_members
  members = data.fetch("members", {})
  explicit = members.fetch("explicit", [])
  explicit.map do |entry|
    entry = stringify_keys(entry)
    member_root = File.expand_path(entry.fetch("root"), root)
    entry.merge("root" => member_root)
  end
end

#family_local_path_env ⇒ Object 



58
59
60
61
62
63
 
# File 'lib/kettle/family/config.rb', line 58

def family_local_path_env
  name = family_local_path_env_name
  return {} unless name

  {name => family_local_path_root}
end

#family_local_path_env_name ⇒ Object 



45
46
47
48
49
50
51
 
# File 'lib/kettle/family/config.rb', line 45

def family_local_path_env_name
  configured = fetch_path("family", "local_path_env")
  return nil if configured == false
  return configured.to_s unless configured.to_s.empty?

  "#{family_name.gsub(/[^A-Za-z0-9]+/, "_").upcase}_DEV"
end

#family_local_path_root ⇒ Object 



53
54
55
56
 
# File 'lib/kettle/family/config.rb', line 53

def family_local_path_root
  configured = fetch_path("family", "local_path_root")
  configured ? expand_config_relative_path(configured) : root
end

#family_mode ⇒ Object 



65
66
67
 
# File 'lib/kettle/family/config.rb', line 65

def family_mode
  fetch_path("family", "mode") || "monorepo"
end

#family_name ⇒ Object 



41
42
43
 
# File 'lib/kettle/family/config.rb', line 41

def family_name
  fetch_path("family", "name") || File.basename(root)
end

#install_local_dependencies ⇒ Object 



226
227
228
229
230
231
232
 
# File 'lib/kettle/family/config.rb', line 226

def install_local_dependencies
  paths = fetch_path("install", "local_dependencies") || fetch_path("local_dependencies") || []
  Array(paths).map do |entry|
    value = entry.is_a?(Hash) ? stringify_keys(entry).fetch("path") : entry
    expand_config_relative_path(value)
  end
end

#member_exclude_patterns ⇒ Object 



97
98
99
100
101
 
# File 'lib/kettle/family/config.rb', line 97

def member_exclude_patterns
  members = data.fetch("members", {})
  patterns = members.fetch("exclude", nil) || members.fetch("ignore", nil) || []
  DEFAULT_MEMBER_EXCLUDES + Array(patterns)
end

#member_release_target_branches ⇒ Object 



274
275
276
277
278
279
 
# File 'lib/kettle/family/config.rb', line 274

def member_release_target_branches
  targets = fetch_path("release", "member_target_branches") || {}
  targets.to_h do |member_name, branches|
    [member_name.to_s, Array(branches).map(&:to_s)]
  end
end

#member_roots ⇒ Object 



74
75
76
77
78
79
80
 
# File 'lib/kettle/family/config.rb', line 74

def member_roots
  configured = fetch_path("members", "roots")
  return configured.map { |path| File.expand_path(path, root) } if configured
  return sibling_member_roots if family_mode == "sibling_repos"

  [members_root]
end

#members_root ⇒ Object 



69
70
71
72
 
# File 'lib/kettle/family/config.rb', line 69

def members_root
  configured = fetch_path("family", "members_root") || fetch_path("members", "root")
  configured ? File.expand_path(configured, root) : root
end

#normalize_lockfiles? ⇒ Boolean

Returns:

  • (Boolean) 


202
203
204
 
# File 'lib/kettle/family/config.rb', line 202

def normalize_lockfiles?
  fetch_path("template", "normalize_lockfiles") == true
end

#normalize_lockfiles_command ⇒ Object 



206
207
208
 
# File 'lib/kettle/family/config.rb', line 206

def normalize_lockfiles_command
  fetch_path("template", "normalize_lockfiles_command") || "bundle lock"
end

#order_hints ⇒ Object 



107
108
109
 
# File 'lib/kettle/family/config.rb', line 107

def order_hints
  fetch_path("members", "order", "hints") || []
end

#order_mode ⇒ Object 



103
104
105
 
# File 'lib/kettle/family/config.rb', line 103

def order_mode
  fetch_path("members", "order", "mode") || "dependency"
end

#pre_release_image_url_skip_patterns ⇒ Object 



143
144
145
 
# File 'lib/kettle/family/config.rb', line 143

def pre_release_image_url_skip_patterns
  Array(fetch_path("pre_release", "image_url_skip_patterns")).map(&:to_s)
end

#readme_corporate_sponsors ⇒ Object 



195
196
197
198
199
200
 
# File 'lib/kettle/family/config.rb', line 195

def readme_corporate_sponsors
  raw = fetch_path("readme", "corporate_sponsors") ||
    fetch_path("sponsorships", "corporate") ||
    fetch_path("corporate_sponsors")
  normalize_corporate_sponsors(raw)
end

#release_auto_dependency_floors? ⇒ Boolean

Returns:

  • (Boolean) 


250
251
252
 
# File 'lib/kettle/family/config.rb', line 250

def release_auto_dependency_floors?
  fetch_path("release", "auto_dependency_floors") != false
end

#release_build_command ⇒ Object 



234
235
236
 
# File 'lib/kettle/family/config.rb', line 234

def release_build_command
  fetch_path("release", "build_command") || command_for("release_build") || "bundle exec rake build"
end

#release_disable_local_path_env ⇒ Object 



221
222
223
224
 
# File 'lib/kettle/family/config.rb', line 221

def release_disable_local_path_env
  configured = fetch_path("release", "disable_local_path_env")
  Array(configured || default_release_disable_local_path_env)
end

#release_env ⇒ Object 



242
243
244
 
# File 'lib/kettle/family/config.rb', line 242

def release_env
  stringify_env(fetch_path("release", "env") || {})
end

#release_family_changelog? ⇒ Boolean

Returns:

  • (Boolean) 


254
255
256
 
# File 'lib/kettle/family/config.rb', line 254

def release_family_changelog?
  fetch_path("release", "family_changelog", "enabled") == true
end

#release_family_changelog_command ⇒ Object 



258
259
260
 
# File 'lib/kettle/family/config.rb', line 258

def release_family_changelog_command
  fetch_path("release", "family_changelog", "command") || "bundle exec kettle-changelog"
end

#release_jobs ⇒ Object 



246
247
248
 
# File 'lib/kettle/family/config.rb', line 246

def release_jobs
  fetch_path("release", "jobs")
end

#release_normalize_lockfiles? ⇒ Boolean

Returns:

  • (Boolean) 


210
211
212
213
214
215
 
# File 'lib/kettle/family/config.rb', line 210

def release_normalize_lockfiles?
  configured = fetch_path("release", "normalize_lockfiles")
  return configured unless configured.nil?

  normalize_lockfiles?
end

#release_normalize_lockfiles_command ⇒ Object 



217
218
219
 
# File 'lib/kettle/family/config.rb', line 217

def release_normalize_lockfiles_command
  fetch_path("release", "normalize_lockfiles_command") || normalize_lockfiles_command
end

#release_publish_command ⇒ Object 



238
239
240
 
# File 'lib/kettle/family/config.rb', line 238

def release_publish_command
  fetch_path("release", "publish_command") || command_for("release_publish") || "bundle exec kettle-release"
end

#release_push_command ⇒ Object 



266
267
268
 
# File 'lib/kettle/family/config.rb', line 266

def release_push_command
  fetch_path("release", "push_command") || command_for("release_push") || "git push --follow-tags"
end

#release_tag_command ⇒ Object 



262
263
264
 
# File 'lib/kettle/family/config.rb', line 262

def release_tag_command
  fetch_path("release", "tag_command") || command_for("release_tag") || "git tag"
end

#release_target_branches ⇒ Object 



270
271
272
 
# File 'lib/kettle/family/config.rb', line 270

def release_target_branches
  fetch_path("release", "target_branches") || fetch_path("branches", "release_targets") || []
end

#shared_changelog? ⇒ Boolean

Returns:

  • (Boolean) 


151
152
153
 
# File 'lib/kettle/family/config.rb', line 151

def shared_changelog?
  changelog_mode == "root"
end

#template_command ⇒ Object 



179
180
181
 
# File 'lib/kettle/family/config.rb', line 179

def template_command
  fetch_path("template", "command") || command_for("template")
end

#template_jobs ⇒ Object 



191
192
193
 
# File 'lib/kettle/family/config.rb', line 191

def template_jobs
  fetch_path("template", "jobs")
end

#template_profile ⇒ Object 



183
184
185
 
# File 'lib/kettle/family/config.rb', line 183

def template_profile
  fetch_path("template", "profile")
end

#template_repository_topology ⇒ Object 



187
188
189
 
# File 'lib/kettle/family/config.rb', line 187

def template_repository_topology
  fetch_path("template", "repository_topology")
end