environment_information 1.4.124 → 1.5.5

data/lib/environment_information/toplevel_methods/return_remote_gtk2_version.rb

@@ -1,54 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'environment_information/toplevel_methods/return_remote_gtk2_version.rb'
-# EnvironmentInformation.return_remote_gtk2_version
-# =========================================================================== #
-module EnvironmentInformation
-
-  require 'environment_information/toplevel_methods/internet_is_available.rb'
-
-  # ========================================================================= #
-  # === EnvironmentInformation.return_remote_gtk2_version
-  #
-  # This method can be used to obtain the latest gtk2-version, from a
-  # remote URL.
-  #
-  # The reason why this was necessary is because the RBT project may not
-  # always keep the latest gtk2 version, since gtk3 (and so forth) is more
-  # recent. Since we may still have to find out which gtk2 version is the
-  # most recent, we need a method to do so - which is precisely what this
-  # method here is doing.
-  # ========================================================================= #
-  def self.return_remote_gtk2_version
-    # ======================================================================= #
-    # We will use a hardcoded URL pointing towards gtk2:
-    # ======================================================================= #
-    remote_url = 'https://ftp.gnome.org/pub/GNOME/sources/gtk+/2.24/?C=M;O=D'
-    require 'open-uri'
-    newest_version = ''
-    # ======================================================================= #
-    # We will next try to obtain the remote dataset, but this would
-    # fail if we have no www-connection, so we must rescue this step.
-    # ======================================================================= #
-    if internet_is_available?
-      begin
-        dataset = URI.open(remote_url).read
-        use_this_regex =
-          /<a href="gtk\+\-(\d.\d\d.\d\d).tar.xz"><img src=/
-        scanned = dataset.scan(use_this_regex).flatten
-        newest_version = scanned.first
-      rescue SocketError => error
-        puts "It seems as if we have no working internet "\
-             "connection (#{sfancy(error.class)})"
-      end
-    end
-    return newest_version.strip # ← And return it here.
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  puts EnvironmentInformation.return_remote_gtk2_version
-end

data/lib/environment_information/toplevel_methods/return_simple_version_based_programs.rb

@@ -1,28 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'environment_information/toplevel_methods/return_simple_version_based_programs.rb'
-# =========================================================================== #
-module EnvironmentInformation
-
-  require 'environment_information/constants/file_constants.rb'
-
-  # ========================================================================= #
-  # === EnvironmentInformation.return_simple_version_based_programs
-  # ========================================================================= #
-  def self.return_simple_version_based_programs
-    dataset = YAML.load_file(file_query_to_use_for_the_individual_components)
-    dataset.select {|key, value|
-      # ===================================================================== #
-      # The next query will select only for :version entries.
-      # ===================================================================== #
-      value == :version
-    }.keys
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  pp EnvironmentInformation.return_simple_version_based_programs
-end

data/lib/environment_information/toplevel_methods/return_version_of_this_program.rb

@@ -1,182 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'environment_information/toplevel_methods/return_version_of_this_program.rb'
-# EnvironmentInformation.return_version_of_this_program
-# =========================================================================== #
-module EnvironmentInformation
-
-  require 'yaml'
-  require 'environment_information/colours/colours.rb'
-  require 'environment_information/constants/array_tracked_components.rb'
-  require 'environment_information/constants/error_line.rb'
-  require 'environment_information/constants/misc.rb'
-  require 'environment_information/constants/newline.rb'
-  require 'environment_information/toplevel_methods/e.rb'
-  require 'environment_information/toplevel_methods/prefix_to_use.rb'
-  require 'environment_information/toplevel_methods/return_alias_to.rb'
-  require 'environment_information/requires/require_the_individual_misc_components.rb'
-  require 'environment_information/queries/pkg_config.rb'
-  require 'environment_information/queries/simple_version.rb'
-  require 'environment_information/queries/complex_version.rb'
-
-  begin
-    require 'rbt/utility_scripts/report_mate_desktop_version.rb'
-  rescue LoadError; end
-
-  # ========================================================================= #
-  # === @debug
-  #
-  # This variable can be used to control whether we debug the project
-  # or not. It should be false by default (and upon re-destribution of
-  # the project to other users).
-  # ========================================================================= #
-  @debug = false
-
-  # ========================================================================= #
-  # === @query_to_use_for_the_individual_components
-  #
-  # Initialize our dataset here.
-  # ========================================================================= #
-  @query_to_use_for_the_individual_components = YAML.load_file(
-    FILE_QUERY_TO_USE_FOR_THE_INDIVIDUAL_COMPONENTS
-  )
-
-  # ========================================================================= #
-  # === EnvironmentInformation.return_version_of_this_program
-  #
-  # This is the general method that will return the version of a particular
-  # program at hand.
-  #
-  # The method must be able to deal with using pkg-config, but also
-  # querying some program's version via --version, via the commandline,
-  # Furthermore, some programs may require an ad-hoc fix.
-  # ========================================================================= #
-  def self.return_version_of_this_program(
-      this_program,
-      prefix_to_use = @prefix_to_use
-    )
-    prefix_to_use = prefix_to_use.dup if prefix_to_use
-    version = nil # ← This is the default.
-    if this_program.is_a? Array
-      this_program = this_program.flatten.first
-    end
-    # ======================================================================= #
-    # Next define a few aliases.
-    # ======================================================================= #
-    this_program = ::EnvironmentInformation.return_alias_to(this_program)
-    if ARRAY_TRACKED_NON_PROGRAMS.include? this_program
-      return ::EnvironmentInformation.send(this_program)
-    elsif @query_to_use_for_the_individual_components.has_key? this_program.to_sym
-      use_this_command = @query_to_use_for_the_individual_components[this_program.to_sym]
-      case use_this_command
-      # ===================================================================== #
-      # === :mate_desktop
-      #
-      # This entry is special.
-      # ===================================================================== #
-      when :mate_desktop
-        return RBT.return_mate_desktop_version_array
-      # ===================================================================== #
-      # === :pkgconfig
-      #
-      # An invocation example for this would be:
-      #
-      #   x = EnvironmentInformation.return_version_of_this_program(:check) # => "0.15.2"
-      #
-      # ===================================================================== #
-      when :pkgconfig
-        version = ::EnvironmentInformation::Queries::PkgConfig.new(this_program).version?
-      # ===================================================================== #
-      # === :custom_gtk2
-      # ===================================================================== #
-      when :custom_gtk2
-        version = ::EnvironmentInformation::Queries::PkgConfig.new('gtk+-2.0').version?
-      # ===================================================================== #
-      # === :custom_mpc
-      #
-      # We rely on the header called mpc.h.
-      # ===================================================================== #
-      when :custom_mpc
-        version = ::EnvironmentInformation.return_version_of_mpc
-      # ===================================================================== #
-      # === :custom_boost
-      # ===================================================================== #
-      when :custom_boost
-        version = ::EnvironmentInformation.return_version_of_boost
-        if version.nil?
-          register_this_component_is_missing(:boost)
-        end
-      # ===================================================================== #
-      # === :version                                            (version tag)
-      #
-      # This entry point is typically for "program_name --version"
-      # entries. Some of them require custom modifications.
-      # ===================================================================== #
-      when :version
-        # =================================================================== #
-        # Next enable support for AppDir layout, where programs will
-        # ultimately reside in the same directory.
-        # =================================================================== #
-        unless prefix_to_use.empty?
-          prefix_to_use << "#{this_program.to_s.capitalize}/Current/bin/"
-        end
-        cmd = "#{prefix_to_use}#{this_program} --version #{ERROR_LINE}"
-        if @debug
-          e Colours.crimson('DEBUG for the prefix-value in use: ')+
-            Colours.steelblue(cmd)
-        end
-        version = ::EnvironmentInformation::Queries::SimpleVersion.new(this_program) {{
-          prefix_to_use: prefix_to_use
-        }}.version?
-      # ===================================================================== #
-      # Next we will handle special programs, such as "swig -v" and similar.
-      # This is done by class ComplexVersion since as of 29.08.2020.
-      # ===================================================================== #
-      else # else tag
-        if use_this_command.start_with?('pkg-config')
-          version = ::EnvironmentInformation::Queries::PkgConfig.new(this_program).version?
-        else
-          cmd = "#{@prefix_to_use}#{use_this_command} #{ERROR_LINE}"
-          version = ::EnvironmentInformation::Queries::ComplexVersion.new(this_program) {{
-            prefix_to_use: prefix_to_use
-          }}.version?
-        end
-      end
-    else
-      e 'Not registered any key for the program: '+this_program.to_s
-      e 'This is currently not allowed - please add this missing information.'
-      exit
-    end
-    result = version
-    if result
-      unless result.include? COMMAND_NOT_FOUND
-        result = result.dup if result.frozen?
-        result.strip!
-      end
-    end
-    if result and (result == 'found' or result == 'foud')
-      register_this_component_is_missing(this_program)
-    elsif result and result.include?(COMMAND_NOT_FOUND)
-      register_this_component_is_missing(this_program)
-    # ======================================================================= #
-    # Check whether pkg-config is available or not.
-    # ======================================================================= #
-    elsif result and (
-            result.include?(PKGCONFIG_COMMAND_NOT_FOUND) or
-            result.include?(NO_SUCH_FILE_OR_DIRECTORY)
-          )
-      register_this_component_is_missing(this_program)
-    elsif result.nil?
-      register_this_component_is_missing(this_program)
-    end
-    return result
-  end; self.instance_eval { alias version_for? return_version_of_this_program } # === EnvironmentInformation,version_for?
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  puts EnvironmentInformation.return_version_of_this_program(ARGV)
-end # envireturnversionofthisprogram ruby
-    # envireturnversionofthisprogram ethtools

data/lib/environment_information/toplevel_methods/show_all_available_components.rb

@@ -1,192 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'environment_information/toplevel_methods/show_all_available_components.rb'
-# EnvironmentInformation.show_all_available_components
-# =========================================================================== #
-module EnvironmentInformation
-
-  # ========================================================================= #
-  # The next require also pulls in the misc/ components.
-  # ========================================================================= #
-  require 'environment_information/toplevel_methods/return_version_of_this_program.rb'
-  require 'environment_information/constants/array_tracked_components.rb'
-  require 'environment_information/constants/regex.rb'
-  require 'environment_information/toplevel_methods/hash.rb'
-  require 'environment_information/toplevel_methods/autogenerate_all_relevant_methods.rb'
-  require 'environment_information/toplevel_methods/misc.rb'
-  require 'environment_information/toplevel_methods/replay_from_the_stored_file.rb'
-
-  begin
-    require 'rbt/requires/swift_version.rb'
-  rescue LoadError; end
-
-  # ========================================================================= #
-  # Add colours-support next:
-  # ========================================================================= #
-  require 'environment_information/colours/colours.rb'
-  require 'environment_information/queries/pkg_config.rb'
-  require 'environment_information/toplevel_methods/e.rb'
-  require 'environment_information/toplevel_methods/is_on_roebe.rb'
-  require 'environment_information/toplevel_methods/register_this_component_is_missing.rb'
-
-  # ========================================================================= #
-  # === EnvironmentInformation.show_all_available_components
-  #
-  # This method will quickly and easily show all available (registered)
-  # components. If you need more fine-tuning when you wish to display
-  # the main dataset at hand, then you should use other methods that
-  # are also a bit more complex. This method here is really just a
-  # fast version-display overview.
-  #
-  # The second argument to this method contains the programs that we
-  # wish to display through this method.
-  # ========================================================================= #
-  def self.show_all_available_components(
-      n_ljust               = 18,
-      show_these_components = ARRAY_DEFAULT_PROGRAMS_ON_LINUX+
-                              ARRAY_TRACKED_PROGRAMS,
-      use_colours           = use_colours?
-    )
-    clear_main_hash
-    if show_these_components.is_a? Array
-      show_these_components.flatten!
-    end
-    # ======================================================================= #
-    # The next variable determines whether we will also compare the
-    # program versions.
-    # ======================================================================= #
-    compare_program_versions = false
-    default_nljust_value = 30 # ← Detemine default padding.
-    if n_ljust.is_a?(Array) and n_ljust.empty?
-      n_ljust = default_nljust_value # Use the default value in this case.
-    end
-    # ======================================================================= #
-    # First we will treat n_ljust as a commandline-flag if it is a String
-    # and additionally begins with "--".
-    # ======================================================================= #
-    if n_ljust.is_a?(Array) and n_ljust.first.start_with?('--')
-      _ = n_ljust.first
-      case _
-      # ===================================================================== #
-      # === --help
-      #
-      # Invocation example:
-      #
-      #   showcomponents --help
-      #
-      # ===================================================================== #
-      when /^-?-?help$/i
-        e 'The following options are available for bin/fast_envi (fenvi):'
-        e
-        e '   --xorg                        # show only the xorg-components'
-        e '   --compare-to-program-versions # also compare the program versions'
-        e
-        exit
-      # ===================================================================== #
-      # === --compare-to-program-versions
-      #
-      # To invoke this, try:
-      #
-      #   show_components --compare
-      #   envi --compare-version
-      #
-      # ===================================================================== #
-      when *ARRAY_COMPARE_PROGRAM_VERSIONS
-        compare_program_versions = true
-        n_ljust = default_nljust_value
-      # ===================================================================== #
-      # === --xorg
-      # ===================================================================== #
-      when /^-?-?xorg$/i
-        show_these_components = ::EnvironmentInformation.xorg_components?
-        n_ljust = default_nljust_value
-      end
-    end
-    e
-    uniq = show_these_components.uniq
-    uniq.sort.each {|this_program|
-      use_this_name_for_send = "return_version_of_#{this_program}"
-      # ===================================================================== #
-      # Next, add the name of the program at hand, onto the left hand side:
-      # ===================================================================== #
-      result = this_program.to_s.ljust(n_ljust)
-      if use_colours
-        result = ::EnvironmentInformation.colourize_and_pad_the_left_side(result)
-      end
-      # ===================================================================== #
-      # Some components may not be installed on the user's computer system,
-      # which we have to keep in mind in the following code. This is
-      # why we will first apply the .send(), before checking whether
-      # the program at hand is actually missing or not.
-      # ===================================================================== #
-      result_of_send = send(use_this_name_for_send)
-      if result_of_send
-        result_of_send = result_of_send.dup if result_of_send.frozen?
-        result_of_send.strip!
-      end
-      @hash_available_programs[this_program.to_sym] = result_of_send.to_s
-      right_component = ''.dup
-      if @array_this_component_is_missing.include?(this_program.to_sym)
-        right_component << "not installed (or otherwise not found)".ljust(12)
-      else
-        right_component << result_of_send.ljust(12) if result_of_send
-      end
-      if use_colours
-        # =================================================================== #
-        # We will distinguish between components that have been found and
-        # components that have not been found.
-        # =================================================================== #
-        if right_component.include?('not installed')
-          right_component = ::Colours.send(:mediumslateblue, right_component)
-        else
-          right_component = ::Colours.send(colour_for_the_right_side, right_component)
-        end
-      end
-      result = result.dup if result.frozen?
-      result << right_component
-      if compare_program_versions
-        if is_this_program_included?(this_program)
-          registered_local_version = RBT.swift_return_version_of_this_program(this_program.to_sym).to_s.dup
-          if registered_local_version.include? 'v'
-            # =============================================================== #
-            # Modify entries such as 'v12.15.0' into '12.15.0'.
-            # =============================================================== #
-            registered_local_version.delete!('v')
-          end
-          case this_program.to_s
-          when 'gtk2'
-            registered_local_version = query_pkgconfig_version_for(:gtk2)
-          else
-            if result_of_send.nil?
-              # ^^^ This is missing, then, so it will be ignored.
-            elsif registered_local_version <= result_of_send 
-              # This is ok.
-            else
-              result << 
-                royalblue(
-                  "\n    "\
-                  "^^^ This could be updated; the version in "\
-                  "RBT is: #{mediumpurple(registered_local_version)}"
-                )
-            end
-          end
-        end
-      end
-      # ===================================================================== #
-      # Finally display our findings to the end user.
-      # ===================================================================== #
-      e result
-    }
-    e
-    if is_on_roebe? # And store it on my home system too.
-      ::EnvironmentInformation.store_relevant_files
-    end
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  EnvironmentInformation.show_all_available_components(ARGV)
-end # showcomponents --compare

data/lib/environment_information/toplevel_methods/write_what_into.rb

@@ -1,24 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'environment_information/toplevel_methods/write_what_into.rb'
-# EnvironmentInformation.write_what_into
-# =========================================================================== #
-module EnvironmentInformation
-
-  require 'environment_information/toplevel_methods/e.rb'
-
-  # ========================================================================= #
-  # === EnvironmentInformation.write_what_into
-  # ========================================================================= #
-  def self.write_what_into(what, into)
-    what = what.join("\n") if what.is_a? Array
-    File.open(into, 'w+') {|entry| entry.write(what) }
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  EnvironmentInformation.write_what_into(ARGV, 'test_this.md')
-end

data/lib/environment_information/yaml/array_default_programs_on_linux.yml

@@ -1,15 +0,0 @@
-# =========================================================================== #
-# x = YAML.load_file('array_default_programs_on_linux.yml')
-# =========================================================================== #
-
-- !ruby/symbol operating_system
-- !ruby/symbol operating_system_bit_type
-- !ruby/symbol cpuinfo
-- !ruby/symbol ram
-- !ruby/symbol screen_resolution
-- !ruby/symbol cflags
-- !ruby/symbol gcc
-- !ruby/symbol glibc
-- !ruby/symbol linux
-- !ruby/symbol binutils
-- !ruby/symbol cmake

data/lib/environment_information/yaml/array_lfs_core_programs.yml

@@ -1,37 +0,0 @@
-# =========================================================================== #
-# === array_lfs_core_programs.yml
-#
-# This .yml file will contain an Array of Symbols denoting which programs
-# are tracked by the LFS project.
-#
-# If you wish to add new entries to this yaml file then please keep them
-# sorted alphabetically - this makes things a bit easier in the long run.
-# =========================================================================== #
-# x = YAML.load_file(FILE_ARRAY_LFS_CORE_PROGRAMS)
-# =========================================================================== #
-
-- !ruby/symbol bash
-- !ruby/symbol binutils
-- !ruby/symbol bison
-- !ruby/symbol busybox
-- !ruby/symbol bzip2
-- !ruby/symbol coreutils
-- !ruby/symbol diffutils
-- !ruby/symbol findutils
-- !ruby/symbol flex
-- !ruby/symbol gawk
-- !ruby/symbol gcc
-- !ruby/symbol grep
-- !ruby/symbol gzip
-- !ruby/symbol libuv
-- !ruby/symbol linux
-- !ruby/symbol m4
-- !ruby/symbol make
-- !ruby/symbol patch
-- !ruby/symbol perl
-- !ruby/symbol python
-- !ruby/symbol sed
-- !ruby/symbol tar
-- !ruby/symbol texinfo
-- !ruby/symbol xz
-- !ruby/symbol zlib

data/lib/environment_information/yaml/array_science_cluster.yml

@@ -1,12 +0,0 @@
-# =========================================================================== #
-# Applications that have to do with science may be stored in this yaml
-# file here.
-# =========================================================================== #
-# x = YAML.load_file(FILE_ARRAY_SCIENCE_CLUSTER)
-# =========================================================================== #
-
-- !ruby/symbol hmmer
-- !ruby/symbol pbbam
-- !ruby/symbol relion
-- !ruby/symbol samtools
-- !ruby/symbol viennarna

data/lib/environment_information/yaml/array_tracked_non_programs.yml

@@ -1,13 +0,0 @@
-# =========================================================================== #
-# Please keep the following Array (of symbols) sorted alphabeticall.
-# =========================================================================== #
-# x = EnvironmentInformation.load_file_array_tracked_non_programs
-# =========================================================================== #
-
-- !ruby/symbol cflags
-- !ruby/symbol cpuinfo
-- !ruby/symbol operating_system
-- !ruby/symbol operating_system_bit_type
-- !ruby/symbol ram
-- !ruby/symbol rubygems_installation_directory
-- !ruby/symbol screen_resolution

data/lib/environment_information/yaml/array_tracked_xorg_components.yml

@@ -1,37 +0,0 @@
-# =========================================================================== #
-# === array_tracked_xorg_components.yml
-#
-# This .yml file will contain an Array of Symbols denoting which
-# programs belong to the xorg-stack.
-# =========================================================================== #
-# x = YAML.load_file(FILE_ARRAY_TRACKED_XORG_COMPONENTS)
-# =========================================================================== #
-
-- !ruby/symbol libevdev
-- !ruby/symbol libinput
-- !ruby/symbol libx11
-- !ruby/symbol libxaw3d
-- !ruby/symbol libxau
-- !ruby/symbol libxcb
-- !ruby/symbol libxcm
-- !ruby/symbol libxcursor
-- !ruby/symbol libxdamage
-- !ruby/symbol libxi
-- !ruby/symbol libxkbfile
-- !ruby/symbol libxmu
-- !ruby/symbol libxpm
-# - !ruby/symbol libxp # This one no longer appears to work as of 2023.
-- !ruby/symbol libxpresent
-# - !ruby/symbol libxtrap # This has been deprecated many years ago already.
-- !ruby/symbol libxtst
-- !ruby/symbol libxt
-- !ruby/symbol libxv
-- !ruby/symbol libxvmc
-- !ruby/symbol randrproto
-- !ruby/symbol xextproto
-- !ruby/symbol xkbcomp
-- !ruby/symbol xrandr
-- !ruby/symbol xstdcmap
-- !ruby/symbol xf86bigfontproto
-- !ruby/symbol xf86dgaproto
-- !ruby/symbol xf86driproto