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/**",
  "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.



33
34
35
36
37
 
# File 'lib/kettle/family/config.rb', line 33

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.



20
21
22
 
# File 'lib/kettle/family/config.rb', line 20

def data
  @data
end

#path ⇒ Object (readonly)

Returns the value of attribute path.



20
21
22
 
# File 'lib/kettle/family/config.rb', line 20

def path
  @path
end

#root ⇒ Object (readonly)

Returns the value of attribute root.



20
21
22
 
# File 'lib/kettle/family/config.rb', line 20

def root
  @root
end

Class Method Details

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



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

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 



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

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

#changelog_env ⇒ Object 



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

def changelog_env
  return {} unless changelog_version_file

  {"K_CHANGELOG_VERSION_FILE" => changelog_version_file.to_s}
end

#changelog_full_path(member) ⇒ Object 



141
142
143
 
# File 'lib/kettle/family/config.rb', line 141

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

#changelog_mode ⇒ Object 



121
122
123
 
# File 'lib/kettle/family/config.rb', line 121

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

#changelog_path ⇒ Object 



129
130
131
 
# File 'lib/kettle/family/config.rb', line 129

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

#changelog_version_file ⇒ Object 



133
134
135
 
# File 'lib/kettle/family/config.rb', line 133

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

#changelog_workdir(_member = nil) ⇒ Object 



137
138
139
 
# File 'lib/kettle/family/config.rb', line 137

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

#check_forbidden_tracked_member_dirs ⇒ Object 



109
110
111
 
# File 'lib/kettle/family/config.rb', line 109

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

#check_forbidden_tracked_member_dirs_except ⇒ Object 



113
114
115
 
# File 'lib/kettle/family/config.rb', line 113

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

#check_member_required_dirs ⇒ Object 



105
106
107
 
# File 'lib/kettle/family/config.rb', line 105

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

#check_readme_links ⇒ Object 



117
118
119
 
# File 'lib/kettle/family/config.rb', line 117

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

#check_required_bins ⇒ Object 



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

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

#check_required_files ⇒ Object 



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

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

#check_root_required_files ⇒ Object 



101
102
103
 
# File 'lib/kettle/family/config.rb', line 101

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

#command_for(name) ⇒ Object 



89
90
91
 
# File 'lib/kettle/family/config.rb', line 89

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

#discover_members? ⇒ Boolean

Returns:

  • (Boolean) 


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

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

#explicit_members ⇒ Object 



60
61
62
63
64
65
66
67
68
 
# File 'lib/kettle/family/config.rb', line 60

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_mode ⇒ Object 



43
44
45
 
# File 'lib/kettle/family/config.rb', line 43

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

#family_name ⇒ Object 



39
40
41
 
# File 'lib/kettle/family/config.rb', line 39

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

#install_local_dependencies ⇒ Object 



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

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 



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

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

#member_roots ⇒ Object 



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

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 



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

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) 


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

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

#normalize_lockfiles_command ⇒ Object 



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

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

#order_hints ⇒ Object 



85
86
87
 
# File 'lib/kettle/family/config.rb', line 85

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

#order_mode ⇒ Object 



81
82
83
 
# File 'lib/kettle/family/config.rb', line 81

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

#release_build_command ⇒ Object 



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

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

#release_env ⇒ Object 



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

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

#release_family_changelog? ⇒ Boolean

Returns:

  • (Boolean) 


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

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

#release_family_changelog_command ⇒ Object 



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

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

#release_publish_command ⇒ Object 



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

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

#release_push_command ⇒ Object 



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

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

#release_tag_command ⇒ Object 



199
200
201
 
# File 'lib/kettle/family/config.rb', line 199

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

#release_target_branches ⇒ Object 



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

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

#shared_changelog? ⇒ Boolean

Returns:

  • (Boolean) 


125
126
127
 
# File 'lib/kettle/family/config.rb', line 125

def shared_changelog?
  changelog_mode == "root"
end

#template_command ⇒ Object 



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

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

#template_profile ⇒ Object 



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

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

#template_repository_topology ⇒ Object 



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

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