rbt 0.16.12 → 0.16.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f86d42b8090c0099987e6a75598a35bd480e4e1a33f49dc5d6b1ba886f8ebb62
-  data.tar.gz: 853a3f84bfe87858cf3700a833cc442afa03c1f0f26cae6e1fbbb12c6666eac8
+  metadata.gz: 6d68b8e42329fbaeddd1975b0517ed3c6536d129e16d03ef1fbb05de575fa70f
+  data.tar.gz: b0d4756fca9cb94a742b298c70e4bc94b5ec8b02667e6ea4752ee84ecf725bfa
 SHA512:
-  metadata.gz: 591a06bf3c25eee4425927add0a77fe7feecd6ca7fb8a216fc3513bbc97149d8d17e2e08c7244ca23c01781fa5ef30be1c6eab8dfe6f064ddab86b5c05b6142b
-  data.tar.gz: 802f90648be8f5dcef15d0147d51309ea4128898f9ec19b3bf8355f365344caa25242698b584c0cb236bd09951867d801ba30a9876fb8be7ef9d78905ed1acbc
+  metadata.gz: 7232181835ccc0e708f15f4ed072a39f39284fa7ac67a853190b2072f3ef0298c87aae3faa4082e426122d9253aee1429d07796ba9d571554101956b9d0c5667
+  data.tar.gz: 3160f3f569c3228bf5d42032a4028a418a4237797077e72e99b333f2938ffd8f9a776401534a882ed2680ab165a3ae39f74dc6c2636e8e0100120e4335f58273

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">06:07:40</span> o'clock.
 
 ## Introduction to the "Ruby Build Tools" Project (RBT)
 
@@ -110,7 +110,7 @@ long run.
 
 Let us now briefly explain how RBT approaches compiling from a source
 archive: after all that is <b>the main goal for the</b> 
-<span style="color: darkgreen; font-weight: bold">RBT project?</span></b>.
+<span style="color: darkgreen; font-weight: bold">RBT project</span></b>.
 
 Let's take any random remote URL to some tarball archive, 
 such as the <b>.tar.xz file</b> for <b>evince</b> that may

data/doc/README.gen

@@ -106,7 +106,7 @@ long run.
 
 Let us now briefly explain how RBT approaches compiling from a source
 archive: after all that is <b>the main goal for the</b> 
-<span style="color: darkgreen; font-weight: bold">RBT project?</span></b>.
+<span style="color: darkgreen; font-weight: bold">RBT project</span></b>.
 
 Let's take any random remote URL to some tarball archive, 
 such as the <b>.tar.xz file</b> for <b>evince</b> that may

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/create_app_dir_skeleton/create_app_dir_skeleton.rb

@@ -494,7 +494,7 @@ class CreateAppDirSkeleton < RBT::Action # === RBT::Action::CreateAppDirSkeleton
   def notify_the_user_what_will_be_done
     opnn; ee sfancy(return_program_name_and_program_version.downcase)
     if be_verbose?
-      ee " #{rev}(#{simp('Program name')}: #{sfancy(program_name?)}"\
+      ee " #{rev}(#{simp('Program name')}#{rev}: #{sfancy(program_name?)}"\
          "#{rev} and #{simp('Program Version')}#{rev}: "\
          "#{sfancy(program_version?)}#{rev})"
     end

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

@@ -1,5 +1,33 @@
 class OBSOLETE
 
+  def invoke_extracter
+      # ===================================================================== #
+      # 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".
+      #^^^^ this must be ported still.
+      # ===================================================================== #
+      # 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
+      # end
+    end
+  end
+
   # ========================================================================= #
   # === run_system_or_ioparser_command                            (iopen tag)
   #
@@ -363,7 +391,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 +654,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/extract_related_code.rb

@@ -24,10 +24,27 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
   def extract_what_to(
       local_path                                                = cookbook_dataset_program_path?,
       extract_to_this_directory                                 = extract_where_to?,
-      shall_we_report_to_the_user_if_the_archive_does_not_exist = true # This should come last.
+      shall_we_report_to_the_user_if_the_archive_does_not_exist = true, # This should come last.
+      &block
     )
     append_to_the_commandline = ''.dup
     # ======================================================================== #
+    # === Handle blocks next
+    # ======================================================================== #
+    if block_given?
+      # ====================================================================== #
+      # === 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
+    # ======================================================================== #
     # === Handle Hashes next
     # ======================================================================== #
     if local_path.is_a? Hash
@@ -41,9 +58,9 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     local_path = local_path.to_s # Past this point we need a String.
     if local_path and File.exist?(local_path)
       if run_simulation?
-        # =================================================================== #
+        # ====================================================================== #
         # Here we are in simulation-mode:
-        # =================================================================== #
+        # ====================================================================== #
         orev "We would normally extract `#{sfile(local_path)}#{rev}` "\
              "to #{sdir(extract_to_this_directory)} #{rev}next,"
         orev 'but since we run in simulation-mode, we will not '\
@@ -53,12 +70,12 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
         _ << " #{rev}(but do so silently)" unless show_output_from_the_extracter_class?
         _ << '.'
         orev _
-        # =================================================================== #
+        # ====================================================================== #
         # Extracting the archive next, via an action - this will be handled
         # by class Extracter. The second argument is a Hash which will
         # typically carry a lot of information. This is necessary because
         # we want to "fine-tune" Extracter at this step.
-        # =================================================================== #
+        # ====================================================================== #
         action(:extract_what_to, local_path,
           {
             extract_to:                     extract_to_this_directory, # ← Extract to this directory.
@@ -71,10 +88,10 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
             append_this_to_the_commandline: append_to_the_commandline,
           }
         ) { :be_quiet }
-        # =================================================================== #
+        # ====================================================================== #
         # Next we will exit if the user told us that he/she is only
         # interested in extracting the program.
-        # =================================================================== #
+        # ====================================================================== #
         exit_program if extract_only?
         return extract_to_this_directory # And return it too, in case downstream code needs it.
       end
@@ -83,9 +100,9 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
         opne swarn('No file could be found at `')+
              sfile(local_path)+swarn('` - thus,')
         opne swarn('we can not extract anything.')
-        # =================================================================== #
+        # ====================================================================== #
         # Also set a specific error, so that we won't continue.
-        # =================================================================== #
+        # ====================================================================== #
         # error_is 'We can not continue. Has the archive '\
         #          'been properly extracted?'
       end