rbt 0.11.118 → 0.13.26

data/lib/rbt/actions/individual_actions/action-configure.rb

@@ -0,0 +1,288 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === RBT::Actions::Configure
+#
+# This clas will do all steps necessary for a configure-setup. This will
+# work with GNU configure, cmake and ninja.
+# =========================================================================== #
+# require 'rbt/actions/individual_actions/action_configure.rb'
+# =========================================================================== #
+require 'rbt/compile_base/compile_base.rb'
+
+module RBT
+
+module Actions
+
+class Configure < RBT::CompileBase # === RBT::Actions::Configure
+
+  require 'rbt/cookbooks/sanitize_cookbook/sanitize_cookbook.rb'
+  require 'rbt/toplevel_methods/configure_appdir_prefix.rb'
+  require 'rbt/toplevel_methods/infer_build_system.rb'
+
+  # ========================================================================= #
+  # === REGEX_TO_CAPTURE_THE_PREFIX_FOR_CONFIGURE_BUILD_TYPES
+  # ========================================================================= #
+  REGEX_TO_CAPTURE_THE_PREFIX_FOR_CONFIGURE_BUILD_TYPES = /(--prefix=)([-A-Za-z\/]+)\s/
+
+  # ========================================================================= #
+  # === REGEX_TO_CAPTURE_THE_PREFIX_FOR_CMAKE_BUILD_TYPES
+  # ========================================================================= #
+  REGEX_TO_CAPTURE_THE_PREFIX_FOR_CMAKE_BUILD_TYPES = /-DCMAKE_INSTALL_PREFIX=([\/A-Za-z]+)/
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = ARGV,
+      run_already = true,
+      &block
+    )
+    reset # Must come before set_commandline_arguments().
+    set_commandline_arguments(i)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :be_extra_verbose
+      # ===================================================================== #
+      when :be_extra_verbose
+        @internal_hash[:be_extra_verbose] = true
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === :try_to_use_configure_options
+    # ======================================================================= #
+    @internal_hash[:try_to_use_configure_options] = true
+    # ======================================================================= #
+    # === :be_extra_verbose
+    # ======================================================================= #
+    @internal_hash[:be_extra_verbose] = false
+    # ======================================================================= #
+    # === :build_type_to_use
+    # ======================================================================= #
+    set_build_type_to_use(:configure)
+  end
+
+  # ========================================================================= #
+  # === be_extra_verbose?
+  # ========================================================================= #
+  def be_extra_verbose?
+    @internal_hash[:be_extra_verbose]
+  end
+
+  # ========================================================================= #
+  # === build_type_to_use?
+  # ========================================================================= #
+  def build_type_to_use?
+    @internal_hash[:build_type_to_use]
+  end
+
+  # ========================================================================= #
+  # === set_build_type_to_use
+  # ========================================================================= #
+  def set_build_type_to_use(i)
+    @internal_hash[:build_type_to_use] = i.to_sym # Always use Symblls here.
+  end
+
+  # ========================================================================= #
+  # === build_type_is_configure?
+  # ========================================================================= #
+  def build_type_is_configure?
+    build_type_to_use? == :configure
+  end
+
+  # ========================================================================= #
+  # === build_type_is_cmake?
+  # ========================================================================= #
+  def build_type_is_cmake?
+    build_type_to_use? == :cmake
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments?
+    )
+    if i.is_a? Array
+      i.each {|entry|
+        menu(entry)
+      }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === action-configure --use-cmake
+      # ===================================================================== #
+      when /^-?-?use(-|_)?cmake$/
+        set_build_type_to_use(:cmake)
+      # ===================================================================== #
+      # === action-configure --use-this-version=1.2.3 --statically
+      # ===================================================================== #
+      when /^-?-?statically$/,
+           /^-?-?static$/
+        do_compile_statically
+      # ===================================================================== #
+      # === action-configure --use-this-version=1.2.3
+      # ===================================================================== #
+      when /^-?-?use(-|_)?this(-|_)?version=(.+)$/ # === $3
+        _ = $3.to_s
+        e rev+'Modifying the prefix towards an '+
+          steelblue('AppDir')+' prefix next, using '+
+          'the specified version '+steelblue(_)+'.'
+        new_version = _
+        new_prefix = RBT.return_appdir_prefix(@internal_hash[:program_name]+'-'+new_version)
+        @internal_hash[:sys_command].sub!(
+          REGEX_TO_CAPTURE_THE_PREFIX_FOR_CONFIGURE_BUILD_TYPES,
+          '--prefix='+new_prefix.to_s+' '
+        )
+      # ===================================================================== #
+      # === action-configure --appdir
+      # ===================================================================== #
+      when /^-?-?appdir/,
+           /^-?-?ntrad/
+        if build_type_is_configure?
+          regex_to_use = REGEX_TO_CAPTURE_THE_PREFIX_FOR_CONFIGURE_BUILD_TYPES
+        elsif build_type_is_cmake?
+          regex_to_use = REGEX_TO_CAPTURE_THE_PREFIX_FOR_CMAKE_BUILD_TYPES
+        end
+        e rev+'Modifying the prefix towards an '+steelblue('AppDir')+' prefix next.'
+        new_version = program_version?
+        new_prefix = RBT.return_appdir_prefix(@internal_hash[:program_name]+'-'+new_version)
+        if build_type_is_configure?
+          @internal_hash[:sys_command].sub!(
+            regex_to_use,
+            '--prefix='+new_prefix.to_s
+          )
+        elsif build_type_is_cmake?
+          @internal_hash[:sys_command].sub!(
+            regex_to_use,
+            '-DCMAKE_INSTALL_PREFIX='+new_prefix.to_s
+          )
+        end
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === do_compile_statically
+  # ========================================================================= #
+  def do_compile_statically(
+      be_verbose = true
+    )
+    if be_verbose
+      e "#{rev}Enabling static compilation mode next - at the least trying to."
+    end
+    ENV['CFLAGS'] = ENV['CFLAGS']+' -static -g' # This works as-is; determined in June 2023.
+  end
+
+  # ========================================================================= #
+  # === try_to_use_configure_options?
+  # ========================================================================= #
+  def try_to_use_configure_options?
+    @internal_hash[:try_to_use_configure_options]
+  end
+
+  # ========================================================================= #
+  # === program_version?
+  # ========================================================================= #
+  def program_version?
+    @internal_hash[:program_version]
+  end
+
+  # ========================================================================= #
+  # === do_run_the_sys_command
+  # ========================================================================= #
+  def do_run_the_sys_command(
+      i = @internal_hash[:sys_command] # This is our default here.
+    )
+    if be_extra_verbose?
+      e "#{rev}The current working directory is `#{sdir(return_pwd)}`."
+    end
+    coloured_and_padded_esystem(i) { :dodgerblue }
+  end
+
+  # ========================================================================= #
+  # === automatically_try_to_determine_the_real_build_type
+  # ========================================================================= #
+  def automatically_try_to_determine_the_real_build_type
+    build_system = RBT.infer_build_system
+    case build_system
+    # ======================================================================= #
+    # === cmake
+    # ======================================================================= #
+    when 'cmake'
+      set_build_type_to_use(:cmake)
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    cwd = return_pwd
+    work_on_this_program = File.basename(cwd)
+    @internal_hash[:program_name]    = ProgramInformation.program_name(work_on_this_program)
+    @internal_hash[:program_version] = ProgramInformation.program_version(work_on_this_program)
+    cookbook = RBT.return_cookbook_for(@internal_hash[:program_name])
+    automatically_try_to_determine_the_real_build_type
+    case build_type_to_use?
+    # ======================================================================= #
+    # === :configure
+    # ======================================================================= #
+    when :configure,
+         :default
+      _ = './configure'.dup
+      _ << ' --prefix=/usr/'
+    # ======================================================================= #
+    # === :cmake
+    # ======================================================================= #
+    when :cmake
+      _ = 'cmake'.dup
+      _ << ' -DCMAKE_INSTALL_PREFIX=/usr/'
+    else
+      ewarn 'Unknown build type: '+steelblue(build_type_to_use?)
+      exit
+    end
+    if try_to_use_configure_options?
+      _ << " #{cookbook.configure_options?}"
+      _.rstrip! # We have to do this in case the above returns an empty String.
+    end
+    # ======================================================================= #
+    # Use a build directory in this event.
+    # ======================================================================= #
+    if cookbook.use_build_directory?
+      name_of_the_build_directory = cookbook.name_of_the_build_directory?
+      if name_of_the_build_directory.nil?
+        name_of_the_build_directory = 'BUILD/'
+      end
+      mkdir(name_of_the_build_directory)
+      cd(name_of_the_build_directory)
+      if build_type_is_configure?
+        _.prepend('.')
+      elsif build_type_is_cmake?
+        _ << (' ..')
+      end
+    end
+    @internal_hash[:sys_command] = _
+    menu(commandline_arguments?)
+    do_run_the_sys_command(@internal_hash[:sys_command])
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  RBT::Actions::Configure.new(ARGV) { :be_extra_verbose }
+end # action_configure

data/lib/rbt/base/misc.rb

@@ -669,16 +669,6 @@ class Base # === RBT::Base
     )
   end; alias actions action # === actions
 
-  # ========================================================================= #
-  # === open_in_browser
-  # ========================================================================= #
-  def open_in_browser(i)
-    begin
-      require 'open'
-      Open.in_browser(i)
-    rescue LoadError; end
-  end
-
   # ========================================================================= #
   # === is_github_url?
   #
@@ -824,4 +814,14 @@ class Base # === RBT::Base
     array.include?(i.to_s)
   end
 
+  # ========================================================================= #
+  # === open_in_browser
+  # ========================================================================= #
+  def open_in_browser(i)
+    begin
+      require 'open'
+      Open.in_browser(i)
+    rescue LoadError; end
+  end
+
 end; end

data/lib/rbt/base/prototype/colours.rb

@@ -13,7 +13,7 @@ class Base # === RBT::Base
   # ========================================================================= #
   # === ALL_COLOUR_METHODS
   # ========================================================================= #
-  ALL_COLOUR_METHODS = ::Colours::AllColourMethods
+  ALL_COLOUR_METHODS = ::Colours::HtmlColoursMethods
 
   # ========================================================================= #
   # === ARRAY_KDE_KONSOLE_COLOURS_IN_USE
@@ -189,7 +189,7 @@ class Base # === RBT::Base
   # ========================================================================= #
   ARRAY_KDE_KONSOLE_COLOURS_IN_USE.each {|this_colour|
     define_method(this_colour.to_sym) {|i = ''|
-      return ::Colours.send(this_colour.to_sym, i) if use_colours?
+      return ::Colours::HtmlColoursMethods.send(this_colour.to_sym, i) if use_colours?
       i
     }
   }

data/lib/rbt/base/prototype/commandline_arguments.rb

@@ -15,6 +15,9 @@ class Base # === RBT::Base
       i = ARGV
     )
     i = [i].flatten.compact
+    if @internal_hash.nil?
+      reset_the_internal_hash # Trying this since as of 10.06.2023.
+    end
     @internal_hash[:commandline_arguments] = i
   end; alias set_commandline_arguments internal_hash_set_commandline_arguments # === set_commandline_arguments
        alias set_input                 internal_hash_set_commandline_arguments # === set_input

data/lib/rbt/base/prototype/esystem.rb

@@ -8,14 +8,46 @@ module RBT
 
 class Base # === RBT::Base
 
+  # ========================================================================= #
+  # === esystem_gold
+  #
+  # A variant for esystem(), via the gold colour on the commandline.
+  # ========================================================================= #
+  def esystem_gold(i)
+    e gold(i)
+    system i
+  end
+
   # ========================================================================= #
   # === coloured_and_padded_esystem
   # ========================================================================= #
   def coloured_and_padded_esystem(
       i,
-      use_colours        = use_colours?,
-      optional_arguments = nil
+      use_colours             = use_colours?,
+      optional_arguments      = nil,
+      use_this_primary_colour = :cornflowerblue,
+      &block
     )
+    # ======================================================================= #
+    # We need to work on a copy, as we use colours, and system() does
+    # not understand ANSI escape sequences - hence the copy next.
+    # ======================================================================= #
+    this_command_will_be_passed_to_system_directly = i.dup
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === Handle Symbols first
+      # ===================================================================== #
+      if yielded.is_a? Symbol
+        if ::Colours.is_this_html_colour_included?(yielded)
+          use_colours = true
+          use_this_primary_colour = yielded
+        end
+      end
+    end
     case use_colours
     # ======================================================================= #
     # === :default
@@ -25,6 +57,7 @@ class Base # === RBT::Base
     end
     # ======================================================================= #
     # Next, modify this command if it includes "--prefix=".
+    #
     # In that event we will colourize it a bit; the prefix will
     # be colourized in another colour.
     # ======================================================================= #
@@ -35,7 +68,7 @@ class Base # === RBT::Base
       # ===================================================================== #
       i.sub!(/(--prefix=)(\/.+?)\s/, # See: https://rubular.com/r/Df8OzLqXGd
         '\1'+
-        cornflowerblue('\2 ')+
+        send(use_this_primary_colour, '\2 ')+
         ::Colours.remove_escape_sequences(
           teal('')
         )
@@ -52,9 +85,9 @@ class Base # === RBT::Base
       i.prepend('  ')
     end
     e
-    e i, :fancy_colours # or: teal(i)
+    e "#{rev}#{i}", :fancy_colours # or: teal(i)
     e
-    system i
+    system(this_command_will_be_passed_to_system_directly)
   end; alias colourize_this_important_system_command  coloured_and_padded_esystem # === colourize_this_important_system_command
        alias ecolourize_this_important_system_command coloured_and_padded_esystem # === ecolourize_this_important_system_command
        alias colourized_esystem_with_padding          coloured_and_padded_esystem # === colourized_esystem_with_padding

data/lib/rbt/base/prototype/misc.rb

@@ -140,14 +140,6 @@ class Base # === RBT::Base
     cd log_directory?
   end
 
-  # ========================================================================= #
-  # === esystem_gold
-  # ========================================================================= #
-  def esystem_gold(i)
-    e gold(i)
-    system i
-  end
-
   # ========================================================================= #
   # === store_into_this_directory?
   # ========================================================================= #
@@ -685,27 +677,6 @@ class Base # === RBT::Base
     end
   end; alias no_file_exists_at no_such_file_exists # === no_file_exists_at
 
-  # ========================================================================= #
-  # === touch                                                     (touch tag)
-  #
-  # Use this unified method whenever you wish to create a new file,
-  # like the UNIX "touch" command.
-  # ========================================================================= #
-  def touch(
-      i,
-      be_verbose = false
-    )
-    case be_verbose
-    when :be_verbose
-      be_verbose = true
-    end
-    if be_verbose
-      e "Next creating the file `#{sfile(i)}`."
-    end
-    FileUtils.touch(i)
-  end; alias create_file touch # === create_file
-       alias touch_file  touch # === touch_file
-
   # ========================================================================= #
   # === remove_archive_from_the_end
   #  
@@ -916,14 +887,6 @@ class Base # === RBT::Base
     RBT.is_on_windows?
   end; alias are_we_on_windows? is_on_windows? # === are_we_on_windows?
 
-  # ========================================================================= #
-  # === programs_dir?
-  # ========================================================================= #
-  def programs_dir?
-    RBT.programs_directory?
-  end; alias programs_directory? programs_dir? # === programs_directory?
-       alias program_dir?        programs_dir? # === program_dir?
-
   # ========================================================================= #
   # === registered_cookbook_entries?
   # ========================================================================= #
@@ -1182,4 +1145,25 @@ class Base # === RBT::Base
     Dir[rds(this_directory+'/*')].select {|entry| File.file?(entry) }
   end
 
+  # ========================================================================= #
+  # === touch                                                     (touch tag)
+  #
+  # Use this unified method whenever you wish to create a new file,
+  # like the UNIX "touch" command.
+  # ========================================================================= #
+  def touch(
+      i,
+      be_verbose = false
+    )
+    case be_verbose
+    when :be_verbose
+      be_verbose = true
+    end
+    if be_verbose
+      e "#{rev}Next creating the file `#{sfile(i)}`."
+    end
+    FileUtils.touch(i)
+  end; alias create_file touch # === create_file
+       alias touch_file  touch # === touch_file
+
 end; end

data/lib/rbt/base/prototype/programs_directory.rb

@@ -14,10 +14,12 @@ class Base
   # === programs_directory?
   # ========================================================================= #
   def programs_directory?
-    RBT.programs_dir?.dup
-  end; alias program_directory? programs_directory? # === program_directory?
-       alias programs_dir?      programs_directory? # === programs_dir?
-       alias appdir_prefix?     programs_directory? # === appdir_prefix?
+    RBT.programs_directory?.dup
+  end; alias appdir_prefix?      programs_directory? # === appdir_prefix?
+       alias program_directory?  programs_directory? # === program_directory?
+       alias programs_dir?       programs_directory? # === programs_dir?
+       alias programs_directory? programs_directory? # === programs_directory?
+       alias program_dir?        programs_directory? # === program_dir?
 
 end; end
 

data/lib/rbt/check_for_updates/check_for_mate_desktop_updates.rb

@@ -94,7 +94,7 @@ class CheckForMateDesktopUpdates < CheckForRemoteWebpages # === RBT::Cookbooks::
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
         opne 'That remote URL should be at: '+

data/lib/rbt/check_for_updates/update_kde_applications.rb

@@ -90,7 +90,7 @@ class UpdateKdeApplications < CheckForRemoteWebpages # === RBT::Cookbooks::Updat
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
         opne 'That remote URL should be at: '+

data/lib/rbt/check_for_updates/update_kde_framework.rb

@@ -86,7 +86,7 @@ class UpdateKdeFramework < CheckForRemoteWebpages # === RBT::Cookbooks::UpdateKd
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
         opne 'That remote URL should be at: '+

data/lib/rbt/check_for_updates/update_kde_plasma.rb

@@ -139,7 +139,7 @@ class UpdateKdePlasma < CheckForRemoteWebpages # === RBT::Cookbooks::UpdateKdePl
         # In this case, we have to update.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = remote_download_url?.dup
         full_remote_url << '/' unless full_remote_url.end_with? '/'

data/lib/rbt/check_for_updates/update_kde_porting_aids.rb

@@ -111,7 +111,7 @@ class UpdateKdePortingAids < CheckForRemoteWebpages # === RBT::Cookbooks::Update
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
         opne 'That remote URL should be at: '+

data/lib/rbt/check_for_updates/update_lxqt.rb

@@ -86,7 +86,7 @@ class UpdateLxqt < CheckForRemoteWebpages # === RBT::Cookbooks::UpdateLxqt
         # In this case, we have to update.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{this_program}".dup
         opne "That remote URL should be at: "\

data/lib/rbt/checks_and_validations/missing_use_this_build_system_entry.rb

@@ -90,7 +90,7 @@ class MissingUseThisBuildSystemEntry < RBT::Base # === RBT::Cookbooks::MissingUs
         e tomato(target) if is_on_roebe
         @missing_use_this_build_system_entries << this_program
         if OPEN_IN_THE_EDITOR
-          e 'Opening in the editor as well:'
+          opne 'Opening in the editor as well:'
           Open.in_editor(target)
           sleep 0.5
         end

data/lib/rbt/colours/rev_simp_sdir_sfancy_sfile_and_swarn.rb

@@ -71,7 +71,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.simp(i)
       else
-        return COLOURS.send(user_designated_colour(:simp), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:simp), i)
       end
     end
     return i
@@ -85,7 +85,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.swarn(i)
       else
-        return COLOURS.send(user_designated_colour(:swarn), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:swarn), i)
       end
     end
     return i
@@ -106,7 +106,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.sdir(i)
       else
-        return COLOURS.send(user_designated_colour(:sdir), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:sdir), i)
       end
     end
     return i
@@ -120,7 +120,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.sfile(i)
       else
-        return COLOURS.send(user_designated_colour(:sfile), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:sfile), i)
       end
     end
     return i
@@ -148,7 +148,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.sfancy(i)
       else
-        return COLOURS.send(user_designated_colour(:sfancy), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:sfancy), i)
       end
     end
     return i

data/lib/rbt/compile_base/compile_base.rb

@@ -715,6 +715,13 @@ class CompileBase < RBT::Base # === RBT::CompileBase
     RBT::SymlinkFromToCurrent.new(this_program)
   end
 
+  # ========================================================================= #
+  # === cflags?
+  # ========================================================================= #
+  def cflags?
+    ENV['CFLAGS']
+  end
+
   # ========================================================================= #
   # === run
   # ========================================================================= #