class ChefCLI::CLI

def commands_map 

def commands_map
  ChefCLI.commands_map
end

def drive_upcase(path)

upcase drive letters for comparison since ruby has a String#capitalize function 
def drive_upcase(path)
  if Chef::Platform.windows? && path[0] =~ /^[A-Za-z]$/ && path[1, 2] == ":\\"
    path.capitalize
  else
    path
  end
end

def env 

def env
  ENV
end

def exit(n) 

def exit(n)
  Kernel.exit(n)
end

def handle_options

If no subcommand is given, then this class is handling the CLI request. 
def handle_options
  parse_options(argv)
  if config[:version]
    show_version
  else
    show_help
  end
  exit 0
end

def have_command?(name) 

def have_command?(name)
  commands_map.have_command?(name)
end

def initialize(argv) 

def initialize(argv)
  @argv = argv
  super() # mixlib-cli #initialize doesn't allow arguments
end

def instantiate_subcommand(name) 

def instantiate_subcommand(name)
  commands_map.instantiate(name)
end

def normalized_exit_code(maybe_integer) 

def normalized_exit_code(maybe_integer)
  if maybe_integer.kind_of?(Integer) && (0..255).cover?(maybe_integer)
    maybe_integer
  else
    0
  end
end

def option?(param) 

def option?(param)
  param =~ /^-/
end

def path_key

Find PATH or Path correctly if we are on Windows 
def path_key
  env.keys.grep(/\Apath\Z/i).first
end

def run(enforce_license: false) 

def run(enforce_license: false)
  sanity_check!
  subcommand_name, *subcommand_params = argv
  #
  # Runs the appropriate subcommand if the given parameters contain any
  # subcommands.
  #
  if subcommand_name.nil? || option?(subcommand_name)
    handle_options
  elsif have_command?(subcommand_name)
    subcommand = instantiate_subcommand(subcommand_name)
    exit_code = subcommand.run_with_default_options(enforce_license, subcommand_params)
    exit normalized_exit_code(exit_code)
  else
    err "Unknown command `#{subcommand_name}'."
    show_help
    exit 1
  end
rescue OptionParser::InvalidOption => e
  err(e.message)
  show_help
  exit 1
end

def sanity_check!

defeat appbundler and interact very badly with our intent.
when they have the embedded_bin_dir before the omnibus_bin_dir -- both of which will
catch the cases where users setup only the embedded_bin_dir in their path, or 
def sanity_check!
  # When installed outside of omnibus, trust the user to configure their PATH
  return true unless omnibus_install?
  paths = env[path_key].split(File::PATH_SEPARATOR)
  paths.map! { |p| drive_upcase(Chef::Util::PathHelper.cleanpath(p)) }
  embed_index = paths.index(drive_upcase(Chef::Util::PathHelper.cleanpath(omnibus_embedded_bin_dir)))
  bin_index = paths.index(drive_upcase(Chef::Util::PathHelper.cleanpath(omnibus_bin_dir)))
  if embed_index
    if bin_index
      if embed_index < bin_index
        err("WARN: #{omnibus_embedded_bin_dir} is before #{omnibus_bin_dir} in your #{path_key}, please reverse that order.")
        err("WARN: consider using `#{ChefCLI::Dist::EXEC} shell-init <shell>` command to setup your environment correctly.")
      end
    else
      err("WARN: only #{omnibus_embedded_bin_dir} is present in your path, you must add #{omnibus_bin_dir} before that directory.")
      err("WARN: consider using `#{ChefCLI::Dist::EXEC} shell-init <shell>` command to setup your environment correctly.")
    end
  end
end

def show_help 

def show_help
  msg(banner)
  msg("\nAvailable Commands:")
  justify_length = subcommands.map(&:length).max + 2
  subcommand_specs.each do |name, spec|
    next if spec.hidden
    msg("    #{"#{name}".ljust(justify_length)}#{spec.description}")
  end
end

def show_version 

def show_version
  msg("#{ChefCLI::Dist::PRODUCT} version: #{ChefCLI::VERSION}")
  { "#{ChefCLI::Dist::INFRA_CLIENT_PRODUCT}": "#{ChefCLI::Dist::INFRA_CLIENT_CLI}",
    "#{ChefCLI::Dist::INSPEC_PRODUCT}": "#{ChefCLI::Dist::INSPEC_CLI}",
    "Test Kitchen": "kitchen",
    "Foodcritic": "foodcritic",
    "Cookstyle": "cookstyle",
  }.each do |name, cli|
    result = Bundler.with_clean_env { shell_out("#{cli} --version") }
    if result.exitstatus != 0
      msg("#{name} version: ERROR")
    else
      version = result.stdout.lines.first.scan(/(?:master\s)?[\d+\.\(\)]+\S+/).join("\s")
      msg("#{name} version: #{version}")
    end
  end
end

def subcommand_specs 

def subcommand_specs
  commands_map.command_specs
end

def subcommands 

def subcommands
  commands_map.command_names
end