module Cookbooks

# File lib/cookbooks/module_methods/all_binaries.rb, line 50
def self.all_binaries?
  ALL_BINARIES
end

# File lib/cookbooks/utility_scripts/registered_headers.rb, line 45
def self.all_headers?
  ALL_HEADERS
end

# File lib/cookbooks/module_methods/all_libraries.rb, line 50
def self.all_libraries?
  ALL_LIBRARIES
end

# File lib/cookbooks/utility_scripts/registered_tags.rb, line 40
def self.all_tags?
  ALL_TAGS
end

# File lib/cookbooks/utility_scripts/all_urls.rb, line 231
def self.all_urls(optional_commands = nil)
  Cookbooks::AllUrls.new(optional_commands)
end

# File lib/cookbooks/misc/save_file.rb, line 43
def self.append_what_into(what, into)
  ::Cookbooks::SaveFile.append_what_into(what, into)
end

# File lib/cookbooks/module_methods/are_we_on_gobolinux.rb, line 14
def self.are_we_on_gobolinux?
  return_this = false
  use_this_env_key = 'IS_ON_GOBOLINUX'
  if ENV.has_key? use_this_env_key
    if ENV[use_this_env_key].to_s == '1'
      return_this = true
    end
  end
  return return_this
end

# File lib/cookbooks/misc/available_cookbooks.rb, line 213
def self.available_cookbooks?
  Cookbooks::AvailableCookbooks.new.results?
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 332
def self.base_dir_to_store_expanded_cookbooks?
  "#{::Cookbooks.store_into_this_directory}expanded_cookbooks/"
end

# File lib/cookbooks/utility_scripts/blfs.rb, line 224
def self.blfs(i = 'curl')
  Cookbooks::Blfs.new(i)
end

# File lib/cookbooks/module_methods/chained_programs.rb, line 17
def self.chained_programs?
  YAML.load_file(FILE_COOKBOOK_CHAINED_PROGRAMS)
end

# File lib/cookbooks/module_methods/report_extended_information_about_this_program.rb, line 17
def self.check_and_report_whether_file_exists(
    i,
    optional_cookbook_object = nil
  )
  i = i.to_s
  unless File.exist? i
    opnn; Colours.ewarn 'This archive does not exist locally, at'
    opnn; Colours.ewarn '  `'+Colours.sfile(i)+swarn('`')
    if optional_cookbook_object
      if optional_cookbook_object.do_not_download?
        opnn; e 'This is, however had, no problem as it will not'
        opnn; e 'be downloaded anyway.'
      end
    end
    cliner :lightblue
  end
end

# File lib/cookbooks/module_methods/check_this_cookbook_file_for_errors.rb, line 58
def self.check_this_cookbook_file_for_errors(
    this_file = '/Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/cookbooks/lib/cookbooks/yaml/individual_cookbooks/jasper.yml'
  )
  if this_file.is_a? Array
    this_file = this_file.first
  end
  if this_file.nil?
    this_file = '/Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/cookbooks/lib/cookbooks/yaml/individual_cookbooks/jasper.yml'
  end
  if File.exist? this_file
    registered_cookbook_entries = Cookbooks.registered_cookbook_entries?
    dataset = YAML.load_file(this_file)
    key = dataset.keys.first
    available_entries_from_the_cookbooks_file = dataset[key].keys
    # ===================================================================== #
    # Next, obtain the entries that were not registered. Keep in mind
    # that this Array may be entry.
    # ===================================================================== #
    these_entries_were_not_registered = available_entries_from_the_cookbooks_file.reject {|entry|
      registered_cookbook_entries.include? entry
    }
    unless these_entries_were_not_registered.empty?
      opn; e 'The file at `'+sfile(this_file)+'`'
      opn; e 'contains at the least one erroneous entry.'
      these_entries_were_not_registered.each {|this_entry_is_not_included|
        opn; e 'The entry `'+sfancy(this_entry_is_not_included)+'` is not registered.'
      } 
    end
  else
    opn; e 'No file exists at '+this_file+'.'
  end
end

# File lib/cookbooks/module_methods/commandline_options.rb, line 15
def self.commandline_options?
  @commandline_options
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 59
def self.configuration_object?
  @configuration_object
end

# File lib/cookbooks/module_methods/convert_global_env.rb, line 16
def self.convert_global_env(i)
  ConvertGlobalEnv[i]
end

# File lib/cookbooks/module_methods/aliases.rb, line 18
def self.cookbook_aliases
  COOKBOOK_ALIASES.keys.sort
end

# File lib/cookbooks/aliases/cookbook_aliases.rb, line 28
def self.cookbook_aliases?
  COOKBOOK_ALIASES
end

# File lib/cookbooks/directory/cookbooks_configuration_dir.rb, line 21
def self.cookbooks_configuration_dir?
  COOKBOOKS_CONFIGURATION_DIR
end

# File lib/cookbooks/gobolinux/create_recipe.rb, line 443
def self.create_gobolinux_recipe(i = 'htop')
  yielded = nil
  if block_given?
    yielded = yield
  end
  ::Cookbooks::Gobolinux::CreateRecipe.new(i) { yielded }
end

# File lib/cookbooks/module_methods/create_html_page_for_these_programs.rb, line 26
def self.create_html_page_for_these_programs(array = ARGV)
  if array.is_a?(String) and
     array.start_with?(':')
    array = array.to_s.delete(':').to_sym
  end
  if array.is_a? Symbol
    unless Cookbooks.const_defined? :SearchForTags
      require 'cookbooks/utility_scripts/search_for_tags/search_for_tags.rb'
    end
    # ===================================================================== #
    # Handle special cases such as KDE5.
    # ===================================================================== #
    case array # case tag
    # ===================================================================== #
    # === cookbooks --create_html_page_for_these_programs=:kde5
    # ===================================================================== #
    when :kde, :kde5
      array = ::Cookbooks.return_all_programs_that_match_this_tag(:kde5)
    # ===================================================================== #
    # === cookbooks --create_html_page_for_these_programs=:kde5_toolchain
    # ===================================================================== #
    when :kde5_toolchain
      # =================================================================== #
      # This variant here should be equivalent to LFS/BLFS, in the proper
      # order. This thus requires a yaml file.
      # =================================================================== #
      dataset = YAML.load_file(FILE_COOKBOOK_CHAINED_PROGRAMS)
      array = dataset['kde5_foundation']+
              dataset['kde5_plasma']+
              dataset['kde5_applications']+
              dataset['kde5_porting_aids']
      array.delete!(' ')
      array = array.split(',')
    end
  end
  if array.is_a? Array
    if array.first.is_a?(String) and array.first.include?(',') # <- Input such as ["php,kio,ruby"]
      array = array.first.split(',')
    end
    array.flatten!
    if array.size > 20
      opn; e 'More than 20 entries were given (exactly '+
             sfancy(array.size.to_s)+'). This may take a while.'
    end
    @html_page_content = "<html><head><title>HTML Pages for programs</title>"\
                         "<style>pre { font-size: 1.4em; }</style>"\
                         "</head><body><hr>\n".dup # Reset again.
    array.each_with_index {|this_program, index| index += 1
      # =================================================================== #
      # For each program, we do the same actions:
      #   (1) Obtain the dataset via Cookbooks::Cookbook.new() OR
      #       from the expanded directory containing all yaml files.
      #   (2)
      # =================================================================== #
      if File.directory?(DIRECTORY_EXPANDED_COOKBOOKS) and
         File.exist?(target_file = "#{DIRECTORY_EXPANDED_COOKBOOKS}#{this_program}.yml")
        dataset = YAML.load_file(target_file)
        remote_url  = dataset['url1']
        description = dataset['raw_description']
        licence     = dataset['licence']
        homepage    = dataset['homepage'].to_s
      else
        dataset = Cookbooks::Cookbook.new(this_program)
        remote_url  = dataset.url1?
        description = dataset.raw_description?
        licence     = dataset.licence?
        homepage    = dataset.homepage?
      end
      if licence.is_a? Array
        licence = licence.join(', ')
      end
      @html_page_content << "<p>\n<h3 style=\"color:darkgreen\"><b style=\"color:darkblue\">"\
                            "#{index})</b> #{this_program}</h3><br>\n"
      @html_page_content <<
        "  <span style=\"margin-left: 1em; font-weight:bold; color: darkblue\">wget #{remote_url}<span><br><br>\n"
      unless description.to_s.empty? # <- Ignore empty descriptions.
        @html_page_content << "<pre>#{description}</pre>\n"
      end
      @html_page_content << "licence: #{licence}<br><br>\n"
      @html_page_content << "homepage: <a href=\"#{homepage}\">#{homepage}</a><br>\n"
      @html_page_content << "</p><br><hr>\n"
    }
    # ===================================================================== #
    # Next, store that HTML page somewhere.
    # ===================================================================== #
    what = @html_page_content
    into = "#{log_dir?}programs.html"
    opn; e "Storing these #{sfancy(array.size)} programs into the file:"
    opn; e "  #{sfile(into)}"
    write_what_into(what, into)
    @html_page_content = ''.dup # Clear it again here.
  else
    opn; e 'This method requires an Array as input.'
  end
end

# File lib/cookbooks/utility_scripts/create_new_cookbook.rb, line 487
def self.create_new_cookbook(i = 'test')
  CreateNewCookbook(i)
end

# File lib/cookbooks/module_methods/create_program_version_url_file.rb, line 27
def self.create_program_version_url_file(
    also_show_last_update = :default # Since Feb 2018, we will show the last update by default.
  )
  case also_show_last_update # case tag
  when :also_show_last_update,
       :include_last_update,
       :default
    also_show_last_update = true
  end
  newline = "\n".dup
  array_to_be_stored = []
  _ = DIRECTORY_EXPANDED_COOKBOOKS
  if File.directory?(_)
    all_cookbooks = Dir["#{_}*.yml"].sort
    all_cookbooks.each {|yaml_file|
      dataset = YAML.load_file(yaml_file)
      program_name    = File.basename(yaml_file.sub(/\.yml$/,''))
      program_version = dataset['program_version']
      program_url     = dataset['url1']
      array_to_be_stored << [
        program_name, program_version, program_url
      ]
      if also_show_last_update
        # ================================================================= #
        # In this case, append more information.
        # ================================================================= #
        last_update = dataset['last_update']
        array_to_be_stored[-1] << last_update 
      end
    }
    # ===================================================================== #
    # Now that we have populated array_to_be_stored, we must
    # use it to create a .txt file.
    # ===================================================================== #
    what = ''.dup
    array_to_be_stored.each {|entry|
      program_name, program_version, program_url = entry[0], entry[1], entry[2]
      if also_show_last_update
        last_update = entry[3] # It is the last element.
      end
      # =================================================================== #
      # Add what we need here - name of the program, the version and
      # the remote URL. This will be properly padded.
      # =================================================================== #
      what << program_name.to_s.ljust(28)+
              program_version.to_s.ljust(22)
      # =================================================================== #
      # Append when the last update happened, if we use that entry at
      # all.
      # =================================================================== #
      if also_show_last_update
        what << last_update.to_s.strip.ljust(14)
      end
      # =================================================================== #
      # Next, append the remote URL to the line.
      # =================================================================== #
      what << program_url.to_s.rstrip.ljust(44).rstrip+
              newline
    }
    into = "#{Cookbooks.log_dir?}CookbookDirectory/programs_version_url.txt"
    opn; e 'Now storing into `'+sfile(into)+'`.'
    write_what_into(what, into)
  else
    # all_programs = Cookbooks.available_programs?
    opn; e 'Currently, this functionalitye depends on the expanded '\
           'cookbook dataset.'
    opn; e 'Generate it anew via:'
    opn; e '  cookbooks --expand'
  end
end

# File lib/cookbooks/module_methods/create_programs_version_html_file.rb, line 21
def self.create_programs_version_html_file(
    use_this_file = Cookbooks.store_into_this_directory+'programs_version.txt'
  )
  updated_when = Cookbooks.return_date+' '+Cookbooks.return_time
  # ======================================================================= #
  # Generate a .html file.
  # ======================================================================= #
  dataset = '<html><title>Programs of Cookbooks Version: '+::Cookbooks.version?+
            ' Last updated: '+updated_when+
            '</title><body>
            Last update: <b>'+updated_when+'</b><br>
            <pre style="font-size:1.2em">'+
            File.read(use_this_file)+'</pre></body></html>'
  # ======================================================================= #
  # Store that file next:
  # ======================================================================= #
  use_this_file = ::Cookbooks.temp_directory?+'programs_version.html'
  opn; e 'Generating a new file at `'+sfile(use_this_file)+'`.'
  ::Cookbooks::SaveFile.write_what_into(
    dataset, use_this_file
  ) # Store it here.
end

# File lib/cookbooks/utility_scripts/registered_tags.rb, line 238
def self.create_registered_tags
  RegisteredTags.new
end

# File lib/cookbooks/colours/colours.rb, line 126
def self.crimson(i)
  return KONSOLE.crimson(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/colours/colours.rb, line 41
def self.disable_colours
  @use_colours = false
end

# File lib/cookbooks/module_methods/display_md5sum.rb, line 31
def self.disable_md5sum_calculation
  @display_md5sum = false
end

# File lib/cookbooks/module_methods/display_md5sum.rb, line 22
def self.display_md5sum?
  @display_md5sum
end

# File lib/cookbooks/constants/show_names.rb, line 26
def self.do_not_show_names
  @show_names = false
end

# File lib/cookbooks/misc/available_cookbooks.rb, line 248
def self.does_include_this_binary?(i)
  ::Cookbooks.all_binaries?.has_key?(i)
end

# File lib/cookbooks/module_methods/check_this_cookbook_file_for_errors.rb, line 25
def self.does_this_cookbook_file_have_any_erroneous_entry?(
    this_file = '/Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/cookbooks/lib/cookbooks/yaml/individual_cookbooks/jasper.yml'
  )
  if this_file.is_a? Array
    this_file = this_file.first
  end
  if this_file.nil?
    this_file = '/Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/cookbooks/lib/cookbooks/yaml/individual_cookbooks/jasper.yml'
  end
  if File.exist? this_file
    registered_cookbook_entries = Cookbooks.registered_cookbook_entries?
    dataset = YAML.load_file(this_file)
    key = dataset.keys.first
    available_entries_from_the_cookbooks_file = dataset[key].keys
    # ===================================================================== #
    # Next, obtain the entries that were not registered. Keep in mind
    # that this Array may be entry.
    # ===================================================================== #
    these_entries_were_not_registered = available_entries_from_the_cookbooks_file.reject {|entry|
      registered_cookbook_entries.include? entry
    }
    !these_entries_were_not_registered.empty?
  else
    false # You have to ensure that the file exists on your own.
  end
end

# File lib/cookbooks/utility_scripts/download_all_source_archives.rb, line 276
def self.download_all_source_archives(i = ARGV)
  ::Cookbooks::DownloadAllSourceArchives.new(i)
end

# File lib/cookbooks/module_methods/e.rb, line 9
def self.e(i = '')
  puts i
end

# File lib/cookbooks/module_methods/enable_module_programs.rb, line 32
def self.enable_module_programs
  available_programs?.each {|this_program|
    self.class.class_eval {
      _ = this_program.to_sym
      if respond_to? _
        # This here happens when we enable the methods.
        # This is just here as a placeholder, if we ever want
        # to debug this.
      else
        # ::Cookbooks.e 'Defining the method `'+_.to_s+'` next.' # <- This is more o a debug-statement.
        define_method(_) { # Simply delegate to class Cookbook then.
          ::Cookbooks::Cookbook.new(this_program)
        }
      end
    }
  }
end

# File lib/cookbooks/constants/encoding.rb, line 31
def self.encoding?
  USE_THIS_ENCODING
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 94
def self.ensure_that_the_required_directories_exist(
    use_this_as_directory = ::Cookbooks.store_into_this_directory?
  )
  unless Dir.exist? use_this_as_directory
    if File.writable?(File.dirname(use_this_as_directory))
      opn; e "Creating directory `#{use_this_as_directory}`."
      FileUtils.mkdir_p(use_this_as_directory)
    else
      e "Can not write into the directory #{use_this_as_directory}"\
        ". You should use another"
      e 'setting for temp_directory.yml perhaps.'
      e
      e 'This file can be found here:'
      e "  #{file_temp_directory}"
    end
  end
end

# File lib/cookbooks/utility_scripts/expand_cookbooks.rb, line 204
def self.expand_cookbooks(
    i = ARGV
  )
  ExpandCookbooks.new(i)
end

# File lib/cookbooks/module_methods/fast_return_file_size_of_this_program.rb, line 18
def self.fast_return_file_size_of_this_program(i)
  if i.is_a? Array
    i = i.join(' ').strip
  end
  if File.directory? DIRECTORY_EXPANDED_COOKBOOKS
    target_file = DIRECTORY_EXPANDED_COOKBOOKS+i+'.yml'
    if File.exist? target_file
      dataset = YAML.load_file(target_file)
      archive_size = dataset['archive_size']
      return archive_size
    else
      e 'No file exists at '+target_file
    end
  else
    e 'No directory exists at '+
      DIRECTORY_EXPANDED_COOKBOOKS
  end
end

# File lib/cookbooks/module_methods/favicon.rb, line 8
def self.favicon?
  '/Users/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/cookbooks/img/COOKBOOKS_LOGO.png'
end

# File lib/cookbooks/module_methods/feedback_description_of.rb, line 17
def self.feedback_description_of(i)
  i = i.first if i.is_a? Array
  _ = Cookbooks::Cookbook.new(i)
  _.feedback_description
end

# File lib/cookbooks/misc/available_cookbooks.rb, line 233
def self.feedback_help
  Cookbooks.available_programs?.each_with_index {|entry, index|
    index += 1
    e '('+simp(index.to_s.rjust(3))+') '+sfancy(entry)
  }
end

# File lib/cookbooks/module_methods/feedback_program_description.rb, line 16
def self.feedback_program_description(
    i
  )
  i = i.first if i.is_a? Array
  if i
    _ = Cookbooks::Cookbook.new
    _.find_this_program(i)
    e _.description?
  end
end

# File lib/cookbooks/display_cookbook_dataset/feedback/feedback_url.rb, line 54
def self.feedback_url(i = ARGV)
  ::Cookbooks::DisplayCookbookDataset::Feedback.feedback_url
end

# File lib/cookbooks/constants/file_cookbook_aliases.rb, line 18
def self.file_cookbook_aliases
  "#{Cookbooks.project_yaml_dir?}cookbook_aliases.yml"
end

# File lib/cookbooks/constants/constants.rb, line 102
def self.file_cookbook_chained_programs
  FILE_COOKBOOK_CHAINED_PROGRAMS
end

# File lib/cookbooks/constants/predefined_installation_instructions.rb, line 34
def self.file_predefined_installation_instructions
  FILE_PREDEFINED_INSTALLATION_INSTRUCTIONS
end

# File lib/cookbooks/constants/registered_cookbook_entries.rb, line 25
def self.file_registered_cookbook_entries
  FILE_REGISTERED_COOKBOOK_ENTRIES
end

# File lib/cookbooks/constants/constants.rb, line 122
def self.file_short_tutorial?
  FILE_SHORT_TUTORIAL
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 36
def self.file_temp_directory
  FILE_TEMP_DIRECTORY_YAML
end

# File lib/cookbooks/module_methods/is_included.rb, line 17
def self.find_cookbook_alias_for(i)
  Cookbooks::Aliases.new(i).value?
end

# File lib/cookbooks/utility_scripts/find_multiple_versions.rb, line 116
def self.find_multiple_versions
  Cookbooks::FindMultipleVersions.new
end

# File lib/cookbooks/module_methods/find_url_for.rb, line 19
def self.find_url_for(i = ARGV)
  i = i.first if i.is_a? Array
  i = i.to_s
  _ = ::Cookbooks::Cookbook.new(i) { :skip_menu_interface }
  _.url1?.to_s.strip # Return the URL here.
end

# File lib/cookbooks/utility_scripts/create_global_yaml_database.rb, line 133
def self.generate_global_yaml_database
  Cookbooks::CreateGlobalYamlDatabase.new
end

# File lib/cookbooks/module_methods/generate_programs_version_yaml_file.rb, line 37
def self.generate_programs_version_yaml_file(
    use_this_dataset = nil
  )
  _ = ''.dup # We will append onto this String.
  unless use_this_dataset # This is the default behaviour/clause.
    hash = {} # We store into this hash here.
    all_programs = ::Cookbooks.available_programs
    all_programs.each {|this_program|
      opn; e 'Now working on the program `'+simp(this_program)+'`.'
      cookbook = ::Cookbooks::Cookbook.new(this_program) { :bypass_menu }
      # =================================================================== #
      # Add onto the Hash next. Should keep it as a String.
      # =================================================================== #
      hash[this_program] = cookbook.version?.to_s
    }
    use_this_dataset = hash
  end
  use_this_dataset.each_pair {|key, value|
    value = '"'+value.to_s+'"' unless value.include? '"'
    _ << key.to_s+': '+value.to_s+N
  }
  # ======================================================================= #
  # Ok, now we should have all programs and the respective version
  # at hand - we can store it next. In the past, this made use of
  # YAML.dump() but for some strange reason, YAML.dump() gave strange
  # results; which is why I decided to generate the .yml file
  # on my own.
  # ======================================================================= #
  what = _
  into = ::Cookbooks.yaml_directory?+'programs_version.yml'
  opn; e 'Will store into `'+sfile(into)+'`.'
  ::Cookbooks::SaveFile.write_what_into(what, into) # Store into the file programs_version.yml
  # ======================================================================= #
  # Store for my home-system as well.
  # ======================================================================= #
  if is_roebe? # On my system.
    into = RUBY_SRC_DIR_AT_HOME+'cookbooks/lib/cookbooks/yaml/programs_version.yml'
    opn; e 'Will also store into `'+sfile(into)+'`.'
    ::Cookbooks::SaveFile.write_what_into(what, into)
  end
end

# File lib/cookbooks/module_methods/time.rb, line 32
def self.get_date
  current_day = Time.now.strftime('%d') # This will return a string such as "30".
  current_day+' '+Date::MONTHNAMES[Date.today.month][0,3]+' '+Time.now.strftime('%Y')
end

# File lib/cookbooks/gobolinux/gobolinux_naming_convention.rb, line 133
def self.gobolinux_naming_convention(i)
  i = i.first if i.is_a? Array
  GobolinuxNamingConvention.new(i).translated_name?
end

# File lib/cookbooks/utility_scripts/highest.rb, line 276
def self.highest(n = DISPLAY_N_PROGRAMS_BY_DEFAULT)
  Cookbooks::Highest.new(n)
end

# File lib/cookbooks/module_methods/home_dir.rb, line 8
def self.home_dir?
  (ENV['HOME'].to_s+'/').squeeze('/')
end

# File lib/cookbooks/module_methods/available_programs.rb, line 15
def self.include_this_program?(i)
  i.delete!('-') if i.include? '-' # Can not have '-' characters.
  Cookbooks.available_programs?.include?(i)
end

# File lib/cookbooks/directory/individual_cookbooks_directory.rb, line 32
def self.individual_cookbooks_directory?
  INDIVIDUAL_COOKBOOKS_DIRECTORY
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 242
def self.initialize_configuration(
    initialize_a_new_object_no_matter_what = false
  )
  if initialize_a_new_object_no_matter_what
    set_configuration_object(Cookbooks::SimpleConfigurationLoader.new)
    set_configuration_dependent_variables
  else
    unless @configuration_object # Initialize anew here.
      set_configuration_object(Cookbooks::SimpleConfigurationLoader.new)
      set_configuration_dependent_variables
    end
  end
end

# File lib/cookbooks/module_methods/is_included.rb, line 35
def self.is_an_alias?(i)
  _ = Cookbooks::Aliases.new(i)
  _.is_an_alias?
end

# File lib/cookbooks/module_methods/is_included.rb, line 62
def self.is_included?(
    i,
    honour_aliases = true
  )
  if i
    i = i.join(' ').strip if i.is_a? Array
    i.delete!(':') if i.include? ':' # We ignore ':' tokens.
    keys = Cookbooks.available_programs?
    case honour_aliases
    when :default # Restore the default state in this case.
      honour_aliases = true
    when :do_not_honour_aliases,
         :do_not_check_for_aliases,
         :do_not_use_aliases,
         :ignore_aliases,
         :user_disabled_this_setting_via_the_commandline
      honour_aliases = false
    end
    if honour_aliases
      aliases = Cookbooks::Aliases.new(i)
      all_aliases = aliases.dataset
      # =================================================================== #
      # Merge the keys together next, starting with the default programs.
      # ==================================================================== #
      keys << all_aliases.keys
    end
    keys.flatten!
    return keys.include?(i)
  else
    false
  end
end

# File lib/cookbooks/module_methods/is_on_roebe.rb, line 12
def self.is_on_roebe?
  ENV['IS_ROEBE'].to_s == '1'
end

# File lib/cookbooks/misc/available_cookbooks.rb, line 265
def self.is_registered?(i)
  Cookbooks.available_programs?.include?(i.to_s) # We require a String.
end

# File lib/cookbooks/module_methods/load_this_cookbook.rb, line 14
def self.load_this_cookbook(i)
  Cookbooks::Cookbook.new(i)
end

# File lib/cookbooks/requires/require_yaml.rb, line 41
def self.load_yaml(i)
  YAML.load_file(i)
end

# File lib/cookbooks/module_methods/all_binaries.rb, line 39
def self.location_registered_binaries
  LOCATION_REGISTERED_BINARIES
end

# File lib/cookbooks/module_methods/all_libraries.rb, line 39
def self.location_registered_libraries
  LOCATION_REGISTERED_LIBRARIES
end

# File lib/cookbooks/misc/available_cookbooks.rb, line 226
def self.n_programs?
  Cookbooks.available_programs.size
end

# File lib/cookbooks/module_methods/available_programs.rb, line 23
def self.n_programs_available?
  Cookbooks.available_programs?.size
end

# File lib/cookbooks/class/class.rb, line 661
def self.new(i = 'htop')
  ::Cookbooks::Cookbook.new(i) { :bypass_menu }
end

# File lib/cookbooks/module_methods/opn.rb, line 12
def self.opn
  Opn.opn(NAMESPACE) # The NAMESPACE constant is already a Hash.
end

# File lib/cookbooks/colours/colours.rb, line 118
def self.orange(i)
  return KONSOLE.orange(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/colours/colours.rb, line 149
def self.permanently_disable_colours
  into = FILE_USE_COLOURS
  what = YAML.dump(false)
  opn; e 'Permanently disabling the colours for the '\
         'Cookbooks project.'
  opn; e "(file: #{sfile(into)})"
  write_what_into(what, into)
  if is_on_roebe?
    into = "#{RUBY_SRC_DIR_AT_HOME}cookbooks/lib/cookbooks/yaml/configuration/"\
           "#{File.basename(FILE_USE_COLOURS)}"
    opn; e 'Permanently disabling the colours for the '\
           'Cookbooks project.'
    opn; e "(file: #{sfile(into)})"
    write_what_into(what, into)
  end
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 400
def self.permanently_set_path_to_this_source_directory(
    i
  )
  i = i.to_s unless i.is_a? String
  i = i.dup if i.frozen?
  unless i.end_with? '/'
    i << '/'
  end
  opn; e "Setting a new source directory to: #{sdir(i)}"
  ::Cookbooks.set_source_directory(i)
  # ======================================================================= #
  # Next, we have to save this value as well, for it to make it
  # permanent.
  # ======================================================================= #
  write_what_into(i, FILE_SOURCE_DIRECTORY) # Must save it here.
end

# File lib/cookbooks/module_methods/permanently_set_source_directory.rb, line 23
def self.permanently_set_source_directory(i)
  i << '/' unless i.end_with? '/'
  # ======================================================================= #
  # Modify the yaml file next:
  # ======================================================================= #
  what = i
  into = FILE_SOURCE_DIRECTORY_YAML
  ::Cookbooks::SaveFile.write_what_into(what, into)
  opn; e 'Setting the new source directory to point towards '+sdir(what)+'.'
  opn; e 'Storing into the file `'+sfile(into)+'` next.'
  # ======================================================================= #
  # And also modify it on my home system, if IS_ROEBE is true. This will
  # go right into the configuration/ subirectory.
  # ======================================================================= #
  if is_on_roebe?
    into = RUBY_SRC_DIR_AT_HOME+'cookbooks/lib/cookbooks/yaml/configuration/'+
           File.basename(into)
    opn; e 'Will also store into the file `'+sfile(into)+'`.'
    ::Cookbooks::SaveFile.write_what_into(what, into)
  end
  Cookbooks.set_source_directory(i) # And also sync it back.
end

# File lib/cookbooks/module_methods/permanently_set_temp_directory.rb, line 14
def self.permanently_set_temp_directory(i)
  i << '/' unless i.end_with? '/'
  # ======================================================================= #
  # Modify the yaml file next:
  # ======================================================================= #
  what = i
  into = FILE_TEMP_DIRECTORY_YAML
  Cookbooks::SaveFile.write_what_into(what, into)
  # ======================================================================= #
  # And also modify it on my home system, if IS_ROEBE is true.
  # ======================================================================= #
  if is_on_roebe?
    into = RUBY_SRC_DIR_AT_HOME+'cookbooks/lib/cookbooks/yaml/configuration/'+
           File.basename(into)
    Cookbooks::SaveFile.write_what_into(what, into)
  end
  Cookbooks.set_temp_directory(i) # And also sync it.
end

# File lib/cookbooks/constants/predefined_installation_instructions.rb, line 58
def self.pii?
  PII
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 306
def self.programs_directory?
  @programs_directory
end

# File lib/cookbooks/project_settings/project_base_directory.rb, line 17
def self.project_base_directory?
  PROJECT_BASE_DIRECTORY
end

# File lib/cookbooks/project_settings/project_yaml_directory.rb, line 27
def self.project_yaml_directory?
  PROJECT_YAML_DIRECTORY
end

# File lib/cookbooks/module_methods/ftp.rb, line 26
def self.publish_list_of_all_programs_version(
    file_programs_version = FILE_PROGRAMS_VERSION # This is the file 'programs_version.yml'

  )
  _ = ''.dup
  opn; e 'The file '+sfile(file_programs_version)+' will next '\
          'be FTP-uploaded/published.'
  hash = YAML.load_file(file_programs_version)
  hash.each_pair {|name_of_the_program, program_version|
    _ << name_of_the_program.ljust(28)+program_version.to_s+N
  }
  what = _
  into = Cookbooks.store_into_this_directory+'programs_version.txt'
  opn; e 'Storing into `'+sfile(into)+'`.'
  ::Cookbooks::SaveFile.write_what_into(what, into)
  ::Cookbooks.upload_list_of_all_programs_version(into)
  # ========================================================================= #
  # Also upload a .html variant.
  # ========================================================================= #
  ::Cookbooks.upload_list_of_all_programs_version(into, :html)
end

# File lib/cookbooks/utility_scripts/registered_binaries.rb, line 181
def self.registered_binaries?
  ALL_BINARIES.keys.uniq.sort
end

# File lib/cookbooks/constants/registered_cookbook_entries.rb, line 55
def self.registered_cookbook_entries?
  REGISTERED_COOKBOOK_ENTRIES
end

# File lib/cookbooks/module_methods/remove_archive_from_the_end.rb, line 12
def self.remove_archive_from_the_end(i)
  i = i.dup if i.frozen?
  if i.end_with? '.tar.gz'
    i.sub!(/\.tar\.gz$/,'')
  elsif i.end_with? '.tar.xz'
    i.sub!(/\.tar\.xz$/,'')
  elsif i.end_with? '.tar.bz2'
    i.sub!(/\.tar\.bz2$/,'')
  elsif i.end_with? '.jar'
    i.sub!(/\.jar$/,'')
  elsif i.end_with? '.phar'
    i.sub!(/\.phar$/,'')
  end
  return i
end

# File lib/cookbooks/module_methods/remove_file_suffix.rb, line 9
def self.remove_file_suffix(i)
  _ = i.dup
  if _.include? '.'
    _.sub!(/\.[a-z]{1,5}$/,'')
    if _.end_with? '.tar'
      _.sub!(/\.tar}$/,'')
    end
  end
  return _
end

# File lib/cookbooks/module_methods/report_extended_information_about_this_program.rb, line 47
def self.report_extended_information_about_this_program(
    i
  )
  i = i.first if i.is_a? Array
  if i
    _ = Cookbooks::Cookbook.new
    _.find_this_program(i)
    _.report
    check_and_report_whether_file_exists(_.full_path?, _)
  end
end

# File lib/cookbooks/module_methods/report_how_many_binaries_are_registered.rb, line 17
def self.report_how_many_binaries_are_registered
  n_binaries = ALL_BINARIES.keys.uniq.size
  opn; e 'There are '+sfancy(n_binaries.to_s)+' registered binaries in '\
         'all cookbook files.'
end

# File lib/cookbooks/module_methods/available_programs.rb, line 33
def self.report_n_programs_available
  _ = Cookbooks.n_programs_available?
  e sfancy(_)+' programs are registered in our cookbooks at '+
    simp(return_date)+'.'
end

# File lib/cookbooks/utility_scripts/report_the_registered_programs.rb, line 98
def self.report_the_registered_programs(i = ARGV)
  Cookbooks::ReportTheRegisteredPrograms.new(i)
end

# File lib/cookbooks/module_methods/report_total_size_of_all_archives.rb, line 22
def self.report_total_size_of_all_archives
  total_size = 0
  available_programs = available_programs?
  available_programs.each {|this_program|
    possible_target = "#{DIRECTORY_EXPANDED_COOKBOOKS}#{this_program}.yml"
    if File.exist? possible_target
      dataset = YAML.load_file(possible_target)
      program_path = dataset['program_path']
    else
      # =================================================================== #
      # The expanded-cookbooks file does not exist, so use
      # Cookbooks::Cookbook instead.
      # =================================================================== #
      unless Cookbooks.const_defined? :Cookbook
        require 'cookbooks/class/class.rb'
      end
      program_path = Cookbooks::Cookbook.new(this_program).program_path?
    end
    if File.exist? program_path
      total_size += File.size(program_path)
    end
  }
  n_kilobytes = total_size  / 1024.0
  n_megabytes = n_kilobytes / 1024.0
  n_gigabytes = n_megabytes / 1024.0
  # ======================================================================= #
  # Finally, report it here.
  # ======================================================================= #
  e 'The total file size of all '+sfancy(available_programs.size.to_s)+
    ' programs is '+total_size.to_s+' bytes '
  e "(#{n_kilobytes.round(2)} KB; "+
    n_megabytes.round(2).to_s+' MB; '+
    crimson(n_gigabytes.round(2).to_s+' GB')+')'
end

# File lib/cookbooks/requires/require_utility_scripts.rb, line 13
def self.require_utility_scripts
  Dir[Cookbooks.utility_directory+'*.rb'].uniq.each {|file|
    require 'cookbooks/utility_scripts/'+File.basename(file)
  }
end

# File lib/cookbooks/requires/require_validation_scripts.rb, line 15
def self.require_validation_scripts
  Dir[Cookbooks.validation_directory+'*.rb'].uniq.each {|file|
    require 'cookbooks/validation/'+File.basename(file)
  }
end

# File lib/cookbooks/aliases/aliases.rb, line 299
def self.return_alias_program_name_for(i)
  Cookbooks::Aliases.new(i).translate_alias
end

# File lib/cookbooks/utility_scripts/blfs.rb, line 207
def self.return_all_blfs_entries
  cmd = 'grep -r "^ blfs" '+Cookbooks.individual_cookbooks_directory?
  result = `#{cmd}`.split(N).map {|entry|
    entry.gsub!(/ blfs: /,' ')
    if entry.include? ':'
      splitted = entry.split ':'
      splitted[0] = File.basename(splitted[0]).gsub(/\.yml/,'')
      entry = splitted.join ':'
    end
    entry.split(': ')
  }
  return result
end

# File lib/cookbooks/module_methods/return_archive_type.rb, line 17
def self.return_archive_type(i = '.tar.xz')
  if i.end_with? '.tar.xz'
    '.tar.xz'
  elsif i.end_with? '.xz'
    '.tar.xz'
  elsif i.end_with? '.tar.gz'
    '.tar.gz'
  elsif i.end_with? '.tar.bz2'
    '.tar.bz2'
  elsif i.end_with? '.tar.lz'
    '.tar.lz'
  elsif i.end_with? '.gem'
    '.gem'
  elsif i.end_with? '.zip'
    '.zip'
  elsif i.end_with? '.jar'
    '.jar'
  elsif i.end_with? '.phar'
    '.phar'
  else
    i
  end
end

# File lib/cookbooks/module_methods/return_array_of_programs_without_a_blfs_entry.rb, line 21
def self.return_array_of_programs_without_a_blfs_entry
  array_of_programs_without_a_blfs_entry = []
  # ======================================================================= #
  # First, obtain all available programs.
  # ======================================================================= #
  all_available_programs = ::Cookbooks.available_programs?
  all_available_programs.each {|this_program|
    location = Cookbooks.individual_cookbooks_directory?+this_program+'.yml'
    dataset = File.read(location)
    unless dataset.include? ' blfs: http'
      array_of_programs_without_a_blfs_entry << this_program
    end
  }
  return array_of_programs_without_a_blfs_entry
end

# File lib/cookbooks/utility_scripts/search_for_tags/search_for_tags.rb, line 529
def self.return_array_of_this_tag(i)
  SearchForTags.new(i) { :be_quiet }.array_of_programs.sort
end

# File lib/cookbooks/utility_scripts/blfs.rb, line 241
def self.return_blfs_page_of_this_program(i)
  _ = Cookbooks::Blfs.new(i) { :be_quiet_and_do_not_tamper_with_the_xorg_buffer }
  result = _.remote_url?
  result = result.first if result.is_a? Array
  return result
end

# File lib/cookbooks/misc/show_configuration_options.rb, line 375
def self.return_configuration_options_for?(this_program)
  ::Cookbooks::Cookbook.new(this_program).configuration_options?
end

# File lib/cookbooks/module_methods/time.rb, line 22
def self.return_date
  Time.now.strftime('%d.%m.%Y')
end

# File lib/cookbooks/module_methods/return_location_of_this_yaml_file.rb, line 18
def self.return_location_of_this_yaml_file(i)
  i = i.to_s unless i.is_a? String
  unless i.end_with? '.yml'
    i = i.dup if i.frozen?
    i << '.yml'
  end
  if is_on_roebe?
    # ===================================================================== #
    # Hardcoded on my own system.
    # ===================================================================== #
    _ = RUBY_SRC_DIR_AT_HOME+'cookbooks/lib/cookbooks/yaml/individual_cookbooks/'
    _+i
  else
    Cookbooks.individual_cookbooks_directory?+i
  end
end

# File lib/cookbooks/module_methods/time.rb, line 12
def self.return_time
  Time.now.strftime('%H:%M:%S')
end

# File lib/cookbooks/module_methods/return_version_of_this_program.rb, line 15
def self.return_version_of_this_program(i = 'htop')
  if i.is_a? Array
    i = i.first
  end
  i = i.to_s # We have to work on Strings.
  if ::Cookbooks::Cookbook.does_include? i
    dataset = ::Cookbooks::Cookbook.new(i) { :bypass_menu }
    return dataset.program_version?
  else
    nil
  end
end

# File lib/cookbooks/colours/colours.rb, line 72
def self.sdir(i)
  return ::Colours.sdir(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/utility_scripts/search_for_tags/search_for_tags.rb, line 515
def self.search_for_tags(i)
  SearchForTags.new(i)
end

# File lib/cookbooks/module_methods/commandline_options.rb, line 22
def self.set_commandline_options(i)
  @commandline_options = i
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 172
def self.set_configuration_dependent_variables(
    i = @configuration_object
  )
  if i.respond_to? :source_directory
    ::Cookbooks.set_source_directory(i.source_directory)
  else
    # ===================================================================== #
    # else simply hardcode it. This allows us to not have to
    # depend on any .yml file.
    # ===================================================================== #
    i = '/Users/x/SRC/'
    ::Cookbooks.set_source_directory(i)
  end
  if i.respond_to? :temp_directory
    ::Cookbooks.set_temp_directory(i.temp_directory)
  else
    # ===================================================================== #
    # else simply hardcode it. This allows us to not have to
    # depend on any .yml file.
    # ===================================================================== #
    i = '/tmp/'
    ::Cookbooks.set_temp_directory(i)
  end
  if i.respond_to? :system_directory
    ::Cookbooks.set_system_directory(i.system_directory)
  else
    # ===================================================================== #
    # else simply hardcode it. This allows us to not have to
    # depend on any .yml file.
    # ===================================================================== #
    i = '/System/'
    ::Cookbooks.set_system_directory(i)
  end
  if i.respond_to? :programs_directory
    ::Cookbooks.set_programs_directory(i.programs_directory)
  else
    # ===================================================================== #
    # else simply hardcode it. This allows us to not have to
    # depend on any .yml file.
    # ===================================================================== #
    i = '/Programs/'
    ::Cookbooks.set_programs_directory(i)
  end
  if i.respond_to? :store_into_this_directory
    ::Cookbooks.set_store_into_this_directory(i.store_into_this_directory)
  else
    # ===================================================================== #
    # else simply hardcode it. This allows us to not have to
    # depend on any .yml file.
    # ===================================================================== #
    i = '/Depot/Cookbooks/'
    ::Cookbooks.set_store_into_this_directory(i)
  end
  # ======================================================================= #
  # Define the instance variable @use_yaml_database_for_tags next, so
  # that we can, in some queries, use grep or a pure ruby solution to
  # find patterns in text.
  # ======================================================================= #
  @use_yaml_database_for_tags = i.use_yaml_database_for_tags
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 48
def self.set_configuration_object(
    i = Cookbooks::SimpleConfigurationLoader.new
  )
  @configuration_object = i
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 130
def self.set_programs_directory(i = '/Programs/')
  i = i.dup if i.frozen?
  i = convert_global_env(i) if i.include? '$'
  # ======================================================================= #
  # If there are still '$' entries then this variable does not
  # exist. In this case, use a hardcoded entry.
  # ======================================================================= #
  i = '/Programs/' if i.include? '$'
  i << '/' unless i.end_with? '/'
  @programs_directory = i
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 72
def self.set_source_directory(i)
  i = i.dup if i.frozen?
  i = convert_global_env(i) if i.include? '$'
  i << '/' unless i.end_with? '/'
  @source_directory = i
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 119
def self.set_store_into_this_directory(i)
  i = i.dup if i.frozen?
  i = convert_global_env(i) if i.include? '$'
  i << '/' unless i.end_with? '/'
  @store_into_this_directory = i
  ensure_that_the_required_directories_exist(i)
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 152
def self.set_system_directory(
    i = '/System/'
  )
  i = i.dup if i.frozen?
  i = convert_global_env(i) if i.include? '$'
  i << '/' unless i.end_with? '/'
  @system_directory = i
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 82
def self.set_temp_directory(i)
  i = i.dup if i.frozen?
  i = convert_global_env(i) if i.include? '$'
  i << '/' unless i.end_with? '/'
  @temp_directory = i
end

# File lib/cookbooks/colours/colours.rb, line 64
def self.sfancy(i)
  return ::Colours.sfancy(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/colours/colours.rb, line 56
def self.sfile(i)
  return ::Colours.sfile(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/module_methods/show_available_tags.rb, line 21
def self.show_available_tags(
    use_this_path  = FILE_ALLOWED_TAGS,
    show_namespace = true
  )
  case use_this_path
  when :default
    use_this_path = FILE_ALLOWED_TAGS
  end
  case show_namespace
  when :do_not_report_the_namespace, :be_quiet
    show_namespace = false
  end
  opn if show_namespace
  e 'The following tags are registered (and thus available - '\
    'sorted alphabetically):'
  array = YAML.load_file(use_this_path)
  array.each {|entry|
    e "  #{simp(entry)}"
  }
end

# File lib/cookbooks/module_methods/show_available_utility_scripts.rb, line 21
def self.show_available_utility_scripts
  files = Dir[utility_scripts?+'*.rb'].sort.map {|file|
    File.basename(file)
  }
  files = files - ['utility_scripts.rb']
  e; files.each_with_index {|file, index|
    index += 1
    e sfancy(index.to_s.rjust(4))+') '+simp(file)
  }; e
end

# File lib/cookbooks/module_methods/show_last_configure_option.rb, line 12
def self.show_last_configure_option
  _ = STORE_THE_LAST_CONFIGURATION_OPTIONS_IN_THIS_FILE
  if File.exist? _
    e File.read(_)
  else
    e 'No configure options have been stored yet (File checked: '+_+').'
  end
end

# File lib/cookbooks/constants/show_names.rb, line 19
def self.show_names?
  @show_names
end

# File lib/cookbooks/module_methods/show_overview_over_available_utility_scripts.rb, line 26
def self.show_overview_over_available_utility_scripts
  target = "#{utility_scripts?}*.rb"
  available_files = Dir[target]
  if Object.const_defined? :ClassDocuShower
    available_files.each {|file|
      cliner
      ClassDocuShower[file] # Delegate towards ClassDocuShower here.
    }
  else
    opn; e 'The class ClassDocuShower is not available.'
    e
    opn; e 'It can be installed via:'
    e
    opn; e '  gem install class_docu_shower'
    e
  end
end

# File lib/cookbooks/utility_scripts/registered_binaries.rb, line 188
def self.show_registered_binaries
  _ = Cookbooks.registered_binaries?
  RegisteredBinaries.opnn; e 'These '+_.size.to_s+' binaries are registered:'
  e _.reject {|entry| entry.to_s.empty? }.join(', ').strip.chop
end

# File lib/cookbooks/class/tutorial.rb, line 18
def self.show_tutorial(
    try_to_use_colours = true
  )
  require 'io/console'
  display_this_message = "\n[Press any key to continue; q to exit early]"
  # ========================================================================= #
  # The file for the short tutorial can be seen in
  # "tutorial/short_tutorial.md".
  # ========================================================================= #
  _ = Cookbooks.file_short_tutorial?
  if File.exist? _
    dataset = File.readlines(_) # Display the file next.
    chunks = dataset.each_slice(20).to_a
    counter = 0
    e # And a newline to start with.
    loop {
      content_that_will_be_displayed = chunks[counter]
      if try_to_use_colours
        content_that_will_be_displayed.map! {|line|
          # ================================================================= #
          # Next colourize anything that is indented with 4 leading spaces.
          # ================================================================= #
          line.gsub(/^(    .+)$/, lightgreen('\1'))
        }
      end
      e content_that_will_be_displayed
      # ===================================================================== #
      # Next, display the "press any key to continue" message.
      # ===================================================================== #
      if try_to_use_colours
        display_this_message = mediumseagreen(display_this_message)
      end
      e display_this_message
      case STDIN.getch
      when 'q'
        exit
      else
        counter += 1
        exit if counter >= chunks.size
      end
    }
  end
end

# File lib/cookbooks/colours/colours.rb, line 48
def self.simp(i)
  return ::Colours.simp(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 270
def self.source_directory?
  @source_directory
end

# File lib/cookbooks/module_methods/initialize_configuration.rb, line 319
def self.store_into_this_directory?
  @store_into_this_directory
end

# File lib/cookbooks/colours/colours.rb, line 80
def self.swarn(i)
  return ::Colours.swarn(i) if Cookbooks.use_colours?
  i
end

# File lib/cookbooks/module_methods/swift_return_version_of_this_program.rb, line 37
def self.swift_return_version_of_this_program(
    this_program = :htop
  )
  this_program = this_program.to_s
  # ======================================================================= #
  # Next, try to pass it against a list of aliases, if it has not
  # been yet "findable".
  # ======================================================================= #
  if !Cookbooks.does_include?(this_program, :ignore_aliases)
    possible_alternative_name = Cookbooks.find_cookbook_alias_for(this_program)
    if possible_alternative_name
      if possible_alternative_name != this_program
        this_program = possible_alternative_name
      end
    end
  end
  _ = FILE_PROGRAMS_VERSION
  if File.exist? _
    dataset = YAML.load_file(_)
    if dataset.has_key? this_program
      program_version = dataset.fetch(this_program)
      return program_version
    end
  else
    e "No file called `#{sfile(_)}` exists."
    raise FileDoesNotExist, _.to_s+' does not exist.'
  end
  return nil # Default return value here.
end