rbt 0.16.13 → 0.16.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35235690bbf8442083fabf545236ba3295c12ea5c52c325c82a3807f8df67e51
-  data.tar.gz: e3e598dc3eb898558155b26abd0ce45b2a424828f1da84d8e706559ce70ac15f
+  metadata.gz: 650fe74758b23b34d56386d771c4f553acd3be566ca41532fd6406129fff3610
+  data.tar.gz: ee17ad81a638b5f0d5dfdf5fb497fb14fb510c7c2b1588c03896ce39f580e07b
 SHA512:
-  metadata.gz: c26486d7c7b9798ec1b24abc4833839e3ea77cf252702374ebd1730525037e9713ff11e38d5b18f672939ba7205dda09c1265f05c096d74a2a503462034670b9
-  data.tar.gz: 11c6044995974aab323c5243c3f8d42e1bb28439baa0520d866b23eb4214e49ed822ba84faf4834e8c281f56f1fb805b93323d9e0872114ae3794f85496976be
+  metadata.gz: c371c9a20d8573e217b3a03095d5ea58b1b3c527c27f68412592f73e8755656318ed03235dc6c89eac0dd9834b806eb42d1815c3e60a6a6122ae321e8e3552d2
+  data.tar.gz: 92850591bc2a12399f7c9fd5c6937e37524e95ab9ee2b4d4f8084c1e31f205ce4dff8837b5a610328508160407774fb1b2e36bbfd1fff24aa67fb6c8bebb3f3e

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">03.04.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">00:37:58</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">08:43:26</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
@@ -11141,7 +11141,7 @@ caribou                   0.4.20       16 February 2016 http://ftp.gnome.org/pub
 castlecombat              0.8.1        28 July 2016 http://prdownloads.sourceforge.net/castle-combat/castle-combat-0.8.1.tar.gz
 caxlsx                    3.2.0        27 May 2022  https://rubygems.org/downloads/caxlsx-3.2.0.gem
 cbase                     1.3.7        28 September 2019 http://www.hyperrealm.com/packages/cbase-1.3.7.tar.gz
-cbindgen                  0.24.3       11 September 2022 https://github.com/eqrion/cbindgen/archive/v0.24.3/cbindgen-0.24.3.tar.gz
+cbindgen                  0.26.0       11 September 2022 https://github.com/mozilla/cbindgen/archive/refs/tags/0.26.0.tar.gz
 ccache                    4.8.2        14 June 2023 https://github.com/ccache/ccache/releases/download/v4.8.2/ccache-4.8.2.tar.gz
 ccaudio2                  2.2.0        19 March 2019 http://ftp.gnu.org/pub/gnu/ccaudio/ccaudio2-2.2.0.tar.gz
 ccmath                    2.2.1        01 June 2014 http://www.ibiblio.org/pub/Linux/libs/ccmath-2.2.1.tar.gz
@@ -13697,7 +13697,7 @@ qqc2desktopstyle          5.115.0      20 February 2024 https://download.kde.org
 qqwing                    1.3.4        09 August 2015 https://github.com/stephenostermiller/qqwing/archive/v1.3.4.zip
 qrencode                  4.1.1        22 December 2021 https://fukuchi.org/works/qrencode/qrencode-4.1.1.tar.bz2
 qsynth                    0.5.5        16 March 2019 https://downloads.sourceforge.net/qsynth/qsynth-0.5.5.tar.gz
-qt                        6.6.3        25 March 2024 https://download.qt-project.org/official_releases/qt/6.5/6.5.0/single/qt-everywhere-6.5.0.tar.xz
+qt                        6.6.3        02 April 2024 https://download.qt-project.org/official_releases/qt/6.7/6.7.0/single/qt-everywhere-6.7.0.tar.xz
 qterminal                 1.1.0        30 August 2022 https://github.com/lxqt/qterminal/releases/download/1.1.0/qterminal-1.1.0.tar.xz
 qtermwidget               1.4.0        02 February 2024 https://github.com/lxqt/qtermwidget/releases/download/1.4.0/qtermwidget-1.4.0.tar.xz
 qtgstreamer               1.2.0        10 July 2015 http://gstreamer.freedesktop.org/src/qt-gstreamer/qt-gstreamer-1.2.0.tar.xz
@@ -14334,7 +14334,7 @@ wlassistant               0.5.7        01 May 2014  http://wlassistant.sourcefor
 wmctrl                    1.07         01 May 2014  http://www.sweb.cz/tripie/utils/wmctrl/dist/wmctrl-1.07.tar.gz
 wmii                      3            01 May 2014  http://www.suckless.org/snaps/wmii-20071003.tgz
 woff2                     1.0.2        22 December 2021 https://github.com/google/woff2/archive/v1.0.2/woff2-1.0.2.tar.gz
-wordpress                 5.9.1        23 February 2022 https://wordpress.org/wordpress-5.9.1.tar.gz
+wordpress                 6.5          03 April 2024 https://wordpress.org/wordpress-6.5.tar.gz
 worker                    4.7.0        10 March 2021 http://www.boomerangsworld.de/cms/worker/downloads/worker-4.7.0.tar.bz2
 wpasupplicant             2.10         11 October 2022 https://w1.fi/releases/wpa_supplicant-2.10.tar.gz
 wpebackendfdo             1.14.2       03 April 2023 https://wpewebkit.org/releases/wpebackend-fdo-1.14.2.tar.xz

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/doc/todo/numbered_todo_entries_for_the_RBT_project.md

@@ -1,18 +1,6 @@
 --------------------------------------------------------------------------------
-(1) → Expand RBT.action() until we have listed ALL actions there.
-      Evaluate at some point in the future when this will be
-      achieved.
-      ^^^ continue here. All bin/ files are now executable, since as
-      of September 2022. But we probably should add even more
-      actions here, in particular several troublemaking
-      steps within RBT::Compile.
-      Then also look at menu.rb of class RBT::Compile to see which
-      individual tasks can be made "actionable" still.
-      Once that is all done, perhaps in 2023 or so,
-      remove this todo entry here.
-      Ok, bin/ is now complete, we must go through menu() still
-      and see.
-      ^^^ we are doing this RIGHT NOW.
+(1) always work on an Array for compiling something in RBT.
+^^^
 --------------------------------------------------------------------------------
 (2) → Handle these commandline instructions, which originated from the old
       class RBT::Commandline but are not yet completely ported:

data/lib/rbt/actions/individual_actions/cookbooks/sanitize_cookbook/sanitize_cookbook.rb

@@ -4260,11 +4260,6 @@ class SanitizeCookbook < RBT::Action # === RBT::Action::Cookbooks::SanitizeCookb
     when /^program(-|_| )?name(-|_| )?and(-|_| )?program(-|_| )?version\??$/i
       program_name_and_program_version?
     # ======================================================================= #
-    # === extract_to?
-    # ======================================================================= #
-    when /^extract(-|_| )?to\??$/i
-      extract_to?
-    # ======================================================================= #
     # === "Build system to be used:"
     # ======================================================================= #
     when /^Build(-|_| )?system(-|_| )?to(-|_| )?be(-|_| )?used$/i
@@ -4280,6 +4275,12 @@ class SanitizeCookbook < RBT::Action # === RBT::Action::Cookbooks::SanitizeCookb
     when /^URL(-|_| )?to(-|_| )?the(-|_| )?source(-|_| )?archive$/i
       url_to_the_source_archive?
     # ======================================================================= #
+    # === extract_to?
+    # ======================================================================= #
+    when /^extract(-|_| )?to\??$/i,
+         /^extract(-|_| )?to(-|_| )?which(-|_| )?directory\??$/i  
+      extract_to?
+    # ======================================================================= #
     # === "Keep the archive extracted"
     # ======================================================================= #
     when /^Keep(-|_| )?the(-|_| )?archive(-|_| )?extracted$/i

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,116 +1,5 @@
 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)
   #

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

@@ -12,6 +12,67 @@ class Action
 
 class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
 
+  # ========================================================================== #
+  # === query_configuration_options
+  #
+  # This method will query the configuration option of a given program.
+  #
+  # Invocation example:
+  #
+  #   ry glibc qco
+  #
+  # ========================================================================== #
+  def query_configuration_options(
+      i = compile_this_program?
+    )
+    action(:show_configuration_options, i)
+    exit_program
+  end
+
+  # ========================================================================== #
+  # === check_for_available_versions
+  #
+  # Use this method if you wish to check for available program versions.
+  #
+  # Usage examples:
+  #
+  #   ry bluefish available_versions
+  #   ry gcc available_versions
+  #
+  # ========================================================================== #
+  def check_for_available_versions(
+      for_this_program = program?
+    )
+    action(:CheckForAvailableVersions, for_this_program) { :be_verbose }
+  end
+
+  # ========================================================================== #
+  # === search_for_tag                                           (search tag)
+  #
+  # Use this to search for a tag.
+  #
+  # Usage examples:
+  #
+  #   ry htop --tags pdf
+  #   ry htop --tags term
+  #
+  # ========================================================================== #
+  def search_for_tag(
+      this_tag,
+      shall_we_exit = true
+    )
+    results = action(:SearchForTags, this_tag)
+    exit_program if shall_we_exit
+    return results
+  end
+
+  # ========================================================================== #
+  # === batch_validate_the_cookbooks
+  # ========================================================================== #
+  def batch_validate_the_cookbooks
+    action(:BatchValidateTheCookbookRecipes)
+  end
+
   # ========================================================================= #
   # === action_generate_a_big_shell_script
   # ========================================================================= #

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