rbt 0.11.118 → 0.13.27

data/lib/rbt/utility_scripts/change_prefix.rb

@@ -35,6 +35,11 @@ module RBT
 
 class ChangePrefix < Base # === RBT::ChangePrefix
 
+  # ========================================================================= #
+  # === REGEX_FOR_UPPCASE_PREFIX
+  # ========================================================================= #
+  REGEX_FOR_UPPCASE_PREFIX = /^(PREFIX\s*\??=) ?(.+)/i
+
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
@@ -60,6 +65,10 @@ class ChangePrefix < Base # === RBT::ChangePrefix
     # ======================================================================= #
     set_modify_this_file(:default_file)
     # ======================================================================= #
+    # === @we_have_already_modified_the_makefile
+    # ======================================================================= #
+    @we_have_already_modified_the_makefile = false
+    # ======================================================================= #
     # === @search_for_this_pattern
     #
     # Designate which pattern we are trying to find in that file.
@@ -72,12 +81,20 @@ class ChangePrefix < Base # === RBT::ChangePrefix
     # will have to check for these variants, which is why we will
     # ask rubular for help here.
     #
+    # In June 2023 I discovered a Makefile that contains this dual-prefix:
+    #
+    #   prefix      ?= /usr/local
+    #   PREFIX      ?= $(prefix)
+    #
+    # So it seems as if we also have to match against the "?" part there.
+    #
     # See:
     #
-    #   https://rubular.com/r/iAYqSQTaSllK5f
+    #   https://rubular.com/r/jUCLVDCCVRqZb4
     #
     # ======================================================================= #
-    @search_for_this_pattern = /^(PREFIX\s*=) ?(.+)/i
+    @search_for_this_pattern =
+      REGEX_FOR_UPPCASE_PREFIX
     # ======================================================================= #
     # Infer the name and program version from return_pwd, via
     # ProgramInformation.
@@ -222,6 +239,9 @@ class ChangePrefix < Base # === RBT::ChangePrefix
   # ========================================================================= #
   def set_modify_this_file(i = :default)
     case i
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
     when :default,
          :default_file
       i = '/Depot/jjj/libcli-1.9.8-4/Makefile' 
@@ -235,70 +255,119 @@ class ChangePrefix < Base # === RBT::ChangePrefix
   end; alias set_main_file set_modify_this_file # === set_main_file
 
   # ========================================================================= #
-  # === perform_the_modification
+  # === notify_the_user_that_a_match_was_found_in_this_file_using_that_pattern
+  # ========================================================================= #
+  def notify_the_user_that_a_match_was_found_in_this_file_using_that_pattern(
+      _,
+      pattern
+    )
+    opne "A match was found within the file #{sfile(_)},"
+    opne "using the pattern #{steelblue(pattern)}."
+  end
+
+  # ========================================================================= #
+  # === lowercase_prefix_pattern?                                (regex1 tag)
   #
-  # This is the method that will be used to modify the Makefile at hand.
+  # This method will return the main regex, as-is, but with PREFIX
+  # being downcased to prefix.
   # ========================================================================= #
-  def perform_the_modification
-    _ = main_file?
-    if File.exist? _
+  def lowercase_prefix_pattern?
+    return /^(prefix\s*\??=) ?(.+)/i
+  end; alias pattern? lowercase_prefix_pattern? # === pattern?
+       alias regex1   lowercase_prefix_pattern? # === regex1
+
+  # ========================================================================= #
+  # === uppercase_prefix_pattern?                                (regex2 tag)
+  # ========================================================================= #
+  def uppercase_prefix_pattern?
+    REGEX_FOR_UPPCASE_PREFIX
+  end; alias regex2 uppercase_prefix_pattern? # === regex2
+
+  # ========================================================================= #
+  # === contine_with_this_regex_on_that_dataset
+  # ========================================================================= #
+  def contine_with_this_regex_on_that_dataset(
+      use_this_regex,
+      dataset_as_string
+    )
+    main_file = main_file?
+    if dataset_as_string =~ use_this_regex
       # ===================================================================== #
-      # Read in the dataset into a variable next.
+      # First inform the user that we have, indeed, found a match.
       # ===================================================================== #
-      old_dataset = File.readlines(_)
-      pattern = @search_for_this_pattern
-      joined_dataset = old_dataset.join
-      if joined_dataset =~ pattern # Must be a Regex.
-        opne "A match was found within the file #{sfile(_)},"
-        opne "using the pattern #{steelblue(pattern)}."
-        new_file_content = ''.dup
-        old_dataset.each {|line|
-          if line =~ pattern
-            # =============================================================== #
-            # Here we have to check for two cases:
-            #
-            #   1) prefix is downcased
-            #   2) PREFIX is upcased
-            #
-            # =============================================================== #
-            if line.include? 'prefix '
-              # ============================================================= #
-              # Then use the downcased variant.
-              # ============================================================= #
-              line = 'prefix = '+@use_this_as_the_new_prefix
-            elsif line.include? 'PREFIX='
-              line = 'PREFIX = '+@use_this_as_the_new_prefix
-            else
-              # ============================================================= #
-              # Else use the upcased variant.
-              # ============================================================= #
-              line = 'PREFIX = '+@use_this_as_the_new_prefix
-            end
+      notify_the_user_that_a_match_was_found_in_this_file_using_that_pattern(
+        main_file, use_this_regex
+      )
+      result = ''.dup
+      dataset_as_string.split("\n").each {|line|
+        if line =~ use_this_regex
+          use_that_for_the_inner_regex = /(prefix\s*\??=\s*)(.+)/ # See: https://rubular.com/r/SKxjzFXhjMctH4
+          if line.start_with?('prefix ') and !@we_have_already_modified_the_makefile
+            # ============================================================= #
+            # Then use the downcased variant.
+            # ============================================================= #
+            line =~ use_that_for_the_inner_regex
+            line = $1.to_s.dup+@use_this_as_the_new_prefix.to_s
+            @we_have_already_modified_the_makefile = true
+          elsif line.start_with?('PREFIX') and !@we_have_already_modified_the_makefile
+            line =~ use_that_for_the_inner_regex
+            line = $1.to_s.dup+@use_this_as_the_new_prefix.to_s
+            @we_have_already_modified_the_makefile = true
+          else
+            # ============================================================= #
+            # Else do nothing for now.
+            # ============================================================= #
+          end
+          unless @we_have_already_modified_the_makefile
             opne "The new line will be: #{lightgreen(line)}"
           end
-          new_file_content << "#{line.rstrip}\n"
-        }
-        opne "Storing into the file `#{sfile(_)}`."
-        write_what_into(new_file_content, _)
+        end
+        result << "#{line.rstrip}\n"
+      }
+      opne "Storing into the file `#{sfile(main_file)}`."
+      write_what_into(result, main_file)
+    else
+      opne 'The pattern '+sfile(use_this_regex.to_s)+' was not found.'
+    end
+  end
+
+  # ========================================================================= #
+  # === do_work_on_this_file
+  # ========================================================================= #
+  def do_work_on_this_file(i)
+    if i and File.exist?(i)
+      dataset = default_readlines(i)
       # ===================================================================== #
-      # The next clause is specifically for hdparm.
+      # Next we must determine which regex-pattern to use.
+      #
+      # In order to determine this, we run a simple .include?() check
+      # first.
       # ===================================================================== #
-      elsif !joined_dataset.include?('PREFIX') and joined_dataset.include?('DESTDIR')
-        joined_dataset.gsub!(
-          /^DESTDIR =/,
-          'DESTDIR = '+use_this_prefix?.to_s
-        )
-        opne "Storing into the file `#{sfile(_)}`."
-        write_what_into(joined_dataset, _)
+      dataset_as_string = dataset.join
+      if dataset_as_string.include?('prefix ')
+        use_this_regex = regex1
+        contine_with_this_regex_on_that_dataset(use_this_regex, dataset_as_string)
+      elsif dataset_as_string.include?('PREFIX ')
+        use_this_regex = regex2
+        contine_with_this_regex_on_that_dataset(use_this_regex, dataset_as_string)
       else
-        opne 'The pattern '+sfancy(pattern)+' could '\
-             'not be found in the file '+sfile(_)+'.'
+        opne 'Neither the pattern for '+sfancy('prefix')+' nor for the pattern'
+        opne sfancy('PREFIX')+' could be found in the file at `'+sfile(i)+'`.'
       end
     else
-      opnn; no_file_exists_at(_)
+      opnn; no_file_exists_at(i)
     end
   end
 
+  # ========================================================================= #
+  # === perform_the_modification
+  #
+  # This is the method that will be used to modify the Makefile at hand.
+  # ========================================================================= #
+  def perform_the_modification
+    do_work_on_this_file(main_file?)
+  end
+
   # ========================================================================= #
   # === run                                                         (run tag)
   # ========================================================================= #

data/lib/rbt/utility_scripts/expand_cookbooks.rb

@@ -91,8 +91,9 @@ class ExpandCookbooks < Base # === RBT::Cookbooks::ExpandCookbooks
       i = [i] # Turn it into an Array.
     end
     i.map! {|entry|
+      entry = entry.dup if entry.frozen?
+      entry.delete!('-') if entry.include?('-')
       if entry and entry.end_with?('.yml')
-        entry = entry.dup if entry.frozen?
         entry.delete_suffix!('.yml')
       end
       entry
@@ -138,11 +139,11 @@ class ExpandCookbooks < Base # === RBT::Cookbooks::ExpandCookbooks
   def inform_the_user_what_we_will_do_next
     if main_array?.size < 2
       opne "We will now expand the program called `"\
-            "#{sfancy(return_default_program_name_as_string)}`"
+            "#{sfancy(return_default_program_name_as_string)}#{rev}`"
       opne 'towards its individual yaml file.'
     else
-      opne 'We will now expand the whole dataset stored into '\
-           'the individual yaml files.'
+      opne "#{rev}We will now expand the whole dataset stored into "\
+           "the individual yaml files."
     end
   end
 
@@ -224,18 +225,18 @@ class ExpandCookbooks < Base # === RBT::Cookbooks::ExpandCookbooks
       # Get the target, aka where to store, next:
       # ===================================================================== #
       into = rds("#{directory_expanded_cookbooks?}#{program}.yml")
-      opne "Now storing the #{royalblue('Hash')} from "\
-           "`#{slateblue(program)}"\
-           "` into `#{sfile(into)}`."
+      opne "Now storing the #{royalblue('Hash')} #{rev}from "\
+           "`#{slateblue(program)}#{rev}"\
+           "` into `#{sfile(into)}#{rev}`."
       write_what_into(what, into)
       # ===================================================================== #
       # Since as of May 2020, on roebe systems, we will also store this.
       # ===================================================================== #
       if is_on_roebe
         into = "#{RUBY_SRC_DIR_RBT_YAML}expanded_cookbooks/#{File.basename(into)}"
-        opne "Also storing the #{royalblue('Hash')} from "\
+        opne "Also storing the #{royalblue('Hash')} #{rev}from "\
              "`#{slateblue(program)}"\
-             "` into `#{sfile(into)}`."
+             "#{rev}` into `#{sfile(into)}`."
         write_what_into(what, into)
       end
     }

data/lib/rbt/utility_scripts/increment_program_version/increment_program_version.rb

@@ -102,12 +102,12 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
       i = url?
     )
     if i.nil? or i.empty?
-      e 'No '+steelblue('url1')+' entry could be found. '+
+      e rev+'No '+steelblue('url1')+' entry could be found. '+
         lightblue('Is the .yml file correct?')
       return
     end
     original_version = ProgramInformation.return_version(i)
-    e "The input-version was `#{sfancy(original_version)}`."
+    e "#{rev}The input-version was `#{sfancy(original_version)}#{rev}`."
     original_split   = original_version.split('.')
     splitted         = original_split
     # ======================================================================= #
@@ -155,8 +155,10 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
         if does_it_exist # Minor increment exist, download it.
           register_and_install_this_program(url_for_minor_version)
         else
-          e 'There was '+seagreen('no minor release')+' for `'+
-            sfancy(url_for_minor_version)+'`.'
+          e rev+'There was '+seagreen('no minor release')+rev+
+            ' for `'+
+            sfancy(url_for_minor_version)+rev+
+            '`.'
         end
       else
         report_that_wget_is_missing_then_exit
@@ -174,8 +176,9 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
       if does_it_exist # Minor increment exist, download it.
         register_and_install_this_program(url_for_minor_version)
       else
-        e 'There was '+seagreen('no minor release')+' for `'+
-          sfancy(url_for_minor_version)+'`.'
+        e rev+'There was '+seagreen('no minor release')+rev+
+          ' for `'+
+          sfancy(url_for_minor_version)+rev+'`.'
       end
     end
     # ======================================================================= #
@@ -193,8 +196,8 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
     if subversion_version_exists
       register_and_install_this_program(url_for_subversion)
     else
-      e 'There was '+seagreen('no subversion release')+
-        ' release for '+sfancy(url_for_subversion)+'.'
+      e rev+'There was '+seagreen('no subversion release')+
+        rev+' release for '+sfancy(url_for_subversion)+rev+'.'
     end
     # ======================================================================= #
     # Check for another minor-version again.
@@ -212,8 +215,8 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
       if does_it_exist # Minor increment exist, download it.
         register_and_install_this_program(url_for_minor_version)
       else
-        e "There was #{seagreen('no minor release')} for `"\
-          "#{sfancy(url_for_minor_version)}`."
+        e "#{rev}There was #{seagreen('no minor release')} #{rev}for `"\
+          "#{sfancy(url_for_minor_version)}#{rev}`."
       end
     else
       report_that_wget_is_missing_then_exit
@@ -237,8 +240,9 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
     if middle_version_exists
       register_and_install_this_program(url_for_middle_version)
     else
-      e 'There was '+seagreen('no middle release')+
-        ' release for '+sfancy(url_for_middle_version)+'.'
+      e rev+'There was '+seagreen('no middle release')+
+        rev+' release for '+sfancy(url_for_middle_version)+rev+
+        '.'
     end
     # ======================================================================= #
     # === Major Version Check
@@ -260,8 +264,8 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
     if major_version_exists
       register_and_install_this_program(url_for_major_version)
     else
-      e "There was #{seagreen('no major release')} for "\
-        "#{sfancy(url_for_major_version)}."
+      e "#{rev}There was #{seagreen('no major release')} #{rev}for "\
+        "#{sfancy(url_for_major_version)}#{rev}."
     end
   end
 
@@ -307,8 +311,8 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
         # =================================================================== #
         # Only roebe-systems get the following extra notifications.
         # =================================================================== #
-        e "The program `#{sfancy(short_name?)}` has no "\
-          "#{orange('homepage: entry')}. Consider adding one."
+        e "#{rev}The program `#{sfancy(short_name?)}` #{rev}has no "\
+          "#{orange('homepage: entry')}#{rev}. Consider adding one."
       end
     end
   end
@@ -336,7 +340,8 @@ class IncrementProgramVersion < Base # === RBT::Cookbooks::IncrementProgramVersi
     # === try_to_update_this_program binutils
     # ======================================================================= #
     if RBT.does_include? _
-      e 'The program '+sfancy(_)+' is included. '+
+      e rev+'The program '+sfancy(_)+rev+
+        ' is included. '+
         steelblue('This class can thus proceed. ')+
         gold(
           cheering_ascii_person

data/lib/rbt/utility_scripts/purge_incorrect_yaml_directories_in_the_programs_hierarchy.rb

@@ -141,7 +141,7 @@ class PurgeIncorrectYamlDirectoriesInTheProgramsHierarchy < Base # === RBT::Purg
   # ========================================================================= #
   # === RBT::PurgeIncorrectYamlDirectoriesInTheProgramsHierarchy[]
   # ========================================================================= #
-  def self.[](i = '')
+  def self.[](i = ARGV)
     new(i)
   end
 

data/lib/rbt/utility_scripts/report_the_registered_programs.rb

@@ -87,9 +87,9 @@ class ReportTheRegisteredPrograms < ::RBT::Base # === RBT::Cookbooks::ReportTheR
   # ========================================================================= #
   def do_report_how_many_programs_are_registered
     opnn if show_class_name?
-    e "#{sfancy(RBT.n_programs_available?)} programs are "\
-      "registered in the #{orange('RBT project')} as of "\
-      "#{cadetblue(return_date)}."
+    e "#{sfancy(RBT.n_programs_available?)} #{rev}programs are "\
+      "registered in the #{orange('RBT project')} #{rev}as of "\
+      "#{cadetblue(return_date)}#{rev}."
   end
 
   # ========================================================================= #

data/lib/rbt/utility_scripts/show_manual_steps.rb

@@ -0,0 +1,114 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === RBT::ShowManualSteps
+#
+# This small class will simply show the manual steps of a given program.
+#
+# In order for this to work, there has to be a manual_steps: entry in
+# the corresponding .yml file.
+#
+# Usage example:
+#
+#   RBT::ShowManualSteps.new(ARGV)
+#
+# =========================================================================== #
+# require 'rbt/utility_scripts/show_manual_steps.rb'
+# RBT::ShowManualSteps.new(ARGV)
+# =========================================================================== #
+require 'rbt/base/base.rb'
+
+module RBT
+
+class ShowManualSteps < Base # === RBT::ShowManualSteps
+
+  require 'rbt/requires/require_the_cookbook_class.rb'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    _ = first_argument?
+    cookbook = RBT.cookbook_for(_)
+    manual_steps = cookbook.manual_steps?
+    if manual_steps and !manual_steps.empty?
+      report_these_manual_steps(manual_steps, _)
+    else
+      opne 'No manual steps are known for '+sfancy(_)+'.'
+    end
+  end
+
+  # ========================================================================= #
+  # === report_these_manual_steps (report tag)
+  # ========================================================================= #
+  def report_these_manual_steps(i, this_program)
+    opne 'The following manual steps are known for the program '+
+         steelblue(this_program)+':'
+    if i.is_a? String
+      i = i.split(N)
+    end
+    compacted_array = [i].flatten.compact
+    compacted_array.shift if compacted_array.first.strip.empty? # Get rid of leading newlines here.
+    padded = compacted_array.map {|entry|
+      entry = entry.dup
+      entry.prepend('  ')
+      entry
+    }
+    e
+    padded.each {|line|
+      e steelblue(line)
+    }
+    e
+  end; alias report report_these_manual_steps # === report
+
+  # ========================================================================= #
+  # === RBT::ShowManualSteps.of
+  # ========================================================================= #
+  def self.of(i = ARGV)
+    new(i)
+  end; self.instance_eval { alias [] of } # === ShowManualSteps[]
+
+end
+
+# =========================================================================== #
+# === RBT.show_manual_steps
+#
+# Usage example:
+#
+#   RBT.show_manual_steps(:kde5_plasma)
+#
+# =========================================================================== #
+def self.show_manual_steps(of = ARGV)
+  [of].flatten.compact.each {|this_program|
+    new(this_program)
+  }
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  RBT::ShowManualSteps.new(ARGV)
+end # showmanualsteps glibc

data/lib/rbt/utility_scripts/update_entry/update_entry.rb

@@ -447,7 +447,7 @@ class UpdateEntry < Base # === RBT::UpdateEntry
       _.delete!('_') if _.include? '_' # Directories must not contain a '_' character.
       _.delete!('-') if _.include? '-'
       unless (Dir.pwd+'/').squeeze('/') == _ # Need the .squeeze to append a '/'.
-        output 'Now changing to the directory `'+sdir(_)+'`.'
+        output "#{rev}Now changing to the directory `#{sdir(_)}#{rev}`."
         cd _, :ensure_that_the_directory_exists
       end
     end
@@ -595,7 +595,7 @@ class UpdateEntry < Base # === RBT::UpdateEntry
            "# program_version: #{program_version?.to_s.rjust(10)} "\
            "#{current_timestamp}#{N}"
     into = "#{rbt_log_dir?}these_programs_were_updated.yml"
-    opne "Appending `#{sfancy(what.strip)}` into `#{sfile(into)}`."
+    opne "Appending `#{sfancy(what.strip)}#{rev}` into `#{sfile(into)}#{rev}`."
     append_what_into(what, into)
     # ======================================================================= #
     # === Generate a copy as well

data/lib/rbt/utility_scripts/url.rb

@@ -227,22 +227,57 @@ class Url < Base # === RBT::Cookbooks::Url
 
   # ========================================================================= #
   # === tell_the_user_what_we_seek
+  #
+  # This method notifies the user for which particular program this
+  # class will try to obtain the associated homepage.
   # ========================================================================= #
   def tell_the_user_what_we_seek(
       be_verbose = be_verbose?
     )
     if be_verbose
-      opne "Seeking URLs to `#{sfancy(search_for?)}` next."
+      opne "Seeking URLs to `#{sfancy(search_for?)}#{rev}` next."
     end
   end
 
+  # ========================================================================= #
+  # === determine_dataset
+  #
+  # This method will also set the @dataset variable.
+  # ========================================================================= #
+  def determine_dataset(
+      search_for = search_for?
+    )
+    if RBT.does_include?(search_for) # In this case, we can search for it.
+      @dataset = RBT::Cookbooks::SanitizeCookbook.new(search_for) { :fast }
+    else # Else it was not included.
+      opne "The search_term `#{sfancy(search_for)}` is not included."
+      exit
+    end
+  end
+
+  # ========================================================================= #
+  # === set_search_for
+  # ========================================================================= #
+  def set_search_for(i)
+    @internal_hash[:search_for] = i
+  end
+
+  # ========================================================================= #
+  # === use_this_as_xorg_buffer
+  #
+  # This method has to account for "xsel" existing or not.
+  # ========================================================================= #
+  def use_this_as_xorg_buffer(i)
+    set_xorg_buffer(i)
+  end
+
   # ========================================================================= #
   # === feedback_urls
   # ========================================================================= #
   def feedback_urls
     if url1?.nil? or url1?.empty?
       e "url.rb: We did not find `"+search_for?+"`." if be_verbose?
-    else 
+    else
       use_this_as_xorg_buffer(url1?)
       result = ''.dup
       if @show_leading_url_entry
@@ -296,36 +331,6 @@ class Url < Base # === RBT::Cookbooks::Url
     e
   end
 
-  # ========================================================================= #
-  # === determine_dataset
-  #
-  # This method will also set the @dataset variable.
-  # ========================================================================= #
-  def determine_dataset(
-      search_for = search_for?
-    )
-    if RBT.does_include?(search_for) # In this case, we can search for it.
-      @dataset = RBT::Cookbooks::SanitizeCookbook.new(search_for) { :fast }
-    else # Else it was not included.
-      opne "The search_term `#{sfancy(search_for)}` is not included."
-      exit
-    end
-  end
-
-  # ========================================================================= #
-  # === set_search_for
-  # ========================================================================= #
-  def set_search_for(i)
-    @internal_hash[:search_for] = i
-  end
-
-  # ========================================================================= #
-  # === use_this_as_xorg_buffer
-  # ========================================================================= #
-  def use_this_as_xorg_buffer(i)
-    set_xorg_buffer(i)
-  end
-
   # ========================================================================= #
   # === run
   # ========================================================================= #

data/lib/rbt/version/version.rb

@@ -13,7 +13,7 @@ module RBT
   # just an alias to it - stick to using VERSION instead "officially"
   # whenever possible.
   # ========================================================================= #
-  VERSION = '0.11.118'
+  VERSION = '0.13.27'
     RBT_VERSION_NUMBER = VERSION # === RBT_VERSION_NUMBER
     PROGRAM_VERSION    = VERSION # === PROGRAM_VERSION
 
@@ -23,7 +23,7 @@ module RBT
   # This specifies when the RBT project was last updated. It should be
   # updated whenever the VERSION constant changes.
   # ========================================================================= #
-  LAST_UPDATE = '29.05.2023' # ← Keep this constant in DD.MM.YYYY notation.
+  LAST_UPDATE = '04.12.2023' # ← Keep this constant in DD.MM.YYYY notation.
 
   # ========================================================================= #
   # === URL_TO_THE_DOCUMENTATION