rbt 0.16.12 → 0.16.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f86d42b8090c0099987e6a75598a35bd480e4e1a33f49dc5d6b1ba886f8ebb62
-  data.tar.gz: 853a3f84bfe87858cf3700a833cc442afa03c1f0f26cae6e1fbbb12c6666eac8
+  metadata.gz: 35235690bbf8442083fabf545236ba3295c12ea5c52c325c82a3807f8df67e51
+  data.tar.gz: e3e598dc3eb898558155b26abd0ce45b2a424828f1da84d8e706559ce70ac15f
 SHA512:
-  metadata.gz: 591a06bf3c25eee4425927add0a77fe7feecd6ca7fb8a216fc3513bbc97149d8d17e2e08c7244ca23c01781fa5ef30be1c6eab8dfe6f064ddab86b5c05b6142b
-  data.tar.gz: 802f90648be8f5dcef15d0147d51309ea4128898f9ec19b3bf8355f365344caa25242698b584c0cb236bd09951867d801ba30a9876fb8be7ef9d78905ed1acbc
+  metadata.gz: c26486d7c7b9798ec1b24abc4833839e3ea77cf252702374ebd1730525037e9713ff11e38d5b18f672939ba7205dda09c1265f05c096d74a2a503462034670b9
+  data.tar.gz: 11c6044995974aab323c5243c3f8d42e1bb28439baa0520d866b23eb4214e49ed822ba84faf4834e8c281f56f1fb805b93323d9e0872114ae3794f85496976be

data/README.md

@@ -5,7 +5,7 @@
 [![forthebadge](https://forthebadge.com/images/badges/made-with-ruby.svg)](https://www.ruby-lang.org/en/)
 [![Gem Version](https://badge.fury.io/rb/rbt.svg)](https://badge.fury.io/rb/rbt)
 
-This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">02.04.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">22:55:05</span> o'clock.
+This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">03.04.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">00:37:58</span> o'clock.
 
 ## Introduction to the "Ruby Build Tools" Project (RBT)
 

data/lib/rbt/actions/actions.rb

@@ -39,6 +39,24 @@ module RBT
     # ======================================================================= #
     case action_that_is_desired # (case tag)
     # ======================================================================= #
+    # === :show_manual_steps
+    #
+    # Commandline usage example:
+    #
+    #   raction show_manual_steps glibc
+    #
+    # ======================================================================= #
+    when :show_manual_steps,
+         :ShowManualSteps
+      require 'rbt/actions/individual_actions/show_manual_steps/show_manual_steps.rb'
+      RBT.show_manual_steps(_)
+    # ======================================================================= #
+    # === :run_meson_configure_step
+    # ======================================================================= #
+    when :run_meson_configure_step
+      require 'rbt/toplevel_methods/meson.rb'
+      return RBT.run_meson_configure_step(_, &block)
+    # ======================================================================= #
     # === :prefix_object
     # ======================================================================= #
     when :prefix_object,
@@ -186,12 +204,6 @@ module RBT
       require 'rbt/toplevel_methods/toplevel_methods.rb'
       RBT.consider_changing_the_tab_title(_, &block)
     # ======================================================================= #
-    # === :run_meson_configure_step
-    # ======================================================================= #
-    when :run_meson_configure_step
-      require 'rbt/toplevel_methods/meson.rb'
-      return RBT.run_meson_configure_step(_, &block)
-    # ======================================================================= #
     # === :cmake
     # ======================================================================= #
     when :cmake,
@@ -769,17 +781,6 @@ module RBT
       require 'rbt/utility_scripts/remove_empty_directories.rb'
       RBT.remove_empty_directories(_)
     # ======================================================================= #
-    # === :show_manual_steps
-    #
-    # Commandline usage example:
-    #
-    #   raction show_manual_steps glibc
-    #
-    # ======================================================================= #
-    when :show_manual_steps
-      require 'rbt/utility_scripts/show_manual_steps.rb'
-      RBT.show_manual_steps(_)
-    # ======================================================================= #
     # === :chain_compile
     #
     # Invocation example:

data/lib/rbt/actions/individual_actions/installer/aggregate.rb

@@ -1,5 +1,116 @@
 class OBSOLETE
 
+  # ========================================================================= #
+  # === invoke_extracter
+  #
+  # Delegate towards class Extracter next.
+  # ========================================================================= #
+  def invoke_extracter(
+      i                                   = program_path?,
+      extract_to_this_directory           = extract_where_to?,
+      keep_the_old_directory_if_it_exists = false
+    )
+    
+    case extract_to_this_directory
+    when nil
+      extract_to_this_directory = will_be_extracted_towards?
+      @internal_hash[:extract_to_this_directory_as_specified_by_the_user] =
+        extract_to_this_directory
+      set_extract_to_this_directory(extract_to_this_directory)
+    end
+    yielded = nil
+    case keep_the_old_directory_if_it_exists # case tag.
+    # ======================================================================= #
+    # === :do_keep_the_old_directory_if_it_exists,
+    # ======================================================================= #
+    when :do_keep_the_old_directory_if_it_exists,
+         :keep_the_old_directory_if_it_exists
+      keep_the_old_directory_if_it_exists = true
+    end
+    # ======================================================================= #
+    # === Handle blocks given to this method next:
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :keep_the_old_directory_if_it_exists
+      # ===================================================================== #
+      when :keep_the_old_directory_if_it_exists
+        keep_the_old_directory_if_it_exists = true
+      else
+        # =================================================================== #
+        # === Handle Hashes next
+        # =================================================================== #
+        if yielded.is_a? Hash
+          # ================================================================= #
+          # === :append_to_the_commandline
+          # ================================================================= #
+          if yielded.has_key? :append_to_the_commandline
+            append_to_the_commandline << yielded[:append_to_the_commandline]
+          end
+        end
+      end
+    end
+    unless skip_extracting?
+      case extract_to_this_directory
+      # ===================================================================== #
+      # === :default
+      # ===================================================================== #
+      when :default
+        extract_to_this_directory = will_be_extracted_towards?
+      end
+      # ===================================================================== #
+      # Remove the extracted directory if it exists next. This will,
+      # however had, NOT be done if we extract to another target
+      # directory, such as when issuing a command like
+      # "ry htop --extract-to=/opt/test".
+      # ===================================================================== #
+      # possibly_existing_old_extracted_archive = cookbooks_dataset_extracted_towards?
+      # unless possibly_existing_old_extracted_archive.include? extract_to?
+        # =================================================================== #
+        # In this case we reasonably assume that the user has NOT given a
+        # --extract-to value.
+        #
+        # Keep in mind that the user may specify another temp-directory,
+        # which explains the check for user-input.
+        # =================================================================== #
+        if cookbooks_for? and !keep_the_old_directory_if_it_exists
+          _ = will_be_extracted_towards?
+          if @internal_hash.has_key?(:extract_to_this_directory_as_specified_by_the_user) and
+             @internal_hash[:extract_to_this_directory_as_specified_by_the_user]
+            _ = @internal_hash[:extract_to_this_directory_as_specified_by_the_user]
+          end
+          unless (_.squeeze('/').strip == '/') # Prevent erroneous removal of /.
+            if File.directory?(_)
+              _ = _.dup if _.frozen?
+              if (_ == rbt_log_dir?)
+                opnerror 'A problem was encountered, but this should never happen.'
+                opnerror 'RBT::Action::SoftwareManager tried to remove the base directory at '+
+                         sdir(rbt_log_dir?)
+                opnerror 'which was the same as the passed directory `'+sdir(_)+'`.'
+                e
+                opnerror 'Something must be wrong in the information-chain, such as a'
+                opnerror 'faulty .yml file. Please review the information shown above'
+                opnerror 'and make sure that the used .yml file is correct.'
+                e
+                exit_program { :exit_no_matter_what }
+              else
+                _.strip!
+                _.squeeze!('/')
+                # =========================================================== #
+                # Notify the user that we will remove the old directory next.
+                # =========================================================== #
+                notify_the_user_that_this_old_directory_will_be_removed_next(_)
+                remove_directory(_)
+              end
+            end
+          end
+        end
+      # end
+    end
+  end
+
   # ========================================================================= #
   # === run_system_or_ioparser_command                            (iopen tag)
   #
@@ -363,7 +474,6 @@ class OBSOLETE
        alias determine_which_programs_to_compile set_install_these_programs # === determine_which_programs_to_compile
        alias set_work_on_this_program            set_install_these_programs # === set_work_on_this_program
 
-
   # ========================================================================= #
   # === parse_this_line_obtained_via_io_popen          (io-open tag, sys tag)
   #
@@ -627,115 +737,4 @@ class OBSOLETE
   end; alias run_make_command                            run_make # === run_make_command
        alias considering_running_make_command_via_system run_make # === considering_running_make_command_via_system
 
-  # ========================================================================= #
-  # === invoke_extracter
-  #
-  # Delegate towards class Extracter next.
-  # ========================================================================= #
-  def invoke_extracter(
-      i                                   = program_path?,
-      extract_to_this_directory           = extract_where_to?,
-      keep_the_old_directory_if_it_exists = false
-    )
-    
-    case extract_to_this_directory
-    when nil
-      extract_to_this_directory = will_be_extracted_towards?
-      @internal_hash[:extract_to_this_directory_as_specified_by_the_user] =
-        extract_to_this_directory
-      set_extract_to_this_directory(extract_to_this_directory)
-    end
-    yielded = nil
-    case keep_the_old_directory_if_it_exists # case tag.
-    # ======================================================================= #
-    # === :do_keep_the_old_directory_if_it_exists,
-    # ======================================================================= #
-    when :do_keep_the_old_directory_if_it_exists,
-         :keep_the_old_directory_if_it_exists
-      keep_the_old_directory_if_it_exists = true
-    end
-    # ======================================================================= #
-    # === Handle blocks given to this method next:
-    # ======================================================================= #
-    if block_given?
-      yielded = yield
-      case yielded
-      # ===================================================================== #
-      # === :keep_the_old_directory_if_it_exists
-      # ===================================================================== #
-      when :keep_the_old_directory_if_it_exists
-        keep_the_old_directory_if_it_exists = true
-      else
-        # =================================================================== #
-        # === Handle Hashes next
-        # =================================================================== #
-        if yielded.is_a? Hash
-          # ================================================================= #
-          # === :append_to_the_commandline
-          # ================================================================= #
-          if yielded.has_key? :append_to_the_commandline
-            append_to_the_commandline << yielded[:append_to_the_commandline]
-          end
-        end
-      end
-    end
-    unless skip_extracting?
-      case extract_to_this_directory
-      # ===================================================================== #
-      # === :default
-      # ===================================================================== #
-      when :default
-        extract_to_this_directory = will_be_extracted_towards?
-      end
-      # ===================================================================== #
-      # Remove the extracted directory if it exists next. This will,
-      # however had, NOT be done if we extract to another target
-      # directory, such as when issuing a command like
-      # "ry htop --extract-to=/opt/test".
-      # ===================================================================== #
-      # possibly_existing_old_extracted_archive = cookbooks_dataset_extracted_towards?
-      # unless possibly_existing_old_extracted_archive.include? extract_to?
-        # =================================================================== #
-        # In this case we reasonably assume that the user has NOT given a
-        # --extract-to value.
-        #
-        # Keep in mind that the user may specify another temp-directory,
-        # which explains the check for user-input.
-        # =================================================================== #
-        if cookbooks_for? and !keep_the_old_directory_if_it_exists
-          _ = will_be_extracted_towards?
-          if @internal_hash.has_key?(:extract_to_this_directory_as_specified_by_the_user) and
-             @internal_hash[:extract_to_this_directory_as_specified_by_the_user]
-            _ = @internal_hash[:extract_to_this_directory_as_specified_by_the_user]
-          end
-          unless (_.squeeze('/').strip == '/') # Prevent erroneous removal of /.
-            if File.directory?(_)
-              _ = _.dup if _.frozen?
-              if (_ == rbt_log_dir?)
-                opnerror 'A problem was encountered, but this should never happen.'
-                opnerror 'RBT::Action::SoftwareManager tried to remove the base directory at '+
-                         sdir(rbt_log_dir?)
-                opnerror 'which was the same as the passed directory `'+sdir(_)+'`.'
-                e
-                opnerror 'Something must be wrong in the information-chain, such as a'
-                opnerror 'faulty .yml file. Please review the information shown above'
-                opnerror 'and make sure that the used .yml file is correct.'
-                e
-                exit_program { :exit_no_matter_what }
-              else
-                _.strip!
-                _.squeeze!('/')
-                # =========================================================== #
-                # Notify the user that we will remove the old directory next.
-                # =========================================================== #
-                notify_the_user_that_this_old_directory_will_be_removed_next(_)
-                remove_directory(_)
-              end
-            end
-          end
-        end
-      # end
-    end
-  end
-
 end

data/lib/rbt/{utility_scripts → actions/individual_actions/show_manual_steps}/show_manual_steps.rb

@@ -2,27 +2,24 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === RBT::ShowManualSteps
+# === RBT::Action::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)
-# RBT.show_manual_steps
+# require 'rbt/actions/individual_actions/show_manual_steps/show_manual_steps.rb'
+# RBT::Action::ShowManualSteps.new(ARGV)
+# RBT.show_manual_steps(ARGV)
 # =========================================================================== #
-require 'rbt/base/base.rb'
+require 'rbt/actions/action.rb'
 
 module RBT
 
-class ShowManualSteps < Base # === RBT::ShowManualSteps
+class Action
+
+class ShowManualSteps < RBT::Action # === RBT::Action::ShowManualSteps
 
   require 'rbt/requires/require_the_cookbook_class.rb'
 
@@ -92,7 +89,7 @@ class ShowManualSteps < Base # === RBT::ShowManualSteps
     new(i)
   end; self.instance_eval { alias [] of } # === ShowManualSteps[]
 
-end
+end; end
 
 # =========================================================================== #
 # === RBT.show_manual_steps
@@ -102,14 +99,14 @@ end
 #   RBT.show_manual_steps(:kde5_plasma)
 #
 # =========================================================================== #
-def self.show_manual_steps(of = ARGV)
+def self.show_manual_steps(of = ARGV, &block)
   [of].flatten.compact.each {|this_program|
-    RBT::ShowManualSteps.new(this_program)
+    RBT::ShowManualSteps.new(this_program, &block)
   }
 end
 
 end
 
 if __FILE__ == $PROGRAM_NAME
-  RBT::ShowManualSteps.new(ARGV)
+  RBT.show_manual_steps(ARGV)
 end # showmanualsteps glibc

data/lib/rbt/actions/individual_actions/software_manager/actions.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rbt/actions/individual_actions/software_manager/actions.rb'
+# =========================================================================== #
+require 'rbt/actions/action.rb'
+
+module RBT
+
+class Action
+
+class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
+
+  # ========================================================================= #
+  # === action_generate_a_big_shell_script
+  # ========================================================================= #
+  def action_generate_a_big_shell_script
+    action(:generate_a_big_shell_script)
+  end
+
+  # ========================================================================= #
+  # === return_xfce_components
+  # ========================================================================= #
+  def return_xfce_components
+    action(:return_xfce_components)
+  end
+
+  # ========================================================================= #
+  # === generate_shell_completion
+  #
+  # Generates shell completion code. Right now it will only work for Bash.
+  #
+  # Invocation example:
+  #
+  #   ry --generate_shell_completion
+  #
+  # ========================================================================= #
+  def generate_shell_completion(
+      for_this_shell = :all
+    )
+    action(:GenerateShellCompletion, for_this_shell)
+  end
+
+  # ========================================================================= #
+  # === show_the_n_last_updated_programs
+  # ========================================================================= #
+  def show_the_n_last_updated_programs(
+      i = 875
+    )
+    action(:ShowLastUpdated, display_n_programs: i)        
+  end
+
+  # ========================================================================= #
+  # === backup_program
+  #
+  # Backup an existingp rogram under the /Programs/ hierarchy.
+  # ========================================================================= #
+  def backup_program(
+      i = compile_which_program?
+    )
+    action(:backup_program, i)
+  end
+
+  # ========================================================================= #
+  # === create_programs_url_file
+  # ========================================================================= #
+  def create_programs_url_file
+    action(__method__.to_sym)
+  end
+
+end; end; end

data/lib/rbt/actions/individual_actions/software_manager/menu.rb

@@ -37,6 +37,66 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     else
       case i # (case tag, cas tag)
       # ===================================================================== #
+      # === Generate a big shell script
+      #
+      # This entry point can be used to quickly generate the big
+      # shell script file that contains all programs versions as
+      # UPPERCASED variable, with an appended 'V'. So for example,
+      # BASHV would have a value of 5.0 or so, depending on the
+      # current version of bash registered in the rbt project.
+      #
+      # Invocation example:
+      #
+      #   ry --shellscript
+      #
+      # ===================================================================== #
+      when /^-?-?shellscript$/i
+        action_generate_a_big_shell_script
+        exit_program
+      # ===================================================================== #
+      # === Show all Installed Programs, via a ruby-gtk3 widget
+      #
+      # Invocation example:
+      #
+      #   rbt --installed-programs
+      #
+      # ===================================================================== #
+      when /^-?-?installed(-|_| )?programs$/i,
+           /^-?-?gtk(-|_| )?installed(-|_| )?programs$/i
+        require 'rbt/gui/gtk3/installed_programs/installed_programs.rb'
+        RBT::GUI::Gtk::InstalledPrograms.run
+      # ===================================================================== #
+      # === Start the main libui widget
+      #
+      # This entry point allows the user to start the libui-bindings for
+      # the SQL-centric compilation GUI.
+      #
+      # Invocation example:
+      #
+      #   rbt --libui
+      #
+      # ===================================================================== #
+      when /^-?-?libui$/i
+        require 'rbt/gui/libui/compile_via_sql_database/compile_via_sql_database.rb'
+        RBT::GUI::LibUI::CompileProgram.new
+      # ===================================================================== #
+      # === Use different configure options
+      #
+      # We must allow the user to use a different set of configure options.
+      # This entry point ensures that.
+      #
+      # The user will be able to pass in the configure options specified
+      # in a commandline-flag.
+      #
+      # Invocation examples:
+      #
+      #   ry gcc --use-these-configure-options="--enable-shared --enable-bootstrap --enable-languages=c,c++,lto,objc,fortran --enable-threads=posix --enable-checking=release --enable-objc-gc --with-system-zlib --enable-libstdcxx-dual-abi --with-default-libstdcxx-abi=gcc4-compatible --disable-libunwind-exceptions --enable-__cxa_atexit --enable-libssp --enable-lto --disable-install-libiberty --with-gnu-ld --verbose --with-arch-directory=amd64 --disable-gtktest --disable-multilib --target=x86_64-slackware-linux --build=x86_64-slackware-linux --host=x86_64-slackware-linux"
+      #   ry poppler --use-these-configure-options="--enable-xpdf-headers"
+      #
+      # ===================================================================== #
+      when /^-?-?use(-|_| )?these(-|_| )?configure(-|_| )?options=(.+)$/
+        @internal_hash[:configure_options] = $4.to_s.dup
+      # ===================================================================== #
       # == Non-Traditional compilation                            (ntrad tag)
       #
       # This entry point allows the user to compile the given program in
@@ -3643,23 +3703,6 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
         get_packages
         exit_program
       # ===================================================================== #
-      # === Use different configure options
-      #
-      # We must allow the user to use a different set of configure options.
-      # This entry point ensures that.
-      #
-      # The user will be able to pass in the configure options specified
-      # in a commandline-flag.
-      #
-      # Invocation examples:
-      #
-      #   ry gcc --use-these-configure-options="--enable-shared --enable-bootstrap --enable-languages=c,c++,lto,objc,fortran --enable-threads=posix --enable-checking=release --enable-objc-gc --with-system-zlib --enable-libstdcxx-dual-abi --with-default-libstdcxx-abi=gcc4-compatible --disable-libunwind-exceptions --enable-__cxa_atexit --enable-libssp --enable-lto --disable-install-libiberty --with-gnu-ld --verbose --with-arch-directory=amd64 --disable-gtktest --disable-multilib --target=x86_64-slackware-linux --build=x86_64-slackware-linux --host=x86_64-slackware-linux"
-      #   ry poppler --use-these-configure-options="--enable-xpdf-headers"
-      #
-      # ===================================================================== #
-      when /^-?-?use(-|_| )?these(-|_| )?configure(-|_| )?options=(.+)$/
-        @internal_hash[:configure_options] = $4.to_s.dup
-      # ===================================================================== #
       # === Enable pkgconfig-symlinks
       #
       # This option exists in order to allow, on the commandline, to
@@ -7217,48 +7260,6 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
         display_postinstall_dataset
         exit_program
       # ===================================================================== #
-      # === Generate a big shell script
-      #
-      # This entry point can be used to quickly generate the big
-      # shell script file that contains all programs versions as
-      # UPPERCASED variable, with an appended 'V'. So for example,
-      # BASHV would have a value of 5.0 or so, depending on the
-      # current version of bash registered in the rbt project.
-      #
-      # Invocation example:
-      #
-      #   ry --shellscript
-      #
-      # ===================================================================== #
-      when /^-?-?shellscript$/i
-        action(:generate_a_big_shell_script)
-      # ===================================================================== #
-      # === Show all Installed Programs, via a ruby-gtk3 widget
-      #
-      # Invocation example:
-      #
-      #   rbt --installed-programs
-      #
-      # ===================================================================== #
-      when /^-?-?installed(-|_| )?programs$/i,
-           /^-?-?gtk(-|_| )?installed(-|_| )?programs$/i
-        require 'rbt/gui/gtk3/installed_programs/installed_programs.rb'
-        RBT::GUI::Gtk::InstalledPrograms.run
-      # ===================================================================== #
-      # === Start the main libui widget
-      #
-      # This entry point allows the user to start the libui-bindings for
-      # the SQL-centric compilation GUI.
-      #
-      # Invocation example:
-      #
-      #   rbt --libui
-      #
-      # ===================================================================== #
-      when /^-?-?libui$/i
-        require 'rbt/gui/libui/compile_via_sql_database/compile_via_sql_database.rb'
-        RBT::GUI::LibUI::CompileProgram.new
-      # ===================================================================== #
       # === Show all available programs
       #
       # This entry point allows the user to display all available programs,