program_information 1.2.6 → 1.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2617208ef9fa70961acf4153a404c136f1b4364d64a12178037819909d5c35b
-  data.tar.gz: bbb7289a5306d918eaf85fc38de85e131527342c8ce0db83e43811f694175414
+  metadata.gz: 423c820d72bf99567ed7ab239d47d8cf3e20d231cfa84ac5ccd1527f9b885eaa
+  data.tar.gz: 87738e4b3c93b518d90b59eba295103b9a34207714fafdb672c68611d8273062
 SHA512:
-  metadata.gz: fdf51dc3e64b3bbc4c32aef4ed0a4c0ed5e8c314025f288471d2df0649c106bfa8438ea91457d696c858723d94d4325419649fffaca8bfd6014ea9823e20d054
-  data.tar.gz: cc16f4e64ea82647d50e856e5d356576bce50c4ae884d4105b7a13cfbee281b6989969e6dc6b9ee98f802c70433b5deec14fa807dcd96eb3356f2ec08fd41801
+  metadata.gz: daa4357e1b473e0ad288774a986f6b507fc36199fa873974763b94665007209fbb4ce6d531eb02929b7e6d71e002953a70f091f57c80a6442ab84a0a7d4deb6c
+  data.tar.gz: 30681fae85df29685ad5824fa59087d47ee8d8106d3ec0624c0985b74bbab84842fa5ef1f9e7552954391bb98eb9220d247fbe660b577c45998ab332d28585b4

data/bin/program_information_version

@@ -0,0 +1,10 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'program_information'
+
+if ARGV.first
+  _ = ProgramInformation::ProgramInformation.new(ARGV)
+  puts _.program_version?
+end

data/lib/program_information/program_information.rb

@@ -43,37 +43,161 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
   require 'program_information/toplevel_methods/remove_archive_type.rb'
   require 'program_information/constants/constants.rb'
   require 'program_information/version/version.rb'
-  require 'program_information/initialize.rb'
-  require 'program_information/menu.rb'
-  require 'program_information/reset.rb'
-  require 'program_information/report.rb'
-  require 'program_information/run.rb'
 
-  # ========================================================================= #
+  # ========================================================================== #
+  # === initialize
+  #
+  # Specific usage example:
+  #
+  #   ProgramInformation::ProgramInformation.new('util-linux-ng-2.15')
+  #
+  # ========================================================================== #
+  def initialize(
+      i                   = ARGV,
+      run_already         = true,
+      optional_be_verbose = false
+    )
+    reset
+    if optional_be_verbose
+      set_be_verbose(optional_be_verbose)
+    end
+    set_input(i)
+    case run_already
+    # ======================================================================= #
+    # === :do_run_already
+    # ======================================================================= #
+    when :do_run_already
+      run_already = true
+    # ======================================================================= #
+    # === :dont_run_already
+    # ======================================================================= #
+    when :dont_run_already,
+         :do_not_run_already
+      run_already = false
+    end
+    run if run_already
+  end
+
+  # ========================================================================== #
+  # === reset                                                     (reset tag)
+  # ========================================================================== #
+  def reset
+    set_be_verbose
+    # ======================================================================= #
+    # === @short_name
+    # ======================================================================= #
+    @short_name      = nil
+    # ======================================================================= #
+    # === @real_short_name
+    # ======================================================================= #
+    @real_short_name = nil
+    # ======================================================================= #
+    # === @program_version
+    # ======================================================================= #
+    @program_version = nil
+    set_shall_we_downcase # Should become before set_input().
+    # ======================================================================= #
+    # === @remove_plus_and_minus
+    # ======================================================================= #
+    @remove_plus_and_minus = REMOVE_PLUS_AND_MINUS
+    # ======================================================================= #
+    # === @replace_plus_with_long_name
+    # ======================================================================= #
+    @replace_plus_with_long_name = REPLACE_PLUS_WITH_LONG_NAME
+    # ======================================================================= #
+    # === @remove_plus_token
+    # ======================================================================= #
+    @remove_plus_token = REMOVE_PLUS_TOKEN
+    if @remove_plus_and_minus # Overrule always in this case.
+      @replace_plus_with_long_name = false
+    end
+    if @remove_plus_and_minus
+      @remove_plus_token = false
+    end
+  end
+
+  # ========================================================================== #
+  # === menu                                                       (menu tag)
+  # ========================================================================== #
+  def menu(i)
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i
+      # ===================================================================== #
+      # === help
+      # ===================================================================== #
+      when /-?-?help$/i
+        show_help
+        exit
+      end
+    end
+  end
+
+  # ========================================================================== #
+  # === report                                        (debug tag, report tag)
+  # ========================================================================== #
+  def report(
+      be_verbose = be_verbose?
+    )
+    case be_verbose
+    when :do_report, :be_verbose
+      be_verbose = true
+    end
+    lpad = 90
+    rpad = 49
+    if be_verbose
+      inner_ljust = 28
+      # ===================================================================== #
+      # === real short name
+      # ===================================================================== #
+      e (NAME_OF_CLASS+(' Program real short name ').ljust(inner_ljust)+'('+
+        yellow?+'@real_short_name'+rev+') is: ').ljust(lpad)+
+        (apostroph?+real_short_name?+apostroph?).
+        ljust(rpad)
+      # ===================================================================== #
+      # === short name
+      # ===================================================================== #
+      e (
+        NAME_OF_CLASS+(' Program name').ljust(inner_ljust)+'('+
+        yellow?+'@short_name'+rev+'     ) is: '
+      ).ljust(lpad)+(apostroph?+short_name?+apostroph?).
+        ljust(rpad)
+      # ===================================================================== #
+      # === program version
+      # ===================================================================== #
+      e (NAME_OF_CLASS+(' Program version ').ljust(inner_ljust)+'('+
+        yellow?+'@program_version'+rev+') is: ').ljust(lpad)+
+        (apostroph?+version?+apostroph?).
+        ljust(rpad)
+    end
+  end; alias report_result report # === report_result
+
+  # ========================================================================== #
   # === return_proper_pipe_token_to_this_input
-  # ========================================================================= #
+  # ========================================================================== #
   def return_proper_pipe_token_to_this_input(i)
     ::ProgramInformation.return_proper_pipe_token_to_this_input(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === remove_file_suffix
   #
   # Delegate towards class RemoveFileSuffix. This is easier to handle
   # Archive.
-  # ========================================================================= #
+  # ========================================================================== #
   def remove_file_suffix(i)
     RemoveFileSuffix[i.to_s]
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === do_not_replace_plus
-  # ========================================================================= #
+  # ========================================================================== #
   def do_not_replace_plus
     @replace_plus_with_long_name = false
   end; alias do_not_replace_anything do_not_replace_plus # === do_not_replace_anything
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_program_version
   #
   # Use this method whenever you wish to assign to the @program_version
@@ -87,7 +211,7 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
   # Until March 2015 we also replaced all '_' with '.' characters,
   # but input such as "ncbi_cxx--12_0_0.tar.gz" would break as a
   # consequence, so this was disabled again.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_program_version(i)
     i = remove_file_suffix(i) unless i.nil? # Disallow archive-types here.
     # ======================================================================= #
@@ -110,88 +234,88 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
     @program_version = i
   end; alias set_version set_program_version # === set_version
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === be_verbose?
-  # ========================================================================= #
+  # ========================================================================== #
   def be_verbose?
     @be_verbose
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === remove_plus_token?
-  # ========================================================================= #
+  # ========================================================================== #
   def remove_plus_token?
     @remove_plus_token
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === input?
-  # ========================================================================= #
+  # ========================================================================== #
   def input?
     @input
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === return_array
   #
   # This method will return a composite, 3-member Array that will hold the
   # short_name, the real_short_name, and the program_version.
-  # ========================================================================= #
+  # ========================================================================== #
   def return_array
     [ short_name?, real_short_name?, program_version? ]
   end; alias array? return_array # === array?
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === remove_plus_and_minus?
-  # ========================================================================= #
+  # ========================================================================== #
   def remove_plus_and_minus?
     @remove_plus_and_minus
   end; alias remove_plus_and_minus remove_plus_and_minus? # === remove_plus_and_minus
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === apostroph?
-  # ========================================================================= #
+  # ========================================================================== #
   def apostroph?
     APOSTROPH
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === replace_plus_with_long_name?
-  # ========================================================================= #
+  # ========================================================================== #
   def replace_plus_with_long_name?
     @replace_plus_with_long_name
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === short_name_and_version?
   #
   # This method returns an aggregated @short_name+'-'+@program_version
   # string.
-  # ========================================================================= #
+  # ========================================================================== #
   def short_name_and_version?
     "#{short_name?}-#{program_version?}"
   end; alias short_name_and_version short_name_and_version? # === short_name_and_version
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_short_name_then_version
   #
   # This method will combine two other methods.
-  # ========================================================================= #       
+  # ========================================================================== #       
   def set_short_name_then_version(a, b)
     set_short_name(a)
     set_program_version(b)
   end; alias set_name_then_version set_short_name_then_version # === set_name_then_version
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === return_real_short_name_and_version
   #
   # We delegate to the module-method here.
-  # ========================================================================= #
+  # ========================================================================== #
   def return_real_short_name_and_version(i)
     ::ProgramInformation.return_real_short_name_and_version(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === return_name_and_version
   #
   # This method will return an array with two elements:
@@ -240,7 +364,7 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
   #   "CrownCutlass-Alpha1.4"
   # unless we assume that alpha is a part of the version,
   # which is possibly correct.
-  # ========================================================================= #
+  # ========================================================================== #
   def return_name_and_version(i = nil)
     if i
       determine_the_three_main_variables(i)
@@ -254,40 +378,49 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
     # ======================================================================= #
     # i.delete!('_') if i.include? '_'
     return [
-      @short_name, @program_version
+      @short_name,
+      @program_version
     ]
   end; alias rnav return_name_and_version # === rnav
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_shall_we_downcase
-  # ========================================================================= #
+  # ========================================================================== #
   def set_shall_we_downcase(
       i = SHALL_WE_DOWNCASE
     )
     @shall_we_downcase = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === do_not_downcase
-  # ========================================================================= #
+  # ========================================================================== #
   def do_not_downcase
     @shall_we_downcase = false
   end
-  
-  # ========================================================================= #
+
+  # ========================================================================== #
   # === set_be_verbose
   #
   # Set to report in a verbose way here.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_be_verbose(i = BE_VERBOSE)
     case i
+    # ======================================================================== #
+    # === :be_quiet
+    # ======================================================================== #
+    when :be_quiet
+      i = false
+    # ======================================================================== #
+    # === :be_verbose
+    # ======================================================================== #
     when :be_verbose
       i = true
     end
     @be_verbose = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === determine_the_three_main_variables
   #
   # This method will determine the three main instance variables:
@@ -304,8 +437,10 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
   # Note that presently, set_input() will modify the given input and
   # ensure that there will be a '-' token, even in input that does
   # not have any '-' or '_' such as in 'sendmail.8.15.2'.
-  # ========================================================================= #
-  def determine_the_three_main_variables(i = @input)
+  # ========================================================================== #
+  def determine_the_three_main_variables(
+      i = input?
+    )
     if i
       if i.include? '|'
         splitted        = i.split('|')
@@ -314,36 +449,22 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
         set_short_name(short_name)
         set_program_version(program_version)
       else
-        opn; e "The input `#{i}` does not include a | character."
+        set_program_version(i) if (i =~ /\d+/)
+        if be_verbose?
+          opn; e "The input `#{i}` does not include a | character."
+        end
       end
     end
   end; alias determine_name_and_program_version determine_the_three_main_variables # === determine_name_and_program_version
 
-  # ========================================================================= #
-  # === set_real_short_name
-  #
-  # The instance variable @real_short_name is not allowed to include any
-  # '-' characters. It may also not include any '_' characters.
-  #
-  # The latter could be found as part of program names such as "SDL_image".
-  # The @short_name variant may include these '_' tokens.
-  #
-  # Note that as of September 2017, we also disallow '.' tokens, such as
-  # may occur accidentally in input like "sendmail.5.8.2".
-  # ========================================================================= #
-  def set_real_short_name(i = @short_name)
-    i = i.to_s.dup.delete('-_.').rstrip
-    @real_short_name = i
-  end
-
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_short_name
   #
   # Use this method whenever you wish to assign to the @short_name variable.
   #
   # This variable is allowed to keep '-' and '_' entries, but some
   # settings may also modify this.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_short_name(i)
     i = i.dup
     # ======================================================================= #
@@ -372,9 +493,9 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
   end; alias set_name         set_short_name # === set_name
        alias set_program_name set_short_name # === set_program_name
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === remove_source_like_strings
-  # ========================================================================= #
+  # ========================================================================== #
   def remove_source_like_strings(i)
     # ======================================================================= #
     # i.gsub!(/--/,'-') if i.include? '--' # Replace '--' with '-'.
@@ -386,26 +507,26 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
     return i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === remove_archive_type
-  # ========================================================================= #
+  # ========================================================================== #
   def remove_archive_type(i)
     ::ProgramInformation.remove_archive_type(i)
     return i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === e
-  # ========================================================================= #
+  # ========================================================================== #
   def e(i = '')
     ::ProgramInformation.e(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === real_short_name?
   #
   # Keep in mind that @real_short_name does not have any '-' tokens.
-  # ========================================================================= #
+  # ========================================================================== #
   def real_short_name?
     @real_short_name
   end; alias real_name?           real_short_name? # === real_name?
@@ -413,13 +534,13 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
        alias real_short_name      real_short_name? # === real_short_name
        alias name_of_the_program? real_short_name? # === name_of_the_program?
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === short_name?
   #
   # Reader method for the @short_name instance variable.
   #
   # short_name is an alias to @short_name.
-  # ========================================================================= #
+  # ========================================================================== #
   def short_name?
     @short_name
   end; alias program_name             short_name? # === program_name
@@ -432,11 +553,11 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
        alias first                    short_name? # === first
        alias return_program_real_name short_name? # === return_program_real_name
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === program_version?
   #
   # Getter method for the @program_version variable.
-  # ========================================================================= #
+  # ========================================================================== #
   def program_version?
     @program_version
   end; alias program_version         program_version? # === program_version
@@ -446,14 +567,14 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
        alias last                    program_version? # === last?
        alias version_of_the_program? program_version? # === version_of_the_program?
 
-  # ========================================================================= #
-  # === show_help                                                  (help tag)
+  # ========================================================================== #
+  # === show_help                                                   (help tag)
   #
   # To invoke this method, try:
   #
   #   pinfo --show-help
   #
-  # ========================================================================= #
+  # ========================================================================== #
   def show_help
     e
     e 'This class is able to split a given input (a string) into'
@@ -475,18 +596,19 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
     e
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_input
   #
   # This method will, after performing some sanitize-operations, assign
   # to the @input variable.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_input(i)
     if i.is_a? Array
       menu(i)
       i = i.join(' ').strip
     end
     i = i.to_s.dup if i.frozen?
+    original_input = i.dup
     i = File.basename(i)
     # ======================================================================= #
     # We .squeeze away '--' tokens.
@@ -548,9 +670,40 @@ class ProgramInformation # === ProgramInformation::ProgramInformation
       i.delete!('+') if i.include? '+'
     end
     i = return_proper_pipe_token_to_this_input(i)
+    case i
+    when '|' # Sanitize it in this case.
+      i = original_input
+      set_be_verbose(:be_quiet)
+    end
     @input = i
   end
 
+  # ========================================================================== #
+  # === set_real_short_name
+  #
+  # The instance variable @real_short_name is not allowed to include any
+  # '-' characters. It may also not include any '_' characters.
+  #
+  # The latter could be found as part of program names such as "SDL_image".
+  # The @short_name variant may include these '_' tokens.
+  #
+  # Note that as of September 2017, we also disallow '.' tokens, such as
+  # may occur accidentally in input like "sendmail.5.8.2".
+  # ========================================================================== #
+  def set_real_short_name(
+      i = @short_name
+    )
+    i = i.to_s.dup.delete('-_.').rstrip
+    @real_short_name = i
+  end
+
+  # ========================================================================== #
+  # === run                                                         (run tag)
+  # ========================================================================== #
+  def run
+    determine_the_three_main_variables
+  end
+
 end
 
 # =========================================================================== #

data/lib/program_information/toplevel_methods.rb

@@ -55,7 +55,9 @@ module ProgramInformation
   # 
   # The above would return "isocodes".
   # ========================================================================= #
-  def self.return_real_short_name(of_this_program = '')
+  def self.return_real_short_name(
+      of_this_program = ''
+    )
     if of_this_program.nil? or of_this_program.empty?
       opnn; e 'Please provide some input to the method '\
               'ProgramInformation.return_real_short_name.'
@@ -96,6 +98,18 @@ module ProgramInformation
     return array
   end; self.instance_eval { alias return_short_name_and_version return_short_name_and_program_version } # === ProgramInformation.return_short_name_and__version
 
+  # ========================================================================= #
+  # === ProgramInformation.long_program_name?
+  #
+  # Usage example:
+  #
+  #   ProgramInformation.long_program_name?('man-pages-6.7')
+  #
+  # ========================================================================= #
+  def self.long_program_name?(i)
+    return_short_name_and_version(i).first
+  end
+
   # ========================================================================= #
   # === ProgramInformation.return_array_name_and_version
   #

data/lib/program_information/version/version.rb

@@ -11,12 +11,12 @@ class ProgramInformation
   # ========================================================================= #
   # === VERSION
   # ========================================================================= #
-  VERSION = '1.2.6'
+  VERSION = '1.2.8'
     DEFAULT_VERSION = VERSION # Use an "alias" to the above constant.
 
   # ========================================================================= #
   # === LAST_UPDATE
   # ========================================================================= #
-  LAST_UPDATE = '17.03.2024'
+  LAST_UPDATE = '04.04.2024'
 
 end; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: program_information
 version: !ruby/object:Gem::Version
-  version: 1.2.6
+  version: 1.2.8
 platform: ruby
 authors:
 - Robert A. Heiler
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-17 00:00:00.000000000 Z
+date: 2024-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colours
@@ -51,6 +51,7 @@ extra_rdoc_files: []
 files:
 - README.md
 - bin/program_information
+- bin/program_information_version
 - doc/CONVENTIONS.md
 - doc/README.gen
 - lib/program_information.rb
@@ -58,14 +59,9 @@ files:
 - lib/program_information/constants/colours.rb
 - lib/program_information/constants/constants.rb
 - lib/program_information/constants/regex.rb
-- lib/program_information/initialize.rb
-- lib/program_information/menu.rb
 - lib/program_information/program_information.rb
 - lib/program_information/project/project.rb
-- lib/program_information/report.rb
 - lib/program_information/requires/require_the_program_information_project.rb
-- lib/program_information/reset.rb
-- lib/program_information/run.rb
 - lib/program_information/toplevel_methods.rb
 - lib/program_information/toplevel_methods/e.rb
 - lib/program_information/toplevel_methods/opnn.rb
@@ -93,9 +89,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.5.6
+      version: 3.5.7
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.7
 signing_key:
 specification_version: 4
 summary: This library is called program_information.  It allows you to return the

data/lib/program_information/initialize.rb

@@ -1,43 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-module ProgramInformation
-
-class ProgramInformation # === ProgramInformation::ProgramInformation
-
-  # ========================================================================= #
-  # === initialize
-  #
-  # Specific usage example:
-  #
-  #   ProgramInformation::ProgramInformation.new('util-linux-ng-2.15')
-  #
-  # ========================================================================= #
-  def initialize(
-      i                   = ARGV,
-      run_already         = true,
-      optional_be_verbose = false
-    )
-    reset
-    set_input(i)
-    if optional_be_verbose
-      set_be_verbose(optional_be_verbose)
-    end
-    case run_already
-    # ======================================================================= #
-    # === :do_run_already
-    # ======================================================================= #
-    when :do_run_already
-      run_already = true
-    # ======================================================================= #
-    # === :dont_run_already
-    # ======================================================================= #
-    when :dont_run_already,
-         :do_not_run_already
-      run_already = false
-    end
-    run if run_already
-  end
-
-end; end

data/lib/program_information/menu.rb

@@ -1,29 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'program_information/menu.rb'
-# =========================================================================== #
-module ProgramInformation
-
-class ProgramInformation # === ProgramInformation::ProgramInformation
-
-  # ========================================================================= #
-  # === menu                                                       (menu tag)
-  # ========================================================================= #
-  def menu(i)
-    if i.is_a? Array
-      i.each {|entry| menu(entry) }
-    else
-      case i
-      # ===================================================================== #
-      # === help
-      # ===================================================================== #
-      when /-?-?help$/i
-        show_help
-        exit
-      end
-    end
-  end
-
-end; end

data/lib/program_information/report.rb

@@ -1,48 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-module ProgramInformation
-
-class ProgramInformation
-
-  # ========================================================================= #
-  # === report                                        (debug tag, report tag)
-  # ========================================================================= #
-  def report(
-      be_verbose = be_verbose?
-    )
-    case be_verbose
-    when :do_report, :be_verbose
-      be_verbose = true
-    end
-    lpad = 90
-    rpad = 49
-    if be_verbose
-      inner_ljust = 28
-      # ===================================================================== #
-      # === real short name
-      # ===================================================================== #
-      e (NAME_OF_CLASS+(' Program real short name ').ljust(inner_ljust)+'('+
-        yellow?+'@real_short_name'+rev+') is: ').ljust(lpad)+
-        (apostroph?+real_short_name?+apostroph?).
-        ljust(rpad)
-      # ===================================================================== #
-      # === short name
-      # ===================================================================== #
-      e (
-        NAME_OF_CLASS+(' Program name').ljust(inner_ljust)+'('+
-        yellow?+'@short_name'+rev+'     ) is: '
-      ).ljust(lpad)+(apostroph?+short_name?+apostroph?).
-        ljust(rpad)
-      # ===================================================================== #
-      # === program version
-      # ===================================================================== #
-      e (NAME_OF_CLASS+(' Program version ').ljust(inner_ljust)+'('+
-        yellow?+'@program_version'+rev+') is: ').ljust(lpad)+
-        (apostroph?+version?+apostroph?).
-        ljust(rpad)
-    end
-  end; alias report_result report # === report_result
-
-end; end

data/lib/program_information/reset.rb

@@ -1,46 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'program_information/reset.rb'
-# =========================================================================== #
-module ProgramInformation
-
-class ProgramInformation # === ProgramInformation::ProgramInformation
-
-  # ========================================================================= #
-  # === reset
-  # ========================================================================= #
-  def reset
-    # ======================================================================= #
-    # === @short_name
-    # ======================================================================= #
-    @short_name      = nil
-    # ======================================================================= #
-    # === @real_short_name
-    # ======================================================================= #
-    @real_short_name = nil
-    # ======================================================================= #
-    # === @program_version
-    # ======================================================================= #
-    @program_version = nil
-    set_shall_we_downcase # Should become before set_input().
-    set_be_verbose
-    # ======================================================================= #
-    # === @remove_plus_and_minus
-    # ======================================================================= #
-    @remove_plus_and_minus = REMOVE_PLUS_AND_MINUS
-    # ======================================================================= #
-    # === @replace_plus_with_long_name
-    # ======================================================================= #
-    @replace_plus_with_long_name = REPLACE_PLUS_WITH_LONG_NAME
-    @remove_plus_token = REMOVE_PLUS_TOKEN
-    if @remove_plus_and_minus # Overrule always in this case.
-      @replace_plus_with_long_name = false
-    end
-    if @remove_plus_and_minus
-      @remove_plus_token = false
-    end
-  end
-
-end; end

data/lib/program_information/run.rb

@@ -1,18 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'program_information/run.rb'
-# =========================================================================== #
-module ProgramInformation
-
-class ProgramInformation
-
-  # ========================================================================= #
-  # === run
-  # ========================================================================= #
-  def run
-    determine_the_three_main_variables
-  end
-
-end; end