environment_information 1.4.99

data/lib/environment_information/queries/simple_version.rb

@@ -0,0 +1,217 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === EnvironmentInformation::Queries::SimpleVersion
+#
+# This class will try to do a query based on the main binary at hand.
+#
+# It is only a wrapper over "--version" and nothing else.
+# =========================================================================== #
+# require 'environment_information/queries/simple_version.rb'
+# EnvironmentInformation::Queries::SimpleVersion.new
+# =========================================================================== #
+require 'environment_information/base/base.rb'
+
+module EnvironmentInformation
+
+module Queries
+
+class SimpleVersion < ::EnvironmentInformation::Base # === EnvironmentInformation::Queries::SimpleVersion
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument is mandatory.
+  # ========================================================================= #
+  def initialize(
+      for_this_program = nil,
+      run_already      = true
+    )
+    reset
+    set_program_name(
+      for_this_program
+    )
+    # ======================================================================= #
+    # === Handle blocks given next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Hash
+        if yielded.has_key? :prefix_to_use
+          @prefix_to_use << yielded.delete(:prefix_to_use)
+        end
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @program_name
+    # ======================================================================= #
+    @program_name    = ''.dup
+    # ======================================================================= #
+    # === @program_version
+    # ======================================================================= #
+    @program_version = nil
+    # ======================================================================= #
+    # === @prefix_to_use
+    # ======================================================================= #
+    @prefix_to_use = ''.dup
+  end
+
+  # ========================================================================= #
+  # === set_program_name
+  # ========================================================================= #
+  def set_program_name(i)
+    @program_name = i.to_sym if i
+  end
+
+  # ========================================================================= #
+  # === program_name?
+  # ========================================================================= #
+  def program_name?
+    @program_name
+  end
+
+  # ========================================================================= #
+  # === program_version?
+  # ========================================================================= #
+  def program_version?
+    @program_version
+  end; alias version? program_version? # === version?
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    return_version_of
+  end
+
+  # ========================================================================= #
+  # === return_version_of
+  # ========================================================================= #
+  def return_version_of(this_program = @program_name)
+    _ = ::EnvironmentInformation.query_to_use_for_the_individual_components?
+    if _.nil?
+      _ = ::EnvironmentInformation.load_file_query_to_use_for_the_individual_components
+    end
+    if _.has_key?(this_program)
+      result = _[this_program]
+      case result
+      when :version
+        @program_version = `#{@prefix_to_use}#{this_program} --version #{ERROR_LINE}`.strip
+      end
+    end
+    if @program_version
+      if @program_version.include? N
+        @program_version = @program_version.split(N).first
+      end
+      if @program_version.include? '--'
+        @program_version.gsub!(/--/,'') # For strace specifically.
+      end
+      # if @program_version.include? 'GNOME Document Viewer'
+      #   @program_version.sub!(/GNOME Document Viewer/,'') # For evince specifically.
+      # end
+      if @program_version.include? 'GNU'
+        @program_version.gsub!(/GNU/,'')
+      end
+      if @program_version.include? ' built on linux-gnu.'
+        @program_version.gsub!(/ built on linux-gnu\./, '') # Fixing wget specifically.
+      end
+      if @program_version.include?('Midnight Commander')
+        @program_version.gsub!(/Midnight Commander/, '')
+      end
+      if @program_version.include?('[') and @program_version.include?(']')
+        @program_version.gsub!(/\[.+\]/, '')
+      end
+      @program_version.strip!
+      if @program_version.start_with? "#{this_program} "
+        # For example: "ruby 2.7.1p83 (2020-03-31 revision a0c7c23c9c) [x86_64-linux]"
+        @program_version.sub!(/#{this_program} /, '')
+      elsif @program_version.start_with? "#{this_program.capitalize} "
+        # For example: "Wget 1.20.3 built on linux-gnu."
+        @program_version.sub!(/#{this_program.capitalize} /, '')
+      elsif @program_version.start_with? "#{this_program.upcase} "
+        # For example: "NASM version 2.15.04 compiled on Aug 27 2020"
+        @program_version.sub!(/#{this_program.upcase} /, '')
+      elsif @program_version.downcase.start_with? "#{this_program.downcase} "
+        # For example: "IceWM", has a unusual start.
+        @program_version.sub!(/#{this_program} /i, '')
+      elsif @program_version.start_with? 'Awk'
+        @program_version.sub!(/Awk /i, '') # Ad-hox fix here.
+      end
+      if @program_version.include? '- Vi IMproved '
+        @program_version.sub!(/- Vi IMproved /, '') # Fixing vim specifically.
+      end
+      if @program_version.include? '(v'
+        # This is specifically for perl:
+        #   "This is perl 5, version 32, subversion 0 (v5.32.0) built for x86_64-linux-thread-multi"
+        @program_version = @program_version.scan(
+                             /\(v(\d{0,2}\.?\d{0,2}\.\d{0,2})\)/
+                           ).flatten.first.to_s.dup
+      end
+      # ===================================================================== #
+      # The next check for "Version" should come after we eliminated
+      # the leading program name.
+      # ===================================================================== #
+      if @program_version.include? 'Version '
+        @program_version = @program_version.scan(
+                             /Version (\d{0,2}\.?\d{0,2}\.\d{0,2})/
+                           ).flatten.first.to_s.dup
+      elsif @program_version.include? 'version '
+        # This here should work for most programs, save for perl.
+        @program_version = @program_version.scan(
+                             /version (\d{0,2}\.?\d{0,2}\.\d{0,2})/
+                           ).flatten.first.to_s.dup
+      end
+      if @program_version.include? ' patchlevel '
+        # =================================================================== #
+        # Gnuplot has this specifically: "5.4 patchlevel 0"
+        # =================================================================== #
+        @program_version = @program_version.sub(/ patchlevel /,'.').strip
+      end
+      # ===================================================================== #
+      # Next we kill everything inside (). This may sometimes be 
+      # problematic, which is why this check comes quite late.
+      # ===================================================================== #
+      if @program_version.include?('(') and @program_version.include?(')')
+        @program_version.gsub!(/\(.+\)/, '')
+      end
+      # ===================================================================== #
+      # Handle: "IceWM 1.8.0, Copyright 1997-2003 Marko Macek, 2001 Mathias Hasselmann."
+      # ===================================================================== #
+      if @program_version.include?(',')
+        @program_version = @program_version.split(',').first
+      end
+      # ===================================================================== #
+      # Next, if a '-' is included, we split it and use the last part.
+      # This handles cases such as "valgrind-3.16.0".
+      # ===================================================================== #
+      if @program_version.include?('-')
+        @program_version = @program_version.split('-').last
+      end
+      # ===================================================================== #
+      # Last but not least, for "node" specifically.
+      # ===================================================================== #
+      if @program_version.start_with? 'v'
+        @program_version[0,1] = ''
+      end
+      if @program_version.include? COMMAND_NOT_FOUND
+        @program_version = nil
+      end
+    end
+    return @program_version
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  seek_this_program = :gnuplot # :lftp
+  _ = EnvironmentInformation::Queries::SimpleVersion.new(seek_this_program)
+  _.report_left_right
+end # rb simple_version

data/lib/environment_information/requires/require_asciitable.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/requires/require_asciitable.rb'
+# =========================================================================== #
+begin
+  class EnvironmentInformation::EnvironmentInformation; end # Define a prototype here.
+  require 'ascii_paradise/requires/require_asciitable_namespace.rb'
+  EnvironmentInformation::ASCIITABLE_IS_AVAILABLE = true
+rescue LoadError
+  # puts 'asciitable is not available, consider installing it.'
+  # puts 'We will, however, continue, as it is not a mandatory package.'
+  EnvironmentInformation::ASCIITABLE_IS_AVAILABLE = false
+end

data/lib/environment_information/requires/require_the_constants.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/requires/require_the_constants.rb'
+# =========================================================================== #
+require 'environment_information/constants/constants.rb'

data/lib/environment_information/requires/require_the_environment_information_project.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/requires/require_the_environment_information_project.rb'
+# =========================================================================== #
+require 'environment_information/requires/require_the_constants.rb'
+require 'environment_information/colours/sfancy.rb'
+require 'environment_information/colours/simp.rb'
+require 'environment_information/version/version.rb'
+# =========================================================================== #
+# Next, require the individual components:
+# =========================================================================== #
+require 'environment_information/requires/require_the_individual_misc_components.rb'
+# =========================================================================== #
+# Next, require the toplevel-methods of environment_information/:
+# =========================================================================== #
+require 'environment_information/requires/require_the_toplevel_methods.rb'
+# =========================================================================== #
+# And then we will require the main class of the environment information
+# project:
+# =========================================================================== #
+require 'environment_information/class/class.rb'

data/lib/environment_information/requires/require_the_individual_misc_components.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/requires/require_the_individual_misc_components.rb'
+# =========================================================================== #
+module EnvironmentInformation
+
+  require 'environment_information/constants/array_tracked_components.rb'
+
+  # ========================================================================= #
+  # === EnvironmentInformation.require_all_individual_misc_components
+  #
+  # This method can be used to load all the individual misc-components
+  # that are part of the EnvironmentInformation project.
+  # ========================================================================= #
+  def self.require_all_individual_misc_components
+
+    # ======================================================================= #
+    # Batch-require the components in the misc_components/ directory next:
+    # ======================================================================= #
+    tracked_non_programs?.each {|this_component|
+      require "environment_information/misc_components/#{this_component}.rb"
+    }
+
+  end
+
+  require_all_individual_misc_components
+
+end

data/lib/environment_information/requires/require_the_toplevel_methods.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/requires/require_the_toplevel_methods.rb'
+# =========================================================================== #
+module EnvironmentInformation
+
+  require 'environment_information/project/project.rb'
+
+  # ========================================================================= #
+  # === EnvironmentInformation.require_the_toplevel_methods
+  # ========================================================================= #
+  def self.require_the_toplevel_methods
+    Dir["#{PROJECT_BASE_DIRECTORY}toplevel_methods/*.rb"].each {|this_file|
+      require "environment_information/toplevel_methods/#{File.basename(this_file)}"
+    }
+  end
+
+  require_the_toplevel_methods # And require them at once.
+
+end

data/lib/environment_information/toplevel_methods/autogenerate_all_relevant_methods.rb

@@ -0,0 +1,152 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Code in this file is tasked to autogenerate the relevant methods for use
+# in the toplevel EnvironmentInformation namespace.
+# =========================================================================== #
+# require 'environment_information/toplevel_methods/autogenerate_all_relevant_methods.rb'
+# =========================================================================== #
+module EnvironmentInformation
+
+  require 'environment_information/constants/array_tracked_components.rb'
+  require 'environment_information/toplevel_methods/return_version_of_this_program.rb'
+
+  # ========================================================================= #
+  # === EnvironmentInformation.autogenerate_all_relevant_methods
+  #
+  # By default this method will scan for all tracked programs, and
+  # for the xorg-components.
+  # ========================================================================= #
+  def self.autogenerate_all_relevant_methods(
+      i = ARRAY_TRACKED_PROGRAMS+
+          ARRAY_XORG_COMPONENTS
+    )
+    i.flatten!
+    # ======================================================================= #
+    # Add some aliases which will be defined next.
+    # ======================================================================= #
+    hash_aliases = {
+      atk:   :libatk,   # === EnvironmentInformation.return_version_of_libatk
+      pcre2: :libpcre2, # === EnvironmentInformation.return_version_of_libpcre2
+      pcre:  :libpcre,  # === EnvironmentInformation.return_version_of_libpcre
+      zlib:  :libzlib   # === EnvironmentInformation.return_version_of_libzlib
+    }
+    # ======================================================================= #
+    # Iterate over our Array next:
+    # ======================================================================= #
+    i.each {|this_program|
+      case this_program
+      when :kde
+        this_program = :kde_frameworks
+      end
+      self.class.instance_eval {
+        # =================================================================== #
+        # To test this method, try to do:
+        #
+        #   EnvironmentInformation.return_version_of_valgrind # => "3.15.0"
+        #
+        # =================================================================== #
+        this_method = "return_version_of_#{this_program}"
+        define_method(this_method) {
+          return_version_of_this_program(this_program)
+        }
+        if hash_aliases.has_key?(this_program)
+          # ================================================================= #
+          # To test this, try:
+          #
+          #   EnvironmentInformation.return_version_of_libzlib
+          #
+          # ================================================================= #
+          use_this_as_the_alias_target = "return_version_of_#{hash_aliases[this_program]}"
+          define_method(use_this_as_the_alias_target) {
+            return_version_of_this_program(this_program)
+          }
+        end
+      }
+    }
+  end
+
+  autogenerate_all_relevant_methods # ← And call it at once.
+
+  # ========================================================================= #
+  # And add a few more aliases.
+  # ========================================================================= #
+  self.instance_eval { alias add_xz_information                                         return_version_of_xz }             # === EnvironmentInformation.add_xz_information
+  self.instance_eval { alias append_xz_version                                          return_version_of_xz }             # === EnvironmentInformation.append_xz_version
+  self.instance_eval { alias return_sed_version                                         return_version_of_sed }            # === EnvironmentInformation.return_sed_version
+  self.instance_eval { alias return_version_of_makeinfo                                 return_version_of_texinfo }        # === EnvironmentInformation.return_version_of_makeinfo
+  self.instance_eval { alias xfsprogs?                                                  return_version_of_xfsprogs }       # === EnvironmentInformation.xfsprogs?
+  self.instance_eval { alias add_xfsprogs_information                                   return_version_of_xfsprogs }       # === EnvironmentInformation.add_xfsprogs_information
+  self.instance_eval { alias return_version_of_lftp?                                    return_version_of_lftp }           # === EnvironmentInformation.return_version_of_lftp?
+  self.instance_eval { alias add_llvm_information                                       return_version_of_llvm }           # === EnvironmentInformation.add_llvm_information
+  self.instance_eval { alias append_llvm_version                                        return_version_of_llvm }           # === EnvironmentInformation.append_llvm_version
+  self.instance_eval { alias add_mpc_information                                        return_version_of_mpc }            # === EnvironmentInformation.add_mpc_information
+  self.instance_eval { alias append_mpc_version                                         return_version_of_mpc }            # === EnvironmentInformation.append_mpc_version
+  self.instance_eval { alias try_to_show_re2c_version                                   return_version_of_re2c }           # === EnvironmentInformation.try_to_show_re2c_version
+  self.instance_eval { alias append_re2c_version                                        return_version_of_re2c }           # === EnvironmentInformation.append_nasm_version
+  self.instance_eval { alias return_version_of_pkg_config                               return_version_of_pkgconfig }      # === EnvironmentInformation.return_version_of_pkg_config
+  self.instance_eval { alias add_readline_information                                   return_version_of_readline }       # === EnvironmentInformation.add_readline_information
+  self.instance_eval { alias append_readline_version                                    return_version_of_readline }       # === EnvironmentInformation.add_readline_information
+  self.instance_eval { alias return_version_of_liblibtasn1                              return_version_of_libtasn1 }       # === EnvironmentInformation.return_version_of_liblibtasn1
+  self.instance_eval { alias return_version_of_liblibtasn                               return_version_of_libtasn1 }       # === EnvironmentInformation.return_version_of_liblibtasn
+  self.instance_eval { alias return_version_of_grep?                                    return_version_of_grep }           # === EnvironmentInformation.return_version_of_grep?
+  self.instance_eval { alias return_version_of_intltool?                                return_version_of_intltool }       # === EnvironmentInformation.return_version_of_intltool?
+  self.instance_eval { alias glib?                                                      return_version_of_glib }           # === EnvironmentInformation.glib?
+  self.instance_eval { alias add_gmp_information                                        return_version_of_gmp }            # === EnvironmentInformation.add_gmp_information
+  self.instance_eval { alias append_gmp_version                                         return_version_of_gmp }            # === EnvironmentInformation.append_gmp_version
+  self.instance_eval { alias kernel                                                     return_version_of_linux }          # === EnvironmentInformation.kernel
+  self.instance_eval { alias linux_kernel                                               return_version_of_linux }          # === EnvironmentInformation.linux_kernel
+  self.instance_eval { alias linux_kernel?                                              return_version_of_linux }          # === EnvironmentInformation.linux_kernel?
+  self.instance_eval { alias return_information_about_the_component_called_linux_kernel return_version_of_linux }          # === EnvironmentInformation.return_information_about_the_component_called_linux_kernel
+  self.instance_eval { alias append_kernel_version                                      return_version_of_linux }          # === EnvironmentInformation.append_kernel_version
+  self.instance_eval { alias add_kernel_information                                     return_version_of_linux }          # === EnvironmentInformation.add_kernel_information
+  self.instance_eval { alias return_version_of_linux_kernel                             return_version_of_linux }          # === EnvironmentInformation.return_version_of_linux_kernel
+  self.instance_eval { alias return_version_of_linux_kernel?                            return_version_of_linux }          # === EnvironmentInformation.return_version_of_linux_kernel?
+  self.instance_eval { alias boost?                                                     return_version_of_boost }          # === EnvironmentInformation.boost?
+  self.instance_eval { alias return_version_of_boost?                                   return_version_of_boost }          # === EnvironmentInformation.return_version_of_boost?
+  self.instance_eval { alias return_version_of_find                                     return_version_of_findutils }      # === EnvironmentInformation.return_version_of_find
+  self.instance_eval { alias findutils?                                                 return_version_of_findutils }      # === EnvironmentInformation.findutils?
+  self.instance_eval { alias awk?                                                       return_version_of_gawk }           # === EnvironmentInformation.awk?
+  self.instance_eval { alias gawk?                                                      return_version_of_gawk }           # === EnvironmentInformation.gawk?
+  self.instance_eval { alias return_information_about_the_component_called_awk          return_version_of_gawk }           # === EnvironmentInformation.return_information_about_the_component_called_awk
+  self.instance_eval { alias return_version_of_awk?                                     return_version_of_gawk }           # === EnvironmentInformation.return_version_of_awk?
+  self.instance_eval { alias return_version_of_awk                                      return_version_of_gawk }           # === EnvironmentInformation.return_version_of_awk
+  self.instance_eval { alias append_gdkpixbuf_version                                   return_version_of_gdkpixbuf }      # === EnvironmentInformation.append_gdkpixbuf_version
+  self.instance_eval { alias glibc?                                                     return_version_of_glibc }          # === EnvironmentInformation.glibc?
+  self.instance_eval { alias glibc_version?                                             return_version_of_glibc }          # === EnvironmentInformation.glibc_version?
+  self.instance_eval { alias return_version_of_glibc?                                   return_version_of_glibc }          # === EnvironmentInformation.return_version_of_glibc?
+  self.instance_eval { alias ruby?                                                      return_version_of_ruby }           # === EnvironmentInformation.ruby?
+  self.instance_eval { alias return_information_about_the_component_called_ruby         return_version_of_ruby }           # === EnvironmentInformation.return_information_about_the_component_called_ruby
+  self.instance_eval { alias return_version_of_ruby?                                    return_version_of_ruby }           # === EnvironmentInformation.return_version_of_ruby?
+  self.instance_eval { alias binutils?                                                  return_version_of_binutils }       # === EnvironmentInformation.binutils?
+  self.instance_eval { alias return_version_of_binutils?                                return_version_of_binutils }       # === EnvironmentInformation.return_version_of_binutils?
+  self.instance_eval { alias bison?                                                     return_version_of_bison }          # === EnvironmentInformation.bison?
+  self.instance_eval { alias return_version_of_bison?                                   return_version_of_bison }          # === EnvironmentInformation.return_version_of_bison?
+  self.instance_eval { alias return_version_of_flex?                                    return_version_of_flex }           # === EnvironmentInformation.return_version_of_flex?
+  self.instance_eval { alias return_version_of_freetype2                                return_version_of_freetype }       # === EnvironmentInformation.return_version_of_freetype2
+  self.instance_eval { alias evince?                                                    return_version_of_evince }         # === EnvironmentInformation.evince?
+  self.instance_eval { alias return_version_of_evince?                                  return_version_of_evince }         # === EnvironmentInformation.return_version_of_evince?
+  self.instance_eval { alias gcc?                                                       return_version_of_gcc }            # === EnvironmentInformation.gcc?
+  self.instance_eval { alias return_information_about_the_component_called_gcc          return_version_of_gcc }            # === EnvironmentInformation.return_information_about_the_component_called_gcc
+  self.instance_eval { alias return_version_of_gcc?                                     return_version_of_gcc }            # === EnvironmentInformation.return_version_of_gcc?
+  self.instance_eval { alias return_version_of_R                                        return_version_of_r }              # === EnvironmentInformation.return_version_of_R
+  self.instance_eval { alias coreutils?                                                 return_version_of_coreutils }      # === EnvironmentInformation.coreutils?
+  self.instance_eval { alias return_version_of_coreutils?                               return_version_of_coreutils }      # === EnvironmentInformation.return_version_of_coreutils
+  self.instance_eval { alias return_version_of_diffutils?                               return_version_of_diffutils }      # === EnvironmentInformation.return_version_of_diffutils?
+  self.instance_eval { alias return_version_of_libexempi                                return_version_of_exempi }         # === EnvironmentInformation.return_version_of_libexempi
+  self.instance_eval { alias return_version_of_gpg                                      return_version_of_gnupg }          # === EnvironmentInformation.return_version_of_gpg
+  self.instance_eval { alias return_version_of_gnupg?                                   return_version_of_gnupg }          # === EnvironmentInformation.return_version_of_gnupg?
+  self.instance_eval { alias return_version_of_bzip                                     return_version_of_bzip2 }          # === EnvironmentInformation.return_version_of_bzip
+  self.instance_eval { alias return_version_of_llvm                                     return_version_of_clang }          # === EnvironmentInformation.return_version_of_llvm
+  self.instance_eval { alias return_clang_version                                       return_version_of_clang }          # === EnvironmentInformation.return_clang_version
+  self.instance_eval { alias kde5?                                                      return_version_of_kde_frameworks } # === EnvironmentInformation.kde5?
+  self.instance_eval { alias add_kde5_information                                       return_version_of_kde_frameworks } # === EnvironmentInformation.add_kde5_information
+  self.instance_eval { alias add_kde_information                                        return_version_of_kde_frameworks } # === EnvironmentInformation.add_kde_information
+  self.instance_eval { alias return_information_about_the_component_called_rubygems     return_version_of_rubygems }       # === EnvironmentInformation.return_information_about_the_component_called_rubygems
+  self.instance_eval { alias rubygems?                                                  return_version_of_rubygems }       # === EnvironmentInformation.rubygems?
+  self.instance_eval { alias return_version_of_rubygems?                                return_version_of_rubygems }       # === EnvironmentInformation.return_version_of_rubygems?
+  self.instance_eval { alias gtk3?                                                      return_version_of_gtk3 }           # === EnvironmentInformation.gtk3?
+  self.instance_eval { alias gtk2?                                                      return_version_of_gtk2 }           # === EnvironmentInformation.gtk2?
+
+end

data/lib/environment_information/toplevel_methods/cd.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/toplevel_methods/cd.rb'
+# =========================================================================== #
+module EnvironmentInformation
+
+  # ========================================================================= #
+  # === EnvironmentInformation.cd                                    (cd tag)
+  # ========================================================================= #
+  def self.cd(i)
+    Dir.chdir(i) if File.directory? i
+  end
+
+end

data/lib/environment_information/toplevel_methods/e.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/toplevel_methods/e.rb'
+# EnvironmentInformation.e
+# =========================================================================== #
+module EnvironmentInformation
+
+  # ========================================================================= #
+  # === EnvironmentInformation.e
+  # ========================================================================= #
+  def self.e(
+      i = '', hash = {}
+    )
+    if hash and
+       hash.has_key?(:display_everything_in_short_format) and
+       hash[:display_everything_in_short_format]
+      # ===================================================================== #
+      # Display the results in a single line in this case.
+      # ===================================================================== #
+      print "#{i}, "
+    else
+      puts i
+    end
+  end
+
+  # ========================================================================= #
+  # === EnvironmentInformation.ee
+  #
+  # This is simply a wrapper over print, as well as adding a ', ' to that.
+  # ========================================================================= #
+  def self.ee(
+      i = ''
+    )
+    print "#{i}, "
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  EnvironmentInformation.e('Hello world!')
+end

data/lib/environment_information/toplevel_methods/hash.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/toplevel_methods/hash.rb'
+# EnvironmentInformation.hash?
+# =========================================================================== #
+module EnvironmentInformation
+
+  require 'environment_information/toplevel_methods/register_this_component_is_missing.rb'
+
+  # ========================================================================= #
+  # === @hash_available_programs
+  #
+  # This hash stores the available programs.
+  #
+  # We need to use a Hash, rather than an Array, because we may save
+  # the result into a file, such as a yaml file. It is then more
+  # convenient to have the names of the program appear on the left
+  # side directoy, and the version on the right side.
+  #
+  # This Hash will hold the program name on the left side, and the
+  # program version on the right side. A nil value on the right
+  # side indicates that this program is NOT installed - which
+  # makes this the default value.
+  # ========================================================================= #
+  @hash_available_programs = {}
+
+  # ========================================================================= #
+  # === EnvironmentInformation.hash?
+  #
+  # This method will return the Hash of all available programs.
+  # ========================================================================= #
+  def self.hash?
+    @hash_available_programs
+  end; self.instance_eval { alias hash     hash? } # === EnvironmentInformation.hash
+       self.instance_eval { alias dataset? hash? } # === EnvironmentInformation.dataset?
+
+  # ========================================================================= #
+  # === EnvironmentInformation.add_to_hash
+  # ========================================================================= #
+  def self.add_to_hash(a, b)
+    b.strip! if b.is_a? String
+    if b.nil?
+      ::EnvironmentInformation.register_this_component_is_missing(a)
+    end
+    @hash_available_programs[a] = b
+  end
+
+  # ========================================================================= #
+  # === EnvironmentInformation.clear_hash
+  #
+  # This method can be used to clear the main (toplevel) Hash.
+  # ========================================================================= #
+  def self.clear_hash
+    @hash_available_programs.clear
+  end; self.instance_eval { alias clear_toplevel_hash clear_hash } # === EnvironmentInformation.clear_toplevel_hash
+       self.instance_eval { alias clear_main_hash     clear_hash } # === EnvironmentInformation.clear_main_hash
+
+end

data/lib/environment_information/toplevel_methods/internet_is_available.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/toplevel_methods/internet_is_available.rb'
+# =========================================================================== #
+module EnvironmentInformation
+
+  # ========================================================================= #
+  # === EnvironmentInformation.internet_is_available?
+  # ========================================================================= #
+  def self.internet_is_available?
+    require 'resolv'
+    dns_resolver = Resolv::DNS.new
+    begin
+      # ===================================================================== #
+      # The first domain name ever. Will probably not be removed.
+      # ===================================================================== #
+      dns_resolver.getaddress('symbolics.com')
+      return true
+    rescue Resolv::ResolvError => _error
+      return false
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts EnvironmentInformation.internet_is_available?
+end

data/lib/environment_information/toplevel_methods/is_on_roebe.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'environment_information/toplevel_methods/is_on_roebe.rb'
+# =========================================================================== #
+module EnvironmentInformation
+
+  # ========================================================================= #
+  # === EnvironmentInformation.is_on_roebe?
+  # ========================================================================= #
+  def self.is_on_roebe?
+    ENV['IS_ROEBE'].to_i == 1
+  end
+
+end