Class: ChefDK::Command::Diff

Inherits:
Base
  • Object
show all
Includes:
ChefDK::Configurable, Policyfile::StorageConfigDelegation
Defined in:
lib/chef-dk/command/diff.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Policyfile::StorageConfigDelegation

#cache_path, #policyfile_expanded_path, #policyfile_filename, #policyfile_lock_expanded_path, #relative_paths_root

Methods included from ChefDK::Configurable

#chef_config, #chefdk_config, #config_loader

Methods inherited from Base

#needs_help?, #needs_version?, #run_with_default_options

Methods included from Helpers

#err, #msg, #omnibus_apps_dir, #omnibus_bin_dir, #omnibus_chefdk_location, #omnibus_embedded_bin_dir, #omnibus_install?, #omnibus_root, #stderr, #stdout, #system_command

Constructor Details

#initialize(*args) ⇒ Diff

Returns a new instance of Diff.



106
107
108
109
110
111
112
113
114
115
116
117
118
119
 
# File 'lib/chef-dk/command/diff.rb', line 106

def initialize(*args)
  super

  @ui = UI.new

  @old_base = nil
  @new_base = nil
  @policyfile_relative_path = nil
  @storage_config = nil
  @http_client = nil

  @old_lock = nil
  @new_lock = nil
end

Instance Attribute Details

#new_base ⇒ Object (readonly)

Returns the value of attribute new_base.



102
103
104
 
# File 'lib/chef-dk/command/diff.rb', line 102

def new_base
  @new_base
end

#old_base ⇒ Object (readonly)

Returns the value of attribute old_base.



101
102
103
 
# File 'lib/chef-dk/command/diff.rb', line 101

def old_base
  @old_base
end

#storage_config ⇒ Object (readonly)

Returns the value of attribute storage_config.



104
105
106
 
# File 'lib/chef-dk/command/diff.rb', line 104

def storage_config
  @storage_config
end

#ui ⇒ Object

Returns the value of attribute ui.



99
100
101
 
# File 'lib/chef-dk/command/diff.rb', line 99

def ui
  @ui
end

Instance Method Details

#apply_params!(params) ⇒ Object 



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
 
# File 'lib/chef-dk/command/diff.rb', line 194

def apply_params!(params)
  remaining_args = parse_options(params)

  if no_comparison_specified?(remaining_args)
    ui.err("No comparison specified")
    ui.err("")
    ui.err(opt_parser)
    false
  elsif conflicting_args_and_opts_given?(remaining_args)
    ui.err("Conflicting arguments and options: git and Policy Group comparisons cannot be mixed")
    ui.err("")
    ui.err(opt_parser)
    false
  elsif conflicting_git_options_given?
    ui.err("Conflicting git options: --head and --git are exclusive")
    ui.err("")
    ui.err(opt_parser)

    false
  elsif config[:head]
    set_policyfile_path_from_args(remaining_args)
    @old_base = Policyfile::ComparisonBase::Git.new("HEAD", policyfile_lock_relpath)
    @new_base = Policyfile::ComparisonBase::Local.new(policyfile_lock_relpath)
    true
  elsif config[:git]
    set_policyfile_path_from_args(remaining_args)
    parse_git_comparison(config[:git])
  else
    set_policyfile_path_from_args(remaining_args)
    parse_server_comparison(remaining_args)
  end
end

#comparing_policy_groups? ⇒ Boolean

Returns:

  • (Boolean) 


276
277
278
 
# File 'lib/chef-dk/command/diff.rb', line 276

def comparing_policy_groups?
  !(config[:git] || config[:head])
end

#conflicting_args_and_opts_given?(args) ⇒ Boolean

Returns:

  • (Boolean) 


268
269
270
 
# File 'lib/chef-dk/command/diff.rb', line 268

def conflicting_args_and_opts_given?(args)
  (config[:git] || config[:head]) && policy_group_comparison?(args)
end

#conflicting_git_options_given? ⇒ Boolean

Returns:

  • (Boolean) 


272
273
274
 
# File 'lib/chef-dk/command/diff.rb', line 272

def conflicting_git_options_given?
  config[:git] && config[:head]
end

#differ(ui = ui()) ⇒ Object 



151
152
153
154
155
156
157
 
# File 'lib/chef-dk/command/diff.rb', line 151

def differ(ui = ui())
  Policyfile::Differ.new(old_name: old_base.name,
                         old_lock: old_lock,
                         new_name: new_base.name,
                         new_lock: new_lock,
                         ui: ui)
end

#handle_error(error) ⇒ Object 



130
131
132
133
134
135
136
137
138
 
# File 'lib/chef-dk/command/diff.rb', line 130

def handle_error(error)
  ui.err("Error: #{error.message}")
  if error.respond_to?(:reason)
    ui.err("Reason: #{error.reason}")
    ui.err("")
    ui.err(error.extended_error_info) if debug?
    ui.err(error.cause.backtrace.join("\n")) if debug?
  end
end

#http_client ⇒ Object 



159
160
161
162
163
 
# File 'lib/chef-dk/command/diff.rb', line 159

def http_client
  @http_client ||= ChefDK::AuthenticatedHTTP.new(chef_config.chef_server_url,
                                                 signing_key_filename: chef_config.client_key,
                                                 client_name: chef_config.node_name)
end

#local_lock ⇒ Object 



179
180
181
 
# File 'lib/chef-dk/command/diff.rb', line 179

def local_lock
  @local_lock ||= local_lock_comparison_base.lock
end

#local_lock_comparison_base ⇒ Object

ComparisonBase for the local lockfile. This is used to get the policy_name which is needed to query the server for the lockfile of a particular policy_group.



186
187
188
 
# File 'lib/chef-dk/command/diff.rb', line 186

def local_lock_comparison_base
  Policyfile::ComparisonBase::Local.new(policyfile_lock_relpath)
end

#materialize_locks ⇒ Object 



303
304
305
306
 
# File 'lib/chef-dk/command/diff.rb', line 303

def materialize_locks
  @old_lock = old_base.lock
  @new_lock = new_base.lock
end

#new_lock ⇒ Object 



170
171
172
173
 
# File 'lib/chef-dk/command/diff.rb', line 170

def new_lock
  materialize_locks unless @new_lock
  @new_lock
end

#no_comparison_specified?(args) ⇒ Boolean

Returns:

  • (Boolean) 


264
265
266
 
# File 'lib/chef-dk/command/diff.rb', line 264

def no_comparison_specified?(args)
  !policy_group_comparison?(args) && !config[:head] && !config[:git]
end

#old_lock ⇒ Object 



165
166
167
168
 
# File 'lib/chef-dk/command/diff.rb', line 165

def old_lock
  materialize_locks unless @old_lock
  @old_lock
end

#parse_git_comparison(git_ref) ⇒ Object 



246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
 
# File 'lib/chef-dk/command/diff.rb', line 246

def parse_git_comparison(git_ref)
  if git_ref.include?("...")
    old_ref, new_ref, *extra = git_ref.split("...")
    @old_base, @new_base = [old_ref, new_ref].map do |r|
      Policyfile::ComparisonBase::Git.new(r, policyfile_lock_relpath)
    end

    unless extra.empty?
      ui.err("Unable to parse git comparison `#{git_ref}`. Only 2 references can be specified.")
      return false
    end
  else
    @old_base = Policyfile::ComparisonBase::Git.new(git_ref, policyfile_lock_relpath)
    @new_base = Policyfile::ComparisonBase::Local.new(policyfile_lock_relpath)
  end
  true
end

#parse_server_comparison(args) ⇒ Object 



227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
 
# File 'lib/chef-dk/command/diff.rb', line 227

def parse_server_comparison(args)
  comparison_string = args.last
  if comparison_string.include?("...")
    old_pgroup, new_pgroup, *extra = comparison_string.split("...")
    @old_base, @new_base = [old_pgroup, new_pgroup].map do |g|
      Policyfile::ComparisonBase::PolicyGroup.new(g, policy_name, http_client)
    end

    unless extra.empty?
      ui.err("Unable to parse policy group comparison `#{comparison_string}`. Only 2 references can be specified.")
      return false
    end
  else
    @old_base = Policyfile::ComparisonBase::PolicyGroup.new(comparison_string, policy_name, http_client)
    @new_base = Policyfile::ComparisonBase::Local.new(policyfile_lock_relpath)
  end
  true
end

#policy_group_comparison?(args) ⇒ Boolean

Try to detect if the only argument given is a policyfile path. This is necessary because we support an optional argument with the path to the ruby policyfile. It would be easier if we used an option like ‘-f`, but that would be inconsistent with other commands (`chef install`, `chef push`, etc.).

Returns:

  • (Boolean) 


285
286
287
288
289
 
# File 'lib/chef-dk/command/diff.rb', line 285

def policy_group_comparison?(args)
  return false if args.empty?
  return true if args.size > 1
  !(args.first =~ /\.rb\Z/)
end

#policy_name ⇒ Object 



175
176
177
 
# File 'lib/chef-dk/command/diff.rb', line 175

def policy_name
  local_lock["name"]
end

#policyfile_lock_relpath ⇒ Object 



190
191
192
 
# File 'lib/chef-dk/command/diff.rb', line 190

def policyfile_lock_relpath
  storage_config.policyfile_lock_filename
end

#print_diff ⇒ Object 



140
141
142
143
144
145
146
147
148
149
 
# File 'lib/chef-dk/command/diff.rb', line 140

def print_diff
  # eagerly evaluate locks so we hit any errors before we've entered
  # pagerland. Also, git commands behave weirdly when run while the pager
  # is active, doing this eagerly also avoids that issue
  materialize_locks
  Pager.new(enable_pager: config[:pager]).with_pager do |pager|
    differ = differ(pager.ui)
    differ.run_report
  end
end

#run(params = []) ⇒ Object 



121
122
123
124
125
126
127
128
 
# File 'lib/chef-dk/command/diff.rb', line 121

def run(params = [])
  return 1 unless apply_params!(params)
  print_diff
  0
rescue PolicyfileServiceError => e
  handle_error(e)
  1
end

#set_policyfile_path_from_args(args) ⇒ Object 



291
292
293
294
295
296
297
298
299
300
301
 
# File 'lib/chef-dk/command/diff.rb', line 291

def set_policyfile_path_from_args(args)
  policyfile_relative_path =
    if !comparing_policy_groups?
      args.first || "Policyfile.rb"
    elsif args.size == 1
      "Policyfile.rb"
    else
      args.first
    end
  @storage_config = Policyfile::StorageConfig.new.use_policyfile(policyfile_relative_path)
end