environment_information 1.4.29

data/lib/environment_information/queries/complex_version.rb

@@ -0,0 +1,263 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === EnvironmentInformation::Queries::ComplexVersion
+#
+# This class will try to do a query based on more complex means.
+# =========================================================================== #
+# require 'environment_information/queries/simple_version.rb'
+# EnvironmentInformation::Queries::ComplexVersion.new
+# =========================================================================== #
+require 'environment_information/base/base.rb'
+
+module EnvironmentInformation
+
+module Queries
+
+class ComplexVersion < ::EnvironmentInformation::Base # === EnvironmentInformation::Queries::ComplexVersion
+
+  # ========================================================================= #
+  # === 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?
+
+  # ========================================================================= #
+  # === 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)
+      cmd_to_run = _[this_program]
+      case cmd_to_run
+      # ===================================================================== #
+      # === :custom_busybox
+      # ===================================================================== #
+      when :custom_busybox
+        @program_version = ::EnvironmentInformation.return_version_of_busybox
+      # ===================================================================== #
+      # === :custom_xvid
+      # ===================================================================== #
+      when :custom_xvid
+        @program_version = ::EnvironmentInformation.return_version_of_xvid
+      # ===================================================================== #
+      # === :custom_boost
+      # ===================================================================== #
+      when :custom_boost
+        @program_version = ::EnvironmentInformation.return_version_of_boost
+      # ===================================================================== #
+      # === :custom_mpc
+      # ===================================================================== #
+      when :custom_mpc
+        @program_version = ::EnvironmentInformation.return_version_of_mpc
+      else
+        result = `#{@prefix_to_use}#{cmd_to_run} #{ERROR_LINE}`.to_s.strip.dup
+        if result.include? ' #' # Handle "uname -a" aka Linux darkstar.example.net 5.4.50 #1 SMP
+          result = result.split(' #').first.strip 
+        end
+        @program_version = result
+      end
+      return nil if @program_version.nil?
+      if @program_version.include? '# HMMER ' # <- Specifically for "hammer".
+        @program_version = @program_version.scan(
+          /# HMMER (\d{0,2}\.\d{0,2}\.\d{0,2})/
+        ).flatten.first.to_s
+      end
+      if @program_version.include? 'extracts blocks from damag' # bzip2recover
+        @program_version = @program_version.scan(
+          /bzip2recover (\d{0,2}\.\d{0,2}\.\d{0,2}): extracts blocks from damaged .bz2 files/
+        ).flatten.first.to_s.dup
+      end
+      # ===================================================================== #
+      # === Handle Imagemagick: 'Version: ImageMagick 7.0.10-28'
+      # ===================================================================== #
+      if @program_version.include? 'Version: ImageMagick '
+        @program_version = @program_version.scan(
+          /Version: ImageMagick (\d{0,2}\.\d{0,2}\.\d{0,2}-\d{0,2})/
+        ).flatten.first.to_s.tr('-','.')
+      end
+      # ===================================================================== #
+      # === Handle 'KDE Frameworks: 5.73.0'
+      # ===================================================================== #
+      if @program_version.include? 'KDE Frameworks: '
+        @program_version = @program_version.scan(
+          /KDE Frameworks: (\d{0,2}\.\d{0,2}\.\d{0,2})/
+        ).flatten.first.to_s
+      end
+      # ===================================================================== #
+      # === Handle 'ncurses 6.2.20200212' aka ncurses
+      # ===================================================================== #
+      if @program_version.include? 'ncurses '
+        @program_version = @program_version.scan(
+          /ncurses (\d{1,1}\.\d{1,1})/
+        ).flatten.first.to_s
+      end
+      # ===================================================================== #
+      # === Handle ruby 'ruby 2.7.1p83 (2020-03-31 revision a0c7c23c9c) [x86_64-linux]'
+      # ===================================================================== #
+      if @program_version.include? 'ruby '
+        @program_version = @program_version.scan(
+          /^ruby (\d{1,1}\.\d{1,1}\.\d{1,1})/
+        ).flatten.first.to_s
+      end
+      # ===================================================================== #
+      # === Handle patchelf '0.12.20200827.8d3a16e'
+      # ===================================================================== #
+      if @program_version.include? 'patchelf '
+        @program_version = @program_version.scan(
+          /^patchelf (\d{1,1}\.\d{1,2})/
+        ).flatten.first.to_s
+      end
+      # ===================================================================== #
+      # We have to be careful with the next, as a few programs report the
+      # version on the second line, not on the first.
+      # ===================================================================== #
+      if @program_version.include? N
+        @program_version = @program_version.split(N).first.strip
+      end
+      # ===================================================================== #
+      # Next handle cases such as the following two examples:
+      #
+      #   "ffmpeg version 4.3.1 Copyright (c) 2000-2020 the FFmpeg developers"
+      #   "openjdk version \"14.0.2\" 2020-07-14"
+      #
+      # ===================================================================== #
+      if @program_version.include? ' version '
+        @program_version = @program_version.scan(
+          / version "?(\d{0,2}\.\d{1,2}\.?\d{0,2})"?/
+        ).flatten.first.to_s.strip
+      end
+      # ===================================================================== #
+      # Handle cases such as: "nginx/1.18.0"
+      # ===================================================================== #
+      if @program_version.include? '/'
+        @program_version = @program_version.split('/').last.strip
+      end
+      if @program_version.include?('(') and # Specifically for XTERM.
+         @program_version.include?(')')
+        @program_version = @program_version.split('(').last.to_s.delete(')') # 7.7.0(359)
+      end
+      if @program_version.include? '-'
+        # Specifically to fix relion: "3.1.0-commit-GITDIR"
+        @program_version = @program_version.split('-').first.to_s.strip
+      end
+      if @program_version.include? COMMAND_NOT_FOUND
+        @program_version = nil
+      elsif @program_version.include? ' '
+        # =================================================================== #
+        # Assume input such as: "GNU ld (GNU Binutils) 2.35"
+        # =================================================================== #
+        @program_version = @program_version.split(' ').last
+      end
+    end
+    return @program_version
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    return_version_of
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  array = %i(
+    mpc
+    gtk2
+    linux
+    binutils
+    boost
+    coreutils
+    diffutils
+    ffmpeg
+    findutils
+    java
+    imagemagick
+    kde_frameworks
+    llvm
+    ncurses
+    nginx
+    qt
+    rubygems
+    sharutils
+    sysstat
+    swig
+    texinfo
+    tmux
+    xfsprogs
+    xterm
+    hmmer
+    viennarna
+    xstdcmap
+  )
+  array.each {|entry|
+    _ = EnvironmentInformation::Queries::ComplexVersion.new(entry)
+    _.report_left_right
+  }
+end # complexversion

data/lib/environment_information/queries/pkg_config.rb

@@ -0,0 +1,125 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === EnvironmentInformation::Queries::PkgConfig
+#
+# This class will try to do a pkg-config query, based on a .yml file.
+#
+# As input it needs the name of the program at hand; and that program
+# has to be registered in the .yml file. The query will then use
+# "pkg-config", which in turn queries the local .pc file for the
+# version.
+# =========================================================================== #
+# require 'environment_information/queries/pkg_config.rb'
+# EnvironmentInformation::Queries::PkgConfig.new
+# =========================================================================== #
+require 'environment_information/base/base.rb'
+
+module EnvironmentInformation
+
+module Queries
+
+class PkgConfig < ::EnvironmentInformation::Base # === EnvironmentInformation::Queries::PkgConfig
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument is mandatory.
+  # ========================================================================= #
+  def initialize(
+      for_this_program = nil,
+      run_already      = true
+    )
+    reset
+    set_program_name(for_this_program)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @program_name
+    # ======================================================================= #
+    @program_name    = ''.dup
+    # ======================================================================= #
+    # === @program_version
+    # ======================================================================= #
+    @program_version = nil
+  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 :pkgconfig
+        @program_version = `pkg-config --modversion #{this_program} #{ERROR_LINE}`.dup
+      else
+        @program_version = `#{result} #{ERROR_LINE}`.dup
+      end
+      if @program_version.include? NOT_FOUND_IN_PKG_CONFIG_SEARCH_PATH
+        @program_version = nil
+      end
+    else # We will try to run it anyway.
+      @program_version = `pkg-config --modversion #{this_program} #{ERROR_LINE}`.dup
+    end
+    @program_version.strip! if @program_version
+    return @program_version
+  end
+
+end; end
+
+# =========================================================================== #
+# === EnvironmentInformation.query_pkgconfig_version_for
+#
+# This is a simpler toplevel-query, for .pc files in general.
+# =========================================================================== #
+def self.query_pkgconfig_version_for(i = :gtk2)
+  ::EnvironmentInformation::Queries::PkgConfig.new(i).version?
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  _ = EnvironmentInformation::Queries::PkgConfig.new(:webkit2gtk)
+  puts _.program_name?.to_s+': '+_.program_version?.to_s
+  _ = EnvironmentInformation::Queries::PkgConfig.new(:gjs)
+  puts _.program_name?.to_s+': '+_.program_version?.to_s
+end

data/lib/environment_information/queries/simple_version.rb

@@ -0,0 +1,211 @@
+#!/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?('[') 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.split('patchlevel ').first.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
+  _ = EnvironmentInformation::Queries::SimpleVersion.new(:lftp)
+  _.report_left_right
+end

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/environment_information.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