rbt 0.10.215 → 0.11.90

data/lib/rbt/cookbooks/sanitize_cookbook/obtain_query_and_return.rb

@@ -1,1673 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === RBT::Cookbooks::SanitizeCookbook
-# =========================================================================== #
-# require 'rbt/cookbooks/sanitize_cookbook/obtain_query_and_return.rb'
-# =========================================================================== #
-require 'rbt/base/prototype.rb'
-
-module RBT
-
-module Cookbooks
-
-class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
-
-  # ========================================================================= #
-  # === internal_hash?
-  # ========================================================================= #
-  def internal_hash?
-    @internal_hash
-  end; alias ihash? internal_hash? # === ihash?
-       alias ihash  internal_hash? # === ihash
-       alias internal_hash internal_hash? # === internal_hash
-
-  # ========================================================================= #
-  # === dataset_of_the_program?
-  #
-  # Note that specifically the method hash? should return the FULL,
-  # sanitized dataset, because other programs may rely on that
-  # dataset, and because this information may then easily be
-  # dumped into a local .yml file as well.
-  # ========================================================================= #
-  def dataset_of_the_program?
-    @internal_hash[:dataset]
-  end; alias dataset?          dataset_of_the_program? # === dataset?
-       alias dataset           dataset_of_the_program? # === dataset
-       alias internal_dataset? dataset_of_the_program? # === internal_dataset?
-       alias hash?             dataset_of_the_program? # === hash?
-       alias return_hash       dataset_of_the_program? # === return_hash
-       alias main_dataset?     dataset_of_the_program? # === main_dataset?
-       alias yaml_dataset?     dataset_of_the_program? # === yaml_dataset?
-       alias return_dataset    dataset_of_the_program? # === return_dataset
-       alias cookbook_dataset? dataset_of_the_program? # === cookbook_dataset?
-       alias cookbook?         dataset_of_the_program? # === cookbook?
-       alias return_dataset    dataset_of_the_program? # === return_dataset
-
-  # ========================================================================= #
-  # === complex_mode?
-  # ========================================================================= #
-  def complex_mode?
-    @internal_hash[:simple_or_complex] == :complex
-  end
-
-  # ========================================================================= #
-  # === in_simple_mode?
-  # ========================================================================= #
-  def in_simple_mode?
-    @internal_hash[:simple_or_complex] == :simple
-  end
-
-  # ========================================================================= #
-  # === extract_to?
-  #
-  # This must return a String.
-  # ========================================================================= #
-  def extract_to?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias will_be_extracted_towards? extract_to? # === will_be_extracted_towards?
-       # alias extracted_towards?       extract_to? # === extracted_towards?
-
-  # ========================================================================= #
-  # === return_default_program_full_name
-  #
-  # program_full_name (entry 6) is something like:
-  #
-  #   'gnome-mahjonng-5.08.tar.xz'
-  #
-  # so this is program_name_and_program_version?+archive_type?
-  # ========================================================================= #
-  def return_default_program_full_name(
-      i = program_name_and_program_version?.to_s+
-          archive_type?.to_s
-    )
-    return i
-  end; alias return_program_full_name return_default_program_full_name # === return_program_full_name
-
-  # ========================================================================= #
-  # === found?
-  #
-  # Query method to determine whether the search term (the program
-  # we are seeking) is included or whether it is not.
-  #
-  # Returns a boolean.
-  # ========================================================================= #
-  def found?
-    @internal_hash[:found]
-  end; alias program_is_included? found? # === program_is_included?
-       alias found_result?        found? # === found_result?
-       alias program_was_found?   found? # === program_was_found?
-
-  # ========================================================================= #
-  # === return_middle_part_of_the_program_version
-  # ========================================================================= #
-  def return_middle_part_of_the_program_version(
-      program_version = program_version?
-    )
-    result = program_version.dup
-    if result.include? '.'
-      result = result.split('.')[1]
-    end
-    return result
-  end
-
-  # ========================================================================= #
-  # === has_a_dependency_on_meson?
-  #
-  # This method will return a boolean value, indicating whether the
-  # given program at hand has a dependency on the build system called
-  # meson or whether it has not.
-  # ========================================================================= #
-  def has_a_dependency_on_meson?
-    required_deps_on? and required_deps_on?.include?('meson')
-  end
-
-  # ========================================================================= #
-  # === skip_configure?
-  #
-  # Query-method over as to whether we will skip configure or whether
-  # we will not.
-  # ========================================================================= #
-  def skip_configure?
-    !run_configure?
-  end; alias skip_configure skip_configure? # === skip_configure
-
-  # ========================================================================= #
-  # === wrap_result?
-  # ========================================================================= #
-  def wrap_result?
-    @internal_hash[:wrap_result]
-  end; alias use_word_wrap? wrap_result? # === use_word_wrap?
-
-  # ========================================================================= #
-  # === main_seven?
-  #
-  # This method will return the main 7 entries that are the most important
-  # ones for any given program at hand.
-  # ========================================================================= #
-  def main_seven?(
-      use_padded_output = true
-    )
-    _ = ''.dup
-    one   = 'short_name: '.dup
-    two   = 'program_version: '.dup
-    three = 'archive_type: '.dup
-    four  = 'base_dir: '.dup
-    five  = 'program_name: '.dup
-    six   = 'program_full_name: '.dup
-    seven = 'program_path: '.dup
-    # ======================================================================= #
-    # Next make sure to pad the output, if the user requested this.
-    # ======================================================================= #
-    if use_padded_output
-      n_ljust = 19
-      one   = one.ljust(n_ljust)
-      two   = two.ljust(n_ljust)
-      three = three.ljust(n_ljust)
-      four  = four.ljust(n_ljust)
-      five  = five.ljust(n_ljust)
-      six   = six.ljust(n_ljust)
-      seven = seven.ljust(n_ljust)
-    end
-    _ << "#{one}#{short_name?}#{N}"
-    _ << "#{two}#{program_version?}#{N}"
-    _ << "#{three}#{archive_type?}#{N}"
-    _ << "#{four}#{base_dir?}#{N}"
-    _ << "#{five}#{program_name?}#{N}"
-    _ << "#{six}#{program_full_name?}#{N}"
-    _ << "#{seven}#{program_path?}#{N}"
-    return _
-  end; alias all_seven        main_seven? # === all_seven
-       alias return_the_seven main_seven? # === return_the_seven
-
-  # ========================================================================= #
-  # === meson_or_configure_options?
-  #
-  # This method will either return the meson-configure options or the
-  # GNU configure options. The checks are in order, so first we will
-  # check for meson, and then default to configure if meson is NOT
-  # used.
-  # ========================================================================= #
-  def meson_or_configure_options?
-    if is_the_build_system_meson?
-      meson_configure_options?
-    else
-      configure_options?
-    end
-  end; alias configure_options_or_meson_options? meson_or_configure_options? # === configure_options_or_meson_options?
-
-  # ========================================================================= #
-  # === meson_or_cmake_or_configure_options?
-  #
-  # This is similar to the method called .meson_or_configure_options?()
-  # but we will also check whether cmake is in use.
-  # ========================================================================= #
-  def meson_or_cmake_or_configure_options?
-    if is_the_build_system_meson?
-      meson_configure_options?
-    elsif is_the_build_system_cmake?
-      cmake_configure_options?
-    else
-      configure_options?
-    end
-  end
-
-  # ========================================================================= #
-  # === return_first_underscore_as_hyphen_from_this_url
-  # ========================================================================= #
-  def return_first_underscore_as_hyphen_from_this_url(
-      i = url1?
-    )
-    new_url = File.basename(i).dup # Obtain the URL here.
-    new_url.sub!(/_/,'-') # This replaces only the first '_' found.
-    new_url = remove_archive_from_the_end(new_url)
-    return new_url
-  end
-
-  # ========================================================================= #
-  # === return_default_program_path
-  #
-  # This is entry number (8), program_path, which will look like:
-  #
-  #   '/home/x/src/gnomemahjongg/gnome-mahjonng-5.08.tar.xz' # base_dir?+program_full_name?
-  #   '/home/x/src/gnomemahjongg/' + 'gnome-mahjonng-5.08.tar.xz'
-  #
-  # ========================================================================= #
-  def return_default_program_path
-    base_dir?+
-    program_full_name?
-  end; alias return_program_path return_default_program_path # === return_program_path
-
-  # ========================================================================= #
-  # === return_sanitized_program_name_and_program_version
-  #
-  # This method will also get rid of archives.
-  #
-  # A full program_name_and_program_version would be something
-  # like:
-  #
-  #    'gnome-mahjonng-5.08'
-  #
-  #     (2) program_name                      like 'gnome-mahjongg'
-  #
-  # ========================================================================= #
-  def return_sanitized_program_name_and_program_version(
-      i   = program_name_and_program_version?.dup,
-      url = url1?.dup
-    )
-    case i # case tag
-    # ======================================================================= #
-    # === USE_URL_DOWNCASE
-    #
-    # Use the URL as program name but downcase it.
-    # ======================================================================= #
-    when 'USE_URL_DOWNCASE',
-         'USE_DOWNCASED'
-      i = File.basename(url.downcase)
-    # ======================================================================= #
-    # === FIRST_UNDERSCORE_AS_HYPHEN
-    #
-    # This will convert input such as 'boost_1_61_0' into 'boost-1_61_0'.
-    # ======================================================================= #
-    when 'FIRST_UNDERSCORE_AS_HYPHEN',
-         'FIRST_UNDERSCORE_IS_HYPHEN',
-         'USE_URL_REPLACE_UNDERSCORE'
-      i = return_first_underscore_as_hyphen_from_this_url(url)
-    # ======================================================================= #
-    # === PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET
-    #
-    # This entry point has been specifically added for the program "brotli",
-    # but also other programs that would fall into that scheme.
-    #
-    # Brotli has an URL like this:
-    #
-    #   https://github.com/google/brotli/archive/v1.0.7/brotli-v1.0.7.tar.gz
-    #
-    # The annoying part is the very last 'v'. If you extract this archive
-    # then the resulting directory name is "brotli-1.0.7", so the folks
-    # who packaged this archive evidently are very clueless. But even
-    # aside from this, the issue is that the RBT project may have to guess
-    # and infer the correct program version, which should not include the
-    # 'v' character anyway. The following when-entry ensures precisely
-    # this: all alphabet-characters will be dropped from the program
-    # version.
-    #
-    # This entry point has been added on 30.11.2019.
-    #
-    # Note that PROGRAM_VERSION is not exactly the same, since it will
-    # ONLY modify the program version; it will NOT change the name of
-    # the program at hand.
-    #
-    # Keep in mind that the input may be incomplete, such as in the
-    # String "ninja-PROGRAM_VERSION".
-    # ======================================================================= #
-    when /^PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET$/,
-         /^PROGRAM_VERSION$/,
-         /-PROGRAM_VERSION$/
-      program_version = program_version?
-      if program_version.nil? or program_version.empty?
-        _ = remove_archive_from_the_end(File.basename(url1?.dup))
-        _.delete!('a-z')
-        _[0,1] = '' if _.start_with? '-'
-        program_version = _
-      end
-      if    i.include? 'PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET'
-        use_this_as_program_short_name = program_short_name?
-        if use_this_as_program_short_name.nil? or
-           use_this_as_program_short_name.empty?
-          use_this_as_program_short_name = ProgramInformation.return_short_name(
-            remove_archive_from_the_end(
-              File.basename(url1?.dup)
-            )
-          )
-        end
-        i.sub!(/PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET/,
-          use_this_as_program_short_name+'-'+program_version)
-      elsif i.include? 'PROGRAM_VERSION'
-        i.sub!(/PROGRAM_VERSION/, program_version)
-      end
-      i.squeeze!('.')
-    # ======================================================================= #
-    # === USE_URL_LAST_HYPHEN_IS_DOT
-    #
-    # This entry point will convert the last hyphen, aka '-', into a '.'
-    # dot. The input may be 'ImageMagick-7.0.8-27' and it will then
-    # become 'ImageMagick-7.0.8.27'.
-    # ======================================================================= #
-    when /^USE_URL_LAST_HYPHEN_IS_DOT$/
-      _ = File.basename(url1?)
-      i = remove_archive_from_the_end(_)
-      i = i.reverse.sub(/-/,'.').reverse
-    # ======================================================================= #
-    # === FIRST_UNDERSCORE_AS_HYPHEN_AND_OTHER_UNDERSCORES_AS_DOTS
-    #
-    # This is due to boost again - apparnetly the boost developers make
-    # use of a very strange packaging schemata.
-    #
-    # So this entry point will convert input such as 'boost_1_61_0' into
-    # 'boost-1.61.0'.
-    # ======================================================================= #
-    when 'FIRST_UNDERSCORE_AS_HYPHEN_AND_OTHER_UNDERSCORES_AS_DOTS'
-      i = return_first_underscore_as_hyphen_and_other_undscores_as_dots(url)
-    # ======================================================================= #
-    # === FIRST_DOT_AS_HYPHEN
-    #
-    # The following case is for input such as "sendmail.5.2.18"
-    # which should become "sendmail-5.2.18".
-    #
-    # We only manipulate the last part though, so if we have input that
-    # contains a '/', we assume that this is a path and split it up.
-    # This is the reason why we will use File.basename()
-    # ======================================================================= #
-    when 'FIRST_DOT_AS_HYPHEN'
-      i = return_first_dot_as_hyphen_from_this_url(url)
-    # ======================================================================= #
-    # === URL_REPLACE_UNDERSCORE
-    #
-    # This entry point handles the case when the input has '_' characters
-    # in the String. If this is the case then all '_' will be replaced
-    # via '-' characters.
-    # ======================================================================= #
-    when 'URL_REPLACE_UNDERSCORE',
-         'URL_CONVERT_UNDERSCORE',
-         'USE_URL_SANITIZED',
-         'REPLACE_UNDERSCORES',
-         'USE_URL_MIDDLE_HYPHENS'
-      i = return_url_replace_underscore(url)
-    # ======================================================================= #
-    # === USE_URL
-    #
-    # Simply use the URL as-is, for the program name.
-    # ======================================================================= #
-    when 'USE_URL'
-      i = url
-    else
-      # ===================================================================== #
-      # Handle github-specific links next.
-      # ===================================================================== #
-      if i and
-         is_github_url? and
-         i.start_with?('v-') and
-         (i =~ /v-\d{0,2}.\d{1,2}.\d{1,2}/) # See: http://rubular.com/r/tWF7ikLZiw
-        # =================================================================== #
-        # Ok, we now know that the input is something like 'v-1.11.0'.
-        # We must thus sanitize several parts of the dataset.
-        # =================================================================== #
-        if short_name? == 'v' # ← This must evidently be replaced then.
-          set_short_name(
-            search_for_this_program?.dup #, :also_set_other_names
-          )
-          set_program_name
-          set_base_dir
-          i = program_name?
-        end
-      end
-    end
-    # ======================================================================= #
-    # Get rid of any .tar.xz or similar archive end here.
-    # ======================================================================= #
-    i = remove_archive_from_the_end(i)
-    return i # We must return something.
-  end
-
-  require 'rbt/toplevel_methods/remove_file_extension.rb'
-  # ========================================================================= #
-  # === return_url_replace_underscore
-  # ========================================================================= #
-  def return_url_replace_underscore(i = url?)
-    _ = File.basename(i).dup
-    if _.include? '_'
-      _.tr!('_','-') # Replace all '_' with '-'.
-    elsif _.include? '.' # Else replace just the first '.'.
-      _.sub!('.','-')
-    end
-    _ = remove_file_extension(_)
-    return _
-  end
-
-  # ========================================================================= #
-  # === return_first_dot_as_hyphen_from_this_url
-  # ========================================================================= #
-  def return_first_dot_as_hyphen_from_this_url(i = url1?)
-    new_url = File.basename(i).dup # Obtain the URL here.
-    new_url.sub!(/\./,'-') # This replaces only the first '.' found.
-    return new_url
-  end
-
-  # ========================================================================= #
-  # === internal_commandline_arguments?
-  # ========================================================================= #
-  def internal_commandline_arguments?
-    @internal_hash[:internal_commandline_arguments]
-  end
-
-  # ========================================================================= #
-  # === shall_we_display_the_md5sum?
-  #
-  # Query whether we shall display the md5sum or whether we shall not.
-  # ========================================================================= #
-  def shall_we_display_the_md5sum?
-    dataset?[:shall_we_display_the_md5sum]
-  end; alias display_md5sum? shall_we_display_the_md5sum? # === display_md5sum?
-
-  # ========================================================================= #
-  # === check_for_binary_names?
-  # ========================================================================= #
-  def check_for_binary_names?
-    CHECK_FOR_BINARY_NAMES
-  end
-
-  # ========================================================================= #
-  # === is_a_boolean_configuration_value?
-  #
-  # Query method to determine whether the input is a boolean configuration
-  # value. For example, the String "use_glib_schema", would be a boolean
-  # configuration value and thus this method would return true.
-  # ========================================================================= #
-  def is_a_boolean_configuration_value?(i)
-    ( ARRAY_FALSE_VALUES + ARRAY_TRUE_VALUES ).flatten.include? i
-  end
-
-  # ========================================================================= #
-  # === check_for_library_names?
-  # ========================================================================= #
-  def check_for_library_names?
-    CHECK_FOR_LIBRARY_NAMES
-  end
-
-  # ========================================================================= #
-  # === entry_exists?
-  # ========================================================================= #
-  def entry_exists?
-    File.exist? location?
-  end
-
-  # ========================================================================= #
-  # === first_url?
-  #
-  # Returns the first url. Should be used if you want to access URLs.
-  # ========================================================================= #
-  def first_url?
-    dataset?.remote_urls.empty? ? '' : dataset?.remote_urls.first  
-  end
-
-  # ========================================================================= #
-  # === return_sanitize_url1
-  #
-  # This can be considered almost equaly to the old "sanitize_url1" method.
-  # ========================================================================= #
-  def return_sanitize_url1(i = url1?)
-    i = i.dup
-    # ======================================================================= #
-    # === Handle "llvm-10.0.0.src.tar.xz" and similar cases next
-    # ======================================================================= #
-    i.sub!(/\.src\./,'')          if i.include?  '.src.' # For doxygen.yml
-    i.delete_suffix!('/download') if i.end_with? '/download'
-    return i
-  end
-
-  # ========================================================================= #
-  # === raw_cookbook?
-  # ========================================================================= #
-  def raw_cookbook?
-    @internal_hash[:raw_cookbook]
-  end
-
-  # ========================================================================= #
-  # === raw_cookbook_dataset?
-  # ========================================================================= #
-  def raw_cookbook_dataset?
-    @internal_hash[:raw_cookbook] and raw_cookbook?.dataset?
-  end; alias raw_dataset? raw_cookbook_dataset? # === raw_dataset?
-
-  # ========================================================================= #
-  # === make_use_of_aliases_kept_in_the_file_cookbook_aliases?
-  #
-  # This method can be used to query whether we will make use of aliases
-  # kept in the cookbook_aliases.yml file or whether we will not.
-  # ========================================================================= #
-  def make_use_of_aliases_kept_in_the_file_cookbook_aliases?
-    @internal_hash[:make_use_of_aliases_kept_in_the_file_cookbook_aliases]
-  end; alias make_use_of_cookbook_aliases? make_use_of_aliases_kept_in_the_file_cookbook_aliases? # === make_use_of_cookbook_aliases?
-
-  # ========================================================================= #
-  # === is_an_active_project?
-  # ========================================================================= #
-  def is_an_active_project?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias active_project  is_an_active_project? # === active_project
-       alias active_project? is_an_active_project? # === active_project?
-
-  # ========================================================================= #
-  # === extracted_towards?
-  #
-  # Determine where the archive will be extracted towards. This will
-  # also specifically include the name of the program at hand and
-  # the corresponding version, such as 'gnome-mahjonng-5.08'.
-  # ========================================================================= #
-  def extracted_towards?
-    # ======================================================================= #
-    # We include the program name and the program version.
-    # ======================================================================= #
-    result = "#{extract_to?}#{program_name_and_program_version?}"
-    unless result.end_with? '/'
-      result = result.dup if result.frozen?
-      result << '/'
-    end
-    return result
-  end; alias extract_towards? extracted_towards? # === extract_towards?
-
-  # ========================================================================= #
-  # === return_default_location_of_this_cookbook
-  #
-  # This will use the default location based on the search_term.
-  # ========================================================================= #
-  def return_default_location_of_this_cookbook(
-      i = search_which_program?
-    )
-    "#{individual_cookbooks_directory?}#{i}.yml"
-  end; alias return_default_location return_default_location_of_this_cookbook # == return_default_location
-       alias yaml_file?              return_default_location_of_this_cookbook # == yaml_file?
-
-  # ========================================================================= #
-  # === raw_yaml_file?
-  # ========================================================================= #
-  def raw_yaml_file?
-    raw_cookbook?.yaml_file?
-  end
-
-  # ========================================================================= #
-  # === file?
-  # ========================================================================= #
-  def file?
-    raw_cookbook?.file?
-  end; alias file               file? # === file
-       alias which_file?        file? # === which_file?
-       alias raw_cookbook_file? file? # === raw_cookbook_file?
-
-  # ========================================================================= #
-  # === does_include?
-  # ========================================================================= #
-  def does_include?(
-      this_program,
-      honour_aliases = make_use_of_aliases_kept_in_the_file_cookbook_aliases?
-    )
-    # ======================================================================= #
-    # Delegate towards the toplevel-method next.
-    # ======================================================================= #
-    ::RBT.does_include?(
-      this_program, honour_aliases
-    )
-  end; alias is_included? does_include? # === is_included?
-
-  # ========================================================================= #
-  # === return_first_underscore_as_hyphen_and_other_undscores_as_dots
-  #
-  # This method exists specifically for input such as 'boost_1_61_0'.
-  # ========================================================================= #
-  def return_first_underscore_as_hyphen_and_other_undscores_as_dots(i = url?)
-    i = return_first_underscore_as_hyphen_from_this_url(i).dup
-    i.tr!('_','.')
-    return i
-  end
-
-  # ========================================================================= #
-  # === opposite_token?
-  #
-  # This method will return the "opposite" token, e. g. '_' is the
-  # "opposite to '-' and vice versa.
-  # ========================================================================= #
-  def opposite_token?(
-      i = @internal_hash[:use_this_connective_token]
-    )
-    case i
-    when '-'
-      '_'
-    when '_'
-      '-'
-    end
-  end
-
-  # ========================================================================= #
-  # === simple_or_complex?
-  # ========================================================================= #
-  def simple_or_complex?
-    @internal_hash[:simple_or_complex]
-  end; alias mode?        simple_or_complex? # === mode?
-       alias mode_in_use? simple_or_complex? # === mode_in_use?
-       alias type?        simple_or_complex? # === type?
-
-  # ========================================================================= #
-  # === seek_this_program?                                         (seek tag)
-  #
-  # This method will tell us as for which program we will search.
-  #
-  # Do note that this is NOT the same as program_name? or short_name?,
-  # because the latter two may contain upcased characters, such as
-  # for "libX11", whereas the variable here is ALWAYS downcased.
-  # ========================================================================= #
-  def seek_this_program?
-    @internal_hash[:seek_this_program]
-  end; alias seek_which_program       seek_this_program? # === seek_which_program
-       alias seek_which_program?      seek_this_program? # === seek_which_program?
-       alias which_program?           seek_this_program? # === which_program?
-       alias search_for_this_program? seek_this_program? # === search_for_this_program?
-       alias search_which_program?    seek_this_program? # === search_which_program?
-
-  # ========================================================================= #
-  # === return_program_name_from_the_raw_cookbook
-  # ========================================================================= #
-  def return_program_name_from_the_raw_cookbook
-    raw_cookbook?.program_name?
-  end
-
-  # ========================================================================= #
-  # === is_the_build_system_meson?
-  #
-  # Query-method to determine whether the build system makes use of meson
-  # or whether it does not.
-  # ========================================================================= #
-  def is_the_build_system_meson?
-    use_this_build_system? == 'meson'
-  end
-
-  # ========================================================================= #
-  # === is_the_build_system_cmake?
-  # ========================================================================= #
-  def is_the_build_system_cmake?
-    use_this_build_system? == 'cmake'
-  end
-
-  # ========================================================================= #
-  # === use_this_build_system?
-  #
-  # This method will query as to which build-system will be used for
-  # the given program at hand.
-  # ========================================================================= #
-  def use_this_build_system?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias use_this_build_system    use_this_build_system? # === use_this_build_system
-       alias use_which_build_system?  use_this_build_system? # === use_which_build_system?
-       alias build_system?            use_this_build_system? # === build_system?
-       alias build_system_to_be_used? use_this_build_system? # === build_system_to_be_used?
-
-  # ========================================================================= #
-  # === archive_type?
-  #
-  # Simply query the archive type here. The archive_type is something
-  # such as ".tar.gz" or ".tar.bz2".
-  # ========================================================================= #
-  def archive_type?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias archive?      archive_type? # === archive?
-       alias archive_type  archive_type? # === archive_type
-       alias archive_name? archive_type? # === archive_name?
-
-  # ========================================================================= #
-  # === return_program_version_from_the_raw_cookbook
-  # ========================================================================= #
-  def return_program_version_from_the_raw_cookbook
-    raw_cookbook?.program_version?
-  end
-
-  # ========================================================================= #
-  # === original_unmodified_name?
-  # ========================================================================= #
-  def original_unmodified_name?
-    @internal_hash[:original_unmodified_name]
-  end
-
-  # ========================================================================= #
-  # === url2?
-  # ========================================================================= #
-  def url2?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === binaries?
-  # ========================================================================= #
-  def binaries?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias binaries binaries? # === binaries
-       alias bin?     binaries? # === bin?
-
-  # ========================================================================= #
-  # === headers?
-  # ========================================================================= #
-  def headers?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias headers headers? # === headers
-
-  # ========================================================================= #
-  # === n_headers?
-  # ========================================================================= #
-  def n_headers?
-    headers?.size
-  end
-
-  # ========================================================================= #
-  # === base_dir?
-  #
-  # This is entry (5), a simple query method. It will give us back the
-  # base directory of our program in question, such as '/home/x/src/htop/'.
-  # ========================================================================= #
-  def base_dir?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias base_dir base_dir? # === base_dir
-
-  # ========================================================================= #
-  # === replace_plus_with_long_name?
-  # ========================================================================= #
-  def replace_plus_with_long_name?
-    @internal_hash[:replace_plus_with_long_name]
-  end
-
-  # ========================================================================= #
-  # === mirror?
-  # ========================================================================= #
-  def mirror?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === urls?
-  #
-  # This method is an "aggregate-method"; it will return all available
-  # URLs in Array format.
-  #
-  # We only support 5 URLs at max right now, though.
-  #
-  # Since as of July 2012 this method will not return empty values,
-  # as they are useless anyway.
-  # ========================================================================= #
-  def urls?
-    # ======================================================================= #
-    # Build our Array that will hold all 5 URLs.
-    # ======================================================================= #
-    array = %w( url1 url2 url3 url4 url5 )
-    _ = dataset?.values_at(*array) # We require the * here.
-    _.compact!
-    _.reject!(&:empty?) # We don't want empty entries, hence we filter them away.
-    return _
-  end; alias remote_urls  urls? # === remote_urls
-       alias remote_urls? urls? # === remote_urls?
-
-  # ========================================================================= #
-  # === return_version_from_url1
-  #
-  # This will return the inferred version from the url1 entry.
-  # ========================================================================= #
-  def return_version_from_url1(
-      use_this_URL = url1?
-    )
-    _ = remove_archive_at_the_end(
-      File.basename(use_this_URL)
-    )
-    program_information_return_version(_)
-  end
-
-  # ========================================================================= #
-  # === program_path?
-  #
-  # This method will return the 'program_path' value, through the reader
-  # method obtain().
-  #
-  # The program_path variable has the FULL path to the archive in
-  # question, for instance:
-  #
-  #   /home/x/src/gnomemahjonng/gnome-mahjonng-5.08.tar.xz
-  #   /home/x/src/gpm/gpm-1.20.1.tar.bz2
-  #   /home/x/src/gambas3/gambas3-3.10.0.tar.xz
-  #   base_dir? ^^^^^^^^^ program_full_name? ^^^
-  #
-  # It consists of base_dir?+program_full_name?.
-  #
-  # Do note that the program_path value is the most important entry,
-  # as ALL the other information can be derived from the information
-  # stored in this variable alone.
-  # ========================================================================= #
-  def program_path?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias local_url?          program_path? # === local_url?
-       alias full_path           program_path? # === full_path
-       alias full_path?          program_path? # === full_path?
-       alias location?           program_path? # === location?
-       alias can_be_found_where? program_path? # === can_be_found_where?
-       alias stored_where?       program_path? # === stored_where?
-       alias program_path        program_path? # === program_path
-       alias path?               program_path? # === path?
-       alias path                program_path? # === path
-       alias ppath?              program_path? # === ppath?
-       alias full_program_path?  program_path? # === full_program_path?
-
-  # ========================================================================= #
-  # === licence?
-  #
-  # This is the query method over licence.
-  #
-  # Do note that while the specification allows for both a String value,
-  # or an Array value alternatively, it only really makes sense to
-  # assume that tag to be a String.
-  #
-  # The reason why an Array is used as an alternative is twofold:
-  #
-  #   (1) That way we can also respect programs that have more than
-  #       one licence.
-  #   (2) It may sometimes be more convenient to use an Array in the
-  #       corresponding .yml file.
-  #
-  # ========================================================================= #
-  def licence?
-    _ = obtain(__method__.to_s.delete('?').to_sym).to_s
-    _ = _.first if _.is_a? Array
-    return _
-  end; alias license? licence? # === license?
-
-  # ========================================================================= #
-  # === gir_files?
-  # ========================================================================= #
-  def gir_files?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias girfiles? gir_files? # === girfiles?
-       alias gir_files gir_files? # === gir_files
-
-  # ========================================================================= #
-  # === url1?
-  #
-  # This method will "hold" the "most" important URL of a program, which is 
-  # the entry called url1.
-  #
-  # Every entry of our cookbooks must have this entry available.
-  #
-  # Usage example to query the value of url1?:
-  #
-  #   puts RBT::Cookbooks::SanitizeCookbook.new('htop').url1?
-  #
-  # ========================================================================= #
-  def url1?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias main_url                   url1? # === main_url
-       alias remote_url                 url1? # === remote_url
-       alias main_url?                  url1? # === main_url?
-       alias url1                       url1? # === url1
-       alias url?                       url1? # === url?
-       alias remote_url?                url1? # === remote_url?
-       alias url_to_the_source_archive? url1? # === url_to_the_source_archive?
-
-  # ========================================================================= #
-  # === symlink_glib_schema?
-  # ========================================================================= #
-  def symlink_glib_schema?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === use_autoconf?
-  # ========================================================================= #
-  def use_autoconf?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === use_this_build_directory?
-  # ========================================================================= #
-  def use_this_build_directory?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias build_dir?               use_this_build_directory? # === build_dir?
-       alias use_this_build_directory use_this_build_directory? # === use_this_build_directory
-
-  # ========================================================================= #
-  # === set_env_variables?
-  #
-  # Query the environment variables that this cookbook may set.
-  # ========================================================================= #
-  def set_env_variables?
-    obtain(__method__.to_s.delete('?').to_sym)
-  end; alias env_variables? set_env_variables? # === env_variables?
-     # alias set_env_variables set_env_variables? # === set_env_variables
-     # ^^^ This alias would interfere with the set_env_variables() reader method.
-
-  # ========================================================================= #
-  # === build_static?
-  # ========================================================================= #
-  def build_static?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias build_static build_static? # === build_static
-
-  # ========================================================================= #
-  # === has_to_be_compiled?
-  # ========================================================================= #
-  def has_to_be_compiled?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias has_to_be_compiled                    has_to_be_compiled? # === has_to_be_compiled
-       alias does_the_program_have_to_be_compiled? has_to_be_compiled? # === does_the_program_have_to_be_compiled?
-
-  # ========================================================================= #
-  # === configure_base_dir?
-  # ========================================================================= #
-  def configure_base_dir?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias configure_base_directory? configure_base_dir? # === configure_base_directory?
-
-  # ========================================================================= #
-  # === has_tags?
-  #
-  # This method will return true or false depending on whether the given
-  # program at hand has any tags registered at all, or whether it has not.
-  # ========================================================================= #
-  def has_tags?
-    return false if tags?.empty?
-    return true
-  end
-
-  # ========================================================================= #
-  # === svn_url?
-  # ========================================================================= #
-  def svn_url?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === last_update?
-  #
-  # The last_update tag keeps track over as to when that particular program
-  # was last updated.
-  # ========================================================================= #
-  def last_update?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias last_update last_update? # === last_update
-
-  # ========================================================================= #
-  # === m4_files?
-  # ========================================================================= #
-  def m4_files?
-    obtain :m4_files
-  end; alias m4_files m4_files? # === m4_files
-
-  # ========================================================================= #
-  # === archive_size?
-  #
-  # This method keeps track of the size of the program tarball in question.
-  #
-  # For this to work, we should have initialized the program size at 0.
-  # ========================================================================= #
-  def archive_size?
-    obtain(__method__.to_s.delete('?').to_sym)
-  end; alias size          archive_size? # === size
-       alias size?         archive_size? # === size?
-       alias program_size  archive_size? # === program_size
-       alias program_size? archive_size? # === program_size?
-       alias archive_size  archive_size? # === archive_size
-       alias file_size?    archive_size? # === file_size?
-       alias file_size     archive_size? # === file_size
-
-  # ========================================================================= #
-  # === use_this_program_name_on_gobolinux?
-  # ========================================================================= #
-  def use_this_program_name_on_gobolinux?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === use_autogen?
-  # ========================================================================= #
-  def use_autogen?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias use_autogen use_autogen? # === use_autogen
-
-  # ========================================================================= #
-  # === cmake_configure_options?
-  # ========================================================================= #
-  def cmake_configure_options?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias cmake_configure_options cmake_configure_options? # === cmake_configure_options
-
-  # ========================================================================= #
-  # === postinstall?
-  # ========================================================================= #
-  def postinstall?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias postinstallation? postinstall? # === postinstallation?
-
-  # ========================================================================= #
-  # === description?
-  #
-  # In the past raw_description? was guaranteed to return the unmodified
-  # description, including newlines.
-  #
-  # During the rewrite in April 2021, this no longer seemed necessary,
-  # as the sanitization-logic was changed.
-  # ========================================================================= #
-  def description?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias raw_description? description? # === raw_description?
-       alias raw_description  description? # === raw_description
-
-  # ========================================================================= #
-  # === pre_make_commands?
-  # ========================================================================= #
-  def pre_make_commands?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias pre_make_commands pre_make_commands? # === pre_make_commands
-
-  # ========================================================================= #
-  # === use_this_program_name
-  # ========================================================================= #
-  def use_this_program_name
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === git_url?
-  # ========================================================================= #
-  def git_url?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias giturl? git_url? # === giturl?
-
-  # ========================================================================= #
-  # === pre_configure_steps?
-  # ========================================================================= #
-  def pre_configure_steps?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === pkgconfig_files?
-  # ========================================================================= #
-  def pkgconfig_files?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias pkgconfig_files pkgconfig_files? # === pkgconfig_files
-
-  # ========================================================================= #
-  # === symlink_pkgconfig_files?
-  # ========================================================================= #
-  def symlink_pkgconfig_files?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias symlink_pkgconfig_files symlink_pkgconfig_files? # === symlink_pkgconfig_files
-
-  # ========================================================================= #
-  # === symlink_headers?
-  # ========================================================================= #
-  def symlink_headers?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias symlink_headers               symlink_headers? # === symlink_headers
-       alias shall_we_symlink_the_headers? symlink_headers? # === shall_we_symlink_the_headers?
-
-  # ========================================================================= #
-  # === configure_command_to_use?
-  #
-  # The specific configure command that we will use.
-  # ========================================================================= #
-  def configure_command_to_use?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias configure_command  configure_command_to_use? # === configure_command
-       alias configure_command? configure_command_to_use? # === configure_command?
-
-  # ========================================================================= #
-  # === extra_information?
-  # ========================================================================= #
-  def extra_information?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === modify_the_makefile?
-  #
-  # This method will query whether RBT will modify the Makefile at hand
-  # or whether it will not. Some Makefiles have hardcoded paths which
-  # do not respect the given --prefix variant, not even DESTDIR, as
-  # far as I know. Hence, for these .yml files, we need to have a way
-  # to modify that Makefile and correct it.
-  # ========================================================================= #
-  def modify_the_makefile?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias modify_the_makefile modify_the_makefile? # === modify_the_makefile
-
-  # ========================================================================= #
-  # === run_make?
-  # ========================================================================= #
-  def run_make?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias run_make run_make? # === run_make
-
-  # ========================================================================= #
-  # === meson_configure_options?
-  # ========================================================================= #
-  def meson_configure_options?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias meson_configure_options meson_configure_options? # === meson_configure_options
-
-  # ========================================================================= #
-  # === autosymlink_lib64
-  # ========================================================================= #
-  def autosymlink_lib64?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias autosymlink_lib64 autosymlink_lib64? # === autosymlink_lib64
-
-  # ========================================================================= #
-  # === use_this_make_command?
-  # ========================================================================= #
-  def use_this_make_command?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias use_this_make_command   use_this_make_command? # === use_this_make_command
-       alias use_which_make_command? use_this_make_command? # === use_which_make_command?
-
-  # ========================================================================= #
-  # === do_not_symlink?
-  #
-  # Reader method over whether we will not symlink.
-  # ========================================================================= #
-  def do_not_symlink?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === parameters_to_make?
-  # ========================================================================= #
-  def parameters_to_make?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias make_options  parameters_to_make? # === make_options
-       alias make_options? parameters_to_make? # === make_options?
-
-  # ========================================================================= #
-  # === configure_options?
-  #
-  # Convenience method to query the configuration options available.
-  # ========================================================================= #
-  def configure_options?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias configuration_options  configure_options? # === configuration_options
-       alias configuration_options? configure_options? # === configuration_options?
-       alias configure_options      configure_options? # === configure_options
-
-  # ========================================================================= #
-  # === use_this_make_install_command?
-  #
-  # Which variant of "make install" we will use, if we will use a
-  # different variant that is.
-  # ========================================================================= #
-  def use_this_make_install_command?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === may_we_modify_the_configure_options?
-  # ========================================================================= #
-  def may_we_modify_the_configure_options?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias may_we_modify_the_configure_options may_we_modify_the_configure_options? # === may_we_modify_the_configure_options
-
-  # ========================================================================= #
-  # === sed?
-  # ========================================================================= #
-  def sed?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === recommended_deps_on?
-  # ========================================================================= #
-  def recommended_deps_on?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === description?                                        (description tag)
-  #
-  # The description value of a program will be returned via this method.
-  # ========================================================================= #
-  def description?(
-      wrap_result = wrap_result?
-    )
-    result = obtain(:description)
-    case wrap_result
-    # ======================================================================= #
-    # === :retain_newlines
-    # ======================================================================= #
-    when :retain_newlines
-      wrap_result = false
-    end
-    if wrap_result
-      if use_word_wrap?
-        result = word_wrap(result)
-      end if result # Do not work on nil-values here.
-    end
-    return result
-  end; alias desc?           description? # === desc?
-       alias description_of? description? # === description_of?
-
-  # ========================================================================= #
-  # === n_libraries?
-  # ========================================================================= #
-  def n_libraries?
-    libraries?.size
-  end
-
-  # ========================================================================= #
-  # === program?
-  # ========================================================================= #
-  def program?
-    first_argument?
-  end
-
-  # ========================================================================= #
-  # === do_not_download?
-  # ========================================================================= #
-  def do_not_download?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === preinstall?
-  #
-  # Note that preinstall is an Array.
-  # ========================================================================= #
-  def preinstall?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === apply_patch?
-  #
-  # Query-method as to whether we shall apply a patch or whether we
-  # shall not.
-  # ========================================================================= #
-  def apply_patch?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === installation_steps?
-  # ========================================================================= #
-  def installation_steps?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === url3?
-  # ========================================================================= #
-  def url3?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias url3 url3? # === url3
-
-  # ========================================================================= #
-  # === program_compile_name?
-  #
-  # This will be guaranteed to be a String.
-  # ========================================================================= #
-  def program_compile_name?
-    obtain(__method__.to_s.delete('?').to_sym).to_s
-  end
-
-  # ========================================================================= #
-  # === program_name_and_program_version?
-  #
-  # Note that the connective token in use is usually '-', but there are
-  # programs such as 'artemis_v16.0.11.jar' that have no '-' at all
-  # whatsoever. To also honour such programs, we have to use this
-  # connective token - it will be re-defined towards '_' specifically
-  # for programs that have no '-' token, such as artemis.
-  # ========================================================================= #
-  def program_name_and_program_version?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias program_name_and_program_version        program_name_and_program_version? # === program_name_and_program_version
-       alias program_name_and_version?               program_name_and_program_version? # === program_name_and_version?
-       alias program_name_and_the_program_version?   program_name_and_program_version? # === program_name_and_the_program_version?
-       alias return_program_name_and_program_version program_name_and_program_version? # === return_program_name_and_program_version
-
-  # ========================================================================= #
-  # === tags?
-  # ========================================================================= #
-  def tags?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias return_tags tags? # === return_tags
-       alias tags        tags? # === tags
-
-  # ========================================================================= #
-  # === short_description?
-  #
-  # This method will obtain the short description of a given program.
-  #
-  # Not every program will have a short description, but it is recommended
-  # that all programs SHOULD have a short description.
-  # ========================================================================= #
-  def short_description?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias short_desc?              short_description? # === short_desc?
-       alias return_short_description short_description? # === return_short_description
-
-  # ========================================================================= #
-  # === short_name?
-  #
-  # Reader method for short_name.
-  #
-  # This method will query the short name of the program we are trying
-  # to find.
-  #
-  # For example, this method will return the program name without the
-  # version, such as:
-  #
-  #  "ruby" (which is part of the program_name "ruby-2.2.0")
-  #
-  # This method must always return a String, even if it is an empty
-  # String.
-  #
-  # Characters such as '-' are NOT allowed to be part of the
-  # short_name variable. The corresponding setter-method will
-  # make sure of this.
-  # ========================================================================= #
-  def short_name?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias real_short_name?    short_name? # === real_short_name?
-       alias rshort?             short_name? # === rshort?
-       alias program_short_name? short_name? # === program_short_name?
-       alias short_program_name? short_name? # === short_program_name?
-       alias shortname?          short_name? # === shortname?
-       alias short_name          short_name? # === short_name
-       alias sname?              short_name? # === sname?
-       alias name                short_name? # === name
-       alias name?               short_name? # === name?
-       # alias program?          short_name? # === program? # This is already occupied.
-
-  # ========================================================================= #
-  # === program_version?
-  #
-  # This method must always return a String.
-  #
-  # We use it to query the program version of the specific program at hand.
-  #
-  # For instance, if the program name is "python-2.4" then this
-  # method will return the version string part, i.e. "2.4".
-  # ========================================================================= #
-  def program_version?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias version                program_version? # === version An alias to the above ^^^.
-       alias version?               program_version? # === version?
-       alias pversion?              program_version? # === pversion?
-       alias program_version        program_version? # === program_version
-       alias return_program_version program_version? # === return_program_version
-
-  # ========================================================================= #
-  # === enable_shared?
-  # ========================================================================= #
-  def enable_shared?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === use_glib_schema?
-  # ========================================================================= #
-  def use_glib_schema?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias use_glib_schema use_glib_schema? # === use_glib_schema
-
-  # ========================================================================= #
-  # === optional_start_message
-  # ========================================================================= #
-  def optional_start_message?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias optional_start_message optional_start_message? # === optional_start_message
-
-  # ========================================================================= #
-  # === pre_make_install_sed?
-  # ========================================================================= #
-  def pre_make_install_sed?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias pre_make_install_sed pre_make_install_sed? # === pre_make_install_sed?
-
-  # ========================================================================= #
-  # === libraries?
-  #
-  # Return the given libraries that will be installed by the given program
-  # at hand.
-  # ========================================================================= #
-  def libraries?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === debug?
-  # ========================================================================= #
-  def debug?
-    @internal_hash[:debug]
-  end
-
-  # ========================================================================= #
-  # === last_url?
-  #
-  # Returns the last url. Should be used if you want to access URLs.
-  # ========================================================================= #
-  def last_url?
-    dataset?.remote_urls.empty? ? '' : dataset?.remote_urls.last  
-  end
-
-  # ========================================================================= #
-  # === program_name?
-  #
-  # This method is a reader-method over e. g. 'gnome-mahjongg'.
-  #
-  # It does NOT have the version of the program included, which is
-  # a different behaviour enabled during May 2020.
-  # ========================================================================= #
-  def program_name?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias name_and_version?                 program_name? # === name_and_version?
-       alias pname?                            program_name? # === pname?
-       alias program_name                      program_name? # === program_name
-
-  # ========================================================================= #
-  # === homepage?
-  # ========================================================================= #
-  def homepage?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias return_homepage  homepage? # === return_homepage
-       alias remote_homepage? homepage? # === remote_homepage?
-       alias homepage         homepage? # === homepage
-       alias homepage_url?    homepage? # === homepage_url?
-
-  # ========================================================================= #
-  # === run_configure
-  # ========================================================================= #
-  def run_configure?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === return_appdir_prefix
-  #
-  # This method will return an App-Dir like path of the given program at
-  # hand, such as "ffmpeg" or "php".
-  #
-  # It is typically called from within the method called .sanitize_the_prefix().
-  # In other words, whenever we need to sanitize the prefix passed this
-  # method will be called.
-  #
-  # This method requires that short_name? and program_version? were
-  # already defined prior to its invocation.
-  #
-  # The appdir components would be like this:
-  #
-  #   /home//Programs/Ruby/2.4.1/
-  #   programs_dir?+short_name?.capitalize+'/'+program_version?
-  #
-  # ========================================================================= #
-  def return_appdir_prefix(
-      programs_dir_to_use    = programs_dir?, 
-      short_name_to_use      = short_name?.capitalize,
-      program_version_to_use = program_version?
-    )
-    _ = programs_dir_to_use.dup
-    if are_we_on_gobolinux?
-      _ << program_compile_name?.dup
-    else
-      _ << short_name_to_use.dup
-    end
-    _ << "/#{program_version_to_use.dup}/"
-    return _
-  end; alias return_appdir_path return_appdir_prefix # === return_appdir_path
-       alias build_appdir_path  return_appdir_prefix # === build_appdir_path
-
-  # ========================================================================= #
-  # === can_be_compiled_statically?
-  # ========================================================================= #
-  def can_be_compiled_statically?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === compiler_to_use?
-  # ========================================================================= #
-  def compiler_to_use?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === libexec?
-  # ========================================================================= #
-  def libexec?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === required_deps_on?
-  #
-  # This method will list the required dependencies of a given program and
-  # returns them, at least those that are defined in the
-  # 'required_deps_on:' entry of the respective yaml file.
-  #
-  # Please keep in mind that our dependencies must be kept in Array form.
-  # ========================================================================= #
-  def required_deps_on?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias program_dependencies_on   required_deps_on? # === program_dependencies_on
-       alias deps_on?                  required_deps_on? # === deps_on?
-       alias dependencies_on?          required_deps_on? # === dependencies_on?
-       alias return_dependencies       required_deps_on? # === return_dependencies
-       alias required_deps?            required_deps_on? # === required_deps?
-       alias dependencies?             required_deps_on? # === dependencies?
-       alias required_dependencies_on? required_deps_on? # === required_dependencies_on?
-       alias deps?                     required_deps_on? # === deps?
-
-  # ========================================================================= #
-  # === enable_static?
-  # ========================================================================= #
-  def enable_static?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === localstatedir?
-  # ========================================================================= #
-  def localstatedir?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === keep_extracted?
-  # ========================================================================= #
-  def keep_extracted?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias keep_extracted              keep_extracted? # === keep_extracted
-       alias keep_the_archive_extracted? keep_extracted? # === keep_the_archive_extracted?
-
-  # ========================================================================= #
-  # === flatpak_url?
-  # ========================================================================= #
-  def flatpak_url?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias flatpak_url flatpak_url? # === flatpak_url
-
-  # ========================================================================= #
-  # === program_full_name?
-  #
-  # This entry will have everything except the leading PATH.
-  #
-  # For instance:
-  #
-  #  "gpm-1.20.1.tar.xz"
-  #
-  # ========================================================================= #
-  def program_full_name?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias program_full_name  program_full_name? # === program_full_name
-       alias full_program_name? program_full_name? # === full_program_name?
-
-  # ========================================================================= #
-  # === blfs?                                                      (blfs tag)
-  #
-  # The "Beyond linux from scratch" variable will be returned here,
-  # should it exist.
-  # ========================================================================= #
-  def blfs?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === use_build_directory?
-  #
-  # Query whether a build directory will be used for the given program
-  # at hand.
-  # ========================================================================= #
-  def use_build_directory?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias use_build_dir?         use_build_directory? # === use_build_dir?
-       alias use_build_directory    use_build_directory? # === use_build_directory
-       alias use_a_build_directory  use_build_directory? # === use_a_build_directory
-       alias use_a_build_directory? use_build_directory? # === use_a_build_directory?
-
-  # ========================================================================= #
-  # === manual_steps?
-  # ========================================================================= #
-  def manual_steps?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
-  # ========================================================================= #
-  # === prefix?
-  #
-  # Query the prefix in use by our sought program.
-  # ========================================================================= #
-  def prefix?
-    obtain __method__.to_s.delete('?').to_sym
-  end; alias prefix         prefix? # === prefix
-       alias prefix_to_use? prefix? # === prefix_to_use?
-
-  # ========================================================================= #
-  # === obtain                                            (obtain tag, o tag)
-  #
-  # This getter-method can be used to obtain elements from the main yaml
-  # dataset, which is stored in:
-  #
-  #   @internal_hash[:dataset]
-  #
-  # The main reason why a method is used here is because the keys can
-  # be either Symbols or Strings. If we ever wish to change to another
-  # format, we can do so thanks to the flexibility of this setup.
-  # ========================================================================= #
-  def obtain(this_key)
-    result = nil
-    # ======================================================================= #
-    # Next, we need to decide whether we use a Symbol, or a String.
-    # ======================================================================= #
-    unless this_key.is_a? Symbol
-      this_key = this_key.to_sym if complex_mode?
-    end
-    dataset = dataset?
-    if dataset
-      if dataset.has_key? this_key
-        result = dataset[this_key] # [] is better than .fetch() here.
-      # elsif raw_cookbook_dataset?.has_key?(what.to_s)
-      #  result = raw_cookbook_dataset?[what.to_s]
-      #else
-        # e rev+'DEBUG: TODO, remove me -> No key called '+
-        # steelblue(this_key.to_s)+' (class: '+this_key.class.to_s+
-        # ') could be found.'
-      end
-    end
-    return result
-  end; alias o            obtain # === o (o tag)
-       alias get_value_of obtain # === get_value_of
-
-end; end; end