extracter 1.2.32 → 1.3.6

data/lib/extracter/class/extracter.rb

@@ -4,14 +4,21 @@
 # =========================================================================== #
 # === Extracter::Extracter
 #
-# The primary purpose of this class is to abstract extracting source files
-# to a target location. You just pass the argument of the file that has
-# to be extracted to this class, and it should handle the rest.
+# The primary purpose of this class is to abstract-away the extraction-step
+# of source archives to a target location.
+#
+# The user should simply just pass the argument of the file that has
+# to be extracted to this class, and the class will handle the rest.
 #
 # The class can be used to "extract" audio files as well, by calling the
 # module ExtractAudio, which is part of MultimediaParadise. You can try
 # this - just pass a .mp4 file as first argument to this class. Make sure
-# to have installed that gem before, via: gem install multimedia_paradise
+# to have installed the multimedia gem before, via:
+#
+#   gem install multimedia_paradise
+#
+# If no input was provided to this class, but a .zip file exists in
+# the current working directory, then that .zip file will be used.
 #
 # Usage examples:
 #
@@ -28,11 +35,7 @@ module Extracter
 
 class Extracter < ::Extracter::Base # === Extracter::Extracter
 
-  require 'fileutils'
-  require 'extracter/toplevel_methods/is_this_a_valid_archive.rb'
-  require 'extracter/toplevel_methods/misc.rb'
   require 'extracter/version/version.rb'
-  require 'extracter/class/extract_this_archive.rb'
 
   begin
     require 'opn'
@@ -81,8 +84,8 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
       commandline_arguments
     )
     if debug? # Some debug-information in this case.
-      e "The first argument what is:       `#{commandline_arguments}`"
-      e "The second argument where_to is:  `#{extract_to}`"
+      opne "The first argument what is:       `#{commandline_arguments}`"
+      opne "The second argument where_to is:  `#{extract_to}`"
     end
     case run_already
     # ======================================================================= #
@@ -129,25 +132,20 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   def reset
     super()
     # ======================================================================= #
-    # === :try_to_use_colours
-    # ======================================================================= #
-    @internal_hash[:try_to_use_colours] = true
-    # ======================================================================= #
-    # === :colour_to_use_for_directories
-    # ======================================================================= #
-    @internal_hash[:colour_to_use_for_directories] = 'cyan'
-    # ======================================================================= #
-    # === :use_opn
+    # === :namespace
+    #
+    # Specify the main namespace to be used. This setting can be modified
+    # at "runtime".
     # ======================================================================= #
-    @internal_hash[:use_opn] = true # ← Whether to use make use of Opn by default or not.
+    @internal_hash[:namespace] = NAMESPACE
     # ======================================================================= #
-    # === :show_the_full_name_of_the_archive
+    # === :array_work_on_these_files
     # ======================================================================= #
-    @internal_hash[:show_the_full_name_of_the_archive] = false
+    @internal_hash[:array_work_on_these_files] = []
     # ======================================================================= #
-    # === :debug
+    # === :try_to_use_colours
     # ======================================================================= #
-    @internal_hash[:debug] = false
+    @internal_hash[:try_to_use_colours] = true
     # ======================================================================= #
     # === :append_this_to_the_commandline
     #
@@ -156,16 +154,9 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
     # ======================================================================= #
     @internal_hash[:append_this_to_the_commandline] = ''.dup
     # ======================================================================= #
-    # === :namespace
-    #
-    # Specify the main namespace to be used. This setting can be modified
-    # at "runtime".
-    # ======================================================================= #
-    @internal_hash[:namespace] = NAMESPACE
-    # ======================================================================= #
-    # === :be_verbose
+    # === :show_the_full_name_of_the_archive
     # ======================================================================= #
-    @internal_hash[:be_verbose] = true
+    @internal_hash[:show_the_full_name_of_the_archive] = false
     # ======================================================================= #
     # === :show_the_name
     #
@@ -195,181 +186,93 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   end
 
   # ========================================================================= #
-  # === do_not_show_name
-  #
-  # Tells us whether to use opn() or not.
-  # ========================================================================= #
-  def do_not_show_name
-    @internal_hash[:show_the_name] = false
-  end
-
-  # ========================================================================= #
-  # === show_the_name?
-  # ========================================================================= #
-  def show_the_name?
-    @internal_hash[:show_the_name]
-  end
-
-  # ========================================================================= #
-  # === check_whether_rar_is_available
-  #
-  # We try to find out whether unrar is available.
-  # ========================================================================= #
-  def check_whether_rar_is_available
-    is_available = false
-    ENV['PATH'].split(':').each {|entry|
-      is_available = true if File.exist? "#{entry}/unrar"
-    }
-    unless is_available
-      copn; e 'Sorry, unrar is not available. Please install it first.'
-    end
-  end
-
-  # ========================================================================= #
-  # === debug?
-  # ========================================================================= #
-  def debug?
-    @internal_hash[:debug]
-  end
-
-  # ========================================================================= #
-  # === run_already?
-  # ========================================================================= #
-  def run_already?
-    @internal_hash[:run_already]
-  end
-
-  # ========================================================================= #
-  # === enable_debug
-  # ========================================================================= #
-  def enable_debug
-    @internal_hash[:debug] = true
-  end
-
-  # ========================================================================= #
-  # === return_pwd
-  # ========================================================================= #
-  def return_pwd
-    "#{Dir.pwd}/".squeeze('/')
-  end
-
-  # ========================================================================= #
-  # === set_use_opn
-  # ========================================================================= #
-  def set_use_opn(i = true)
-    @internal_hash[:use_opn] = i
-  end
-
-  # ========================================================================= #
-  # === use_opn?
-  # ========================================================================= #
-  def use_opn?
-    @internal_hash[:use_opn]
-  end
-
-  # ========================================================================= #
-  # === set_commandline_arguments
-  # ========================================================================= #
-  def set_commandline_arguments(i = '')
-    i = [i].flatten.compact
-    @commandline_arguments = i
-  end
-
-  # ========================================================================= #
-  # === commandline_arguments?
-  # ========================================================================= #
-  def commandline_arguments?
-    @commandline_arguments
-  end
-
-  # ========================================================================= #
-  # === first_argument?
-  # ========================================================================= #
-  def first_argument?
-    @commandline_arguments.first
-  end; alias first? first_argument? # === first?
-
-  # ========================================================================= #
-  # === padded_extract_to?
-  # ========================================================================= #
-  def padded_extract_to?
-    " -C #{extract_to?} "
-  end
-
-  # ========================================================================= #
-  # === set_colour_for_directories
-  #
-  # Set the colour for directories to use.
+  # === notify_the_user_that_no_input_was_given_but_this_file_was_found
   # ========================================================================= #
-  def set_colour_for_directories(i)
-    @internal_hash[:colour_to_use_for_directories] = ::Colours.beautify(i)
+  def notify_the_user_that_no_input_was_given_but_this_file_was_found(
+      this_file
+    )
+    opne "No input was given to #{sfancy(NAMESPACE)} but a "\
+         ".zip file was"
+    opne 'found in this directory ('+sdir(return_pwd)+rev+
+         '): '+sfancy(this_file)
+    opne 'We will use this zip file.'
   end
 
   # ========================================================================= #
-  # === extract_to?
-  #
-  # Note that this method is guaranteed to return a String.
-  # ========================================================================= #
-  def extract_to?
-    @internal_hash[:extract_to].to_s
-  end; alias source_package_location   extract_to? # === source_package
-       alias extract_to_this_location? extract_to? # === extract_to_this_location?
-       alias extracted_to?             extract_to? # === extracted_to?
-       alias extracted_path?           extract_to? # === extracted_path?
-
-  # ========================================================================= #
-  # === opnn
-  #
-  # This variant will also check whether we should show the name or not.
+  # === work_on_the_given_input
   # ========================================================================= #
-  def opnn(
-      use_this_hash = use_this_opn_hash?
+  def work_on_the_given_input(
+      array      = @internal_hash[:array_work_on_these_files],
+      extract_to = extract_to?
     )
-    if use_opn? and Object.const_defined?(:Opn) and show_the_name?
-      Opn.opn(use_this_hash)
+    pp array if debug?
+    case extract_to
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default,
+         nil
+      extract_to = extract_to?
     end
-  end; alias opn  opnn # === opn
-       alias copn opnn # === copn
-  
-  # ========================================================================= #
-  # === use_this_opn_hash?
-  # ========================================================================= #
-  def use_this_opn_hash?
-    @internal_hash[:use_this_opn_hash]
-  end; alias main_hash? use_this_opn_hash? # === main_hash?
-
-  # ========================================================================= #
-  # === show_help                                                  (help tag)
-  #
-  # This method will show the available - and documented - help options
-  # for class Extracter.
-  #
-  # To call this method via the commandline try:
-  #
-  #   extract --help
-  #
-  # ========================================================================= # 
-  def show_help
-    e
-    opnn; e 'How to extract archives, without helper scripts?'
-    e
-    e '  tar -zxvf foobar.tar.gz                                        # for .tar.gz'
-    e '  tar xvzf foobar.tgz                                            # for .tgz'
-    e '  tar xvfJ foobar.tar.xz                                         # for .tar.xz'
-    e '  tar jxf foobar.tar.bz2                                         # for .tar.bz2'
-    e '  tar -xf foobar.tar.bz2                                         # for .tbz'
-    e '  tar --lzip -xvf zutils-1.5.tar.lz                              # for .tar.lz'
-    e '  unsquashfs foobar-1.2.3.sxz                                    # for .sxz'
-    e '  7z x -so C:\home\x\src\htop\htop-3.0.5.tar.xz | 6z x -si -ttar # on windows'
-    e
-    opnn; e 'Furthermore, there are some commandline options '\
-            'that can'
-    opnn; e 'be used for this class (class Extracter).'
-    e
-    e '  --to=/home/Temp # extract into the '\
-      'directory /home/Temp/'
-    e
-  end
+    # ======================================================================= #
+    # If the user supplied a directory then a random entry will be grabbed
+    # from said directory.
+    # ======================================================================= #
+    if array.is_a?(String) and File.directory?(array)
+      array = Dir[rds("#{array}/")+'*'].sample
+    end
+    if array.empty?
+      opne 'No archive (input) was provided. Please provide the file'
+      opne 'that is to be extracted.'
+    else
+      array.each {|this_file|
+        # =================================================================== #
+        # The next if-clause is for my home setup, for pseudo Symbols:
+        # =================================================================== #
+        if this_file.is_a?(String) and this_file.start_with?(':')
+          _ = '/home/x/src/'
+          if File.directory?(_+this_file.delete(':'))
+            target = _+this_file.delete(':')+'/*'
+            possible_files = Dir[target].select {|entry|
+              File.file?(entry)
+            }
+            unless possible_files.empty?
+              this_file = possible_files.first
+            end
+          end
+        end
+        # =================================================================== #
+        # Create the directory if it does not yet exist.
+        # =================================================================== #
+        create_directory(extract_to) unless File.directory?(extract_to)
+        # =================================================================== #
+        # Handle the case when the user did input a number.
+        # =================================================================== #
+        begin
+          if this_file =~ /^\d$/
+            this_file = Dir['*'][( this_file.to_i - 1 )] unless File.exist?(this_file)
+          end
+        rescue ArgumentError => error
+          opne 'An error occurred for '+sfancy(this_file)+':'
+          pp error
+        end
+        # =================================================================== #
+        # If the user supplied a directory then a random entry will be
+        # grabbed from said directory.
+        #
+        # Usage example:
+        #
+        #  rubyextracter /home/x/src/htop/
+        #
+        # =================================================================== #
+        if File.directory? this_file
+          this_file = Dir[rds("#{this_file}/")+'*'].sample
+        end
+        extract_this_archive(this_file, extract_to)
+        report_to_the_user(this_file, extract_to)
+      }
+    end
+  end; alias extract_input work_on_the_given_input # === extract_input
 
   # ========================================================================= #
   # === pad                                                         (pad tag)
@@ -380,7 +283,8 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   # padding.
   # ========================================================================= #
   def pad(
-      i, with_this_character = "'"
+      i,
+      with_this_character = "'"
     )
     if i.include?('(') or i.include?(')')
       i.tr!('(','\(')
@@ -394,215 +298,16 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   end
 
   # ========================================================================= #
-  # === namespace?
-  # ========================================================================= #
-  def namespace?
-    @internal_hash[:namespace]
-  end
-
-  # ========================================================================= #
-  # === set_be_verbose
+  # === set_extract_to
   #
-  # This sets the verbosity level of the class. Use only this method
-  # when you wish to modify the @be_verbose instance variable.
-  # ========================================================================= #
-  def set_be_verbose(i = false)
-    @internal_hash[:be_verbose] = i
-  end; alias set_verbosity set_be_verbose # === set_verbosity
-
-  # ========================================================================= #
-  # === be_verbose?
+  # This is the method that should be used to determine into which
+  # directory this class will extract archives into.
   #
-  # Getter method for whether we will be verbose or not.
-  # ========================================================================= #
-  def be_verbose?
-    @internal_hash[:be_verbose]
-  end
-
-  # ========================================================================= #
-  # === register_sigint
-  # ========================================================================= #
-  def register_sigint
-    Signal.trap('SIGINT') {
-      e sfancy('Requesting a graceful exit from ')+
-        colour_to_use_for_directories?+
-        'class Extracter'+
-        sfancy('. Exiting now.')
-      exit
-    }
-  end
-
-  # ========================================================================= #
-  # === colour_to_use_for_directories?
-  # ========================================================================= #
-  def colour_to_use_for_directories?
-    if use_colours?
-      return @internal_hash[:colour_to_use_for_directories]
-    else
-      return ''
-    end
-  end
-
-  # ========================================================================= #
-  # === do_show_the_full_name_of_the_archive
-  # ========================================================================= #
-  def do_show_the_full_name_of_the_archive
-    @internal_hash[:show_the_full_name_of_the_archive] = true
-  end
-
-  # ========================================================================= #
-  # === prefix_namespace_with
-  # ========================================================================= #
-  def prefix_namespace_with(i)
-    @internal_hash[:namespace] = "#{i}#{@internal_hash[:namespace].dup}"
-    update_the_main_hash # Also update the opn-hash here.
-  end
-
-  # ========================================================================= #
-  # === pad_opn_with_n_tokens
-  # ========================================================================= #
-  def pad_opn_with_n_tokens(n_tokens = nil)
-    if n_tokens
-      determine_default_opn_hash # Update this, just in case.
-      main_hash?.update(padding: n_tokens)
-    end
-  end; alias set_pad_opn_with_n_tokens pad_opn_with_n_tokens # === set_pad_opn_with_n_tokens
-
+  # Note that this target can be modified from the commandline, if
+  # the user wants to do so.
   # ========================================================================= #
-  # === prepare_the_hash_for_opn
-  # ========================================================================= #  
-  def prepare_the_hash_for_opn(
-      use_this_hash = {
-        namespace:   namespace?,
-        use_colours: use_colours?
-      }
-    )
-    # ======================================================================= #
-    # === :use_this_opn_hash
-    # ======================================================================= #
-    @internal_hash[:use_this_opn_hash] = use_this_hash
-    return @internal_hash[:use_this_opn_hash]
-  end; alias update_the_opn_hash            prepare_the_hash_for_opn # === update_the_opn_hash
-       alias determine_default_opn_hash     prepare_the_hash_for_opn # === determine_default_opn_hash
-       alias determine_the_default_opn_hash prepare_the_hash_for_opn # === determine_the_default_opn_hash
-       alias update_the_main_hash           prepare_the_hash_for_opn # === update_the_main_hash
-
-  # ========================================================================= #
-  # === show_only_the_short_name_of_the_archive?
-  # ========================================================================= #
-  def show_only_the_short_name_of_the_archive?
-    @internal_hash[:show_only_the_short_name_of_the_archive]
-  end
-
-  # ========================================================================= #
-  # === set_run_simulation
-  # ========================================================================= #
-  def set_run_simulation(i = false) # false is the default here.
-    @internal_hash[:run_simulation] = i
-  end
-
-  # ========================================================================= #
-  # === run_simulation=
-  # ========================================================================= #
-  def run_simulation=(i)
-    @internal_hash[:run_simulation] = i
-  end
-
-  # ========================================================================= #
-  # === run_simulation?
-  # ========================================================================= #
-  def run_simulation?
-    @internal_hash[:run_simulation]
-  end
-
-  # ========================================================================= #
-  # === strip_components
-  #
-  # The first argument to this method will determine how far "down" tar
-  # will strip the components.
-  # ========================================================================= #
-  def strip_components(
-      by_n = 1
-    )
-    @internal_hash[:append_this_to_the_commandline] <<
-      " --strip-components=#{by_n}"
-  end
-
-  # ========================================================================= #
-  # === do_show_name
-  #
-  # If this method is called then the class here will show the name of
-  # the file on the commandline, via opn().
-  # ========================================================================= #
-  def do_show_name
-    @internal_hash[:show_the_name] = true
-  end
-
-  # ========================================================================= #
-  # === enable_colours
-  # ========================================================================= #
-  def enable_colours
-    set_use_colours(true)
-    @internal_hash[:colour_to_use_for_directories] = cyan?
-  end
-
-  # ========================================================================= #
-  # === disable_colours
-  #
-  # Use this method if you want to disable colour-support of this class.
-  # ========================================================================= #
-  def disable_colours
-    set_use_colours(false)
-    @internal_hash[:colour_to_use_for_directories] = ''.dup
-  end
-
-  # ========================================================================= #
-  # === set_use_colours
-  # ========================================================================= #
-  def set_use_colours(i)
-    # ======================================================================= #
-    # We must also sync this towards our main Hash, for opn(). The next
-    # line of code achieves precisely that.
-    # ======================================================================= #
-    main_hash?.update(use_colours: i)
-    @internal_hash[:try_to_use_colours] = i
-  end
-
-  # ========================================================================= #
-  # === try_to_use_colours?
-  # ========================================================================= #
-  def try_to_use_colours?
-    @internal_hash[:try_to_use_colours]
-  end
-
-  # ========================================================================= #
-  # === remove_file_extension
-  # ========================================================================= #
-  def remove_file_extension(i)
-    _ = File.basename(i)
-    return ::Extracter.remove_archive_type(_)
-  end; alias remove_extension remove_file_extension # === remove_extensions
-       alias remove_ext       remove_file_extension # === remove_ext
-
-  # ========================================================================= #
-  # === rds
-  # ========================================================================= #
-  def rds(i)
-    return i.squeeze('/') if i.respond_to? :squeeze
-    return i
-  end
-
-  # ========================================================================= #
-  # === set_extract_to
-  #
-  # This is the method that should be used to determine into which
-  # directory this class will extract archives into.
-  #
-  # Note that this target can be modified from the commandline, if
-  # the user wants to do so.
-  # ========================================================================= #
-  def set_extract_to(
-      i = :temp_dir
+  def set_extract_to(
+      i = :temp_dir
     )
     if i.is_a?(Hash) and i.empty?
       i = :temp_dir
@@ -714,133 +419,83 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
        alias extract_to                   set_extract_to # === extract_to
 
   # ========================================================================= #
-  # === try_to_extract_this_iso_file
+  # === run_simulation=
   # ========================================================================= #
-  def try_to_extract_this_iso_file(i)
-    opnn; e 'Extracting an .iso file is a bit more complicated '\
-            'than extracting a .tar.gz tarball'
-    opnn; e 'archive. This class will first create a helper '\
-            'directory; then mount the .iso there,'
-    opnn; e 'then copy the content to the main directory.'
-    helper_directory = File.dirname(i)+
-                       '/READ_ONLY_DIRECTORY_'+
-                       File.basename(
-                         i.delete_suffix(File.extname(i))
-                       )+
-                       '/'
-    mkdir(helper_directory) unless File.directory? helper_directory
-    esystem 'mount -o loop '+i+' '+helper_directory
-    e 'The helper directory in use is '\
-      '`'+sdir(File.absolute_path(helper_directory))+'`.'
-    main_directory = File.dirname(i)+
-                     '/'+
-                     File.basename(
-                       i.delete_suffix(File.extname(i))
-                     )+
-                     '/'
-    e 'Next creating the main directory at `'+sdir(main_directory)+'`.'
-    mkdir(main_directory) unless File.directory? main_directory
-    e 'Next copying the content of the helper directory recursively '
-    e 'from `'+sdir(helper_directory)+'`'
-    e 'onto `'+sdir(
-      main_directory+File.basename(helper_directory)+'/'
-    )+'`.'
-    cpr(
-      helper_directory,
-      main_directory+File.basename(helper_directory)+'/'
-    )
-    a = main_directory+File.basename(helper_directory)+'/'
-    e 'Relocating the files next from:'
-    e
-    e "  #{sdir(a)}"
-    e
-    Dir[a+'*'].each {|entry|
-      mv(
-        entry,
-        main_directory
-      )
-    }
-    # ======================================================================= #
-    # And remove the directory:
-    # ======================================================================= #
-    remove_this_directory(a)
-    e 'The content of the extracted (or rather, mounted) archive is:'
-    e
-    pp Dir["#{main_directory}*"]
-    e
+  def run_simulation=(i)
+    @internal_hash[:run_simulation] = i
   end
 
   # ========================================================================= #
-  # === work_on_the_given_input
+  # === run_simulation?
   # ========================================================================= #
-  def work_on_the_given_input(
-      array      = commandline_arguments?,
-      extract_to = extract_to?
-    )
+  def run_simulation?
+    @internal_hash[:run_simulation]
+  end
+  # ========================================================================= #
+  # === consider_verbosity_for
+  # ========================================================================= #
+  def consider_verbosity_for(i)
+    i = i.dup
+    unless be_verbose?
+      case i
+      # "tar -xvf" must become "tar -xvf" here.
+      when COMMAND_TO_EXTRACT_TAR_XZ_FILES
+        i.delete!('v')
+      end
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === try_to_glob_on
+  # ========================================================================= #
+  def try_to_glob_on(i)
+    result = Dir["#{i}*"]
     # ======================================================================= #
-    # If the user supplied a directory then a random entry will be grabbed
-    # from said directory.
+    # Next, sort this result to put archives on the beginning of the Array.
     # ======================================================================= #
-    if array.is_a?(String) and File.directory?(array)
-      array = Dir[rds("#{array}/")+'*'].sample
-    end
-    case extract_to
-    when nil
-      extract_to = extract_to?
-    end
-    if array.empty?
-      opnn; e 'No archive (input) was provided. Please provide the file'
-      opnn; e 'that is to be extracted.'
-    else
-      array.each {|this_file|
-        # =================================================================== #
-        # Create the directory if it does not yet exist.
-        # =================================================================== #
-        create_directory(extract_to) unless File.directory?(extract_to)
-        # =================================================================== #
-        # Handle the case when the user did input a number.
-        # =================================================================== #
-        begin
-          if this_file =~ /^\d$/
-            this_file = Dir['*'][( this_file.to_i - 1 )] unless File.exist?(this_file)
-          end
-        rescue ArgumentError => error
-          e 'Error for '+sfancy(this_file)+':'
-          pp error
-        end
-        # =================================================================== #
-        # If the user supplied a directory then a random entry will be
-        # grabbed from said directory.
-        #
-        # Usage example:
-        #
-        #  rubyextracter /home/x/src/htop/
-        #
-        # =================================================================== #
-        if File.directory? this_file
-          this_file = Dir[rds("#{this_file}/")+'*'].sample
-        end
-        extract_this_archive(this_file, extract_to)
-        report_to_the_user(this_file, extract_to)
-      }
+    result = result.partition {|entry| is_archive?(entry) }
+    result.flatten!
+    unless result.empty?
+      # ===================================================================== #
+      # Ok, we grab the first entry next.
+      # ===================================================================== #
+      i = result.first
+      opne "#{rev}No result could be found for the given input, "\
+           "thus using #{sfancy(i)} #{rev}instead."
     end
+    return i
+  end
+
+  # ========================================================================= #
+  # === strip_components
+  #
+  # The first argument to this method will determine how far "down" tar
+  # will strip the components.
+  # ========================================================================= #
+  def strip_components(
+      by_n = 1
+    )
+    @internal_hash[:append_this_to_the_commandline] <<
+      " --strip-components=#{by_n}"
   end
 
   # ========================================================================= #
-  # === create_directory                                          (mkdir tag)
+  # === do_show_name
   #
-  # Use this to create directories.
+  # If this method is called then the class here will show the name of
+  # the file on the commandline, via opn().
   # ========================================================================= #
-  def create_directory(i)
-    FileUtils.mkdir_p(i) unless File.directory?(i)
-  end; alias mkdir create_directory # === mkdir
+  def do_show_name
+    @internal_hash[:show_the_name] = true
+  end
 
   # ========================================================================= #
   # === notify_the_user_that_this_extension_has_not_been_registered_yet
   # ========================================================================= #
   def notify_the_user_that_this_extension_has_not_been_registered_yet(i)
-    opnn; e "The archive at `#{i}` is #{tomato('not')}"
-    opnn; e "registered as a permissive extension."
+    opne "The archive at `#{i}` is #{tomato('not')}"
+    opne "registered as a permissive extension."
     fail_message_not_registered(i)
   end
 
@@ -850,20 +505,8 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   # Output a fail message when the archive format is not registered. 
   # ========================================================================= #
   def fail_message_not_registered(i)
-    copn; e "#{rev}Can not extract `#{sfancy(i)}#{rev}` - it is "\
-            "not registered."
-  end
-
-  # ========================================================================= #
-  # === try_to_extract_this_img_file
-  # ========================================================================= #
-  def try_to_extract_this_img_file(i)
-    opnn; e 'Handling a squashfs .img file format next:'
-    name_without_extension = i.delete_suffix(File.extname(i))
-    mkdir(name_without_extension) unless File.directory? name_without_extension
-    esystem "mount -o loop -t squashfs #{i} #{name_without_extension}"
-    e 'The content of the extracted (or rather, mounted) archive is:'
-    pp Dir["#{name_without_extension}*"]
+    opne "#{rev}Can not extract `#{sfancy(i)}#{rev}` - it is "\
+         "not registered."
   end
 
   # ========================================================================= #
@@ -872,12 +515,17 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   def menu(
       i = commandline_arguments?
     )
+    if debug?
+      opne 'The input given to this method was: `'+sfile(i)+'`'
+    end
     if i.is_a? Array
       i.each {|entry| menu(entry) }
     else
       case i
       # ===================================================================== #
-      # === --help
+      # === extracter --help
+      #
+      # Entry point for showing help.
       # ===================================================================== #
       when /^-?-?help$/i
         show_help
@@ -890,7 +538,8 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   # === esystem                                     (system tag, esystem tag)
   # ========================================================================= #
   def esystem(
-      i, try_to_use_colours = try_to_use_colours?
+      i,
+      try_to_use_colours = try_to_use_colours?
     )
     i = i.dup if i.frozen?
     # ======================================================================= #
@@ -907,9 +556,9 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
       end
     end 
     if run_simulation?
-      copn; e 'As we are running in simulation mode, the following command '
-      copn; e 'is the one that we would have been used if we were to not run '
-      copn; e 'in simulation mode:'
+      opne 'As we are running in simulation mode, the following command '
+      opne 'is the one that we would have been used if we were to not run '
+      opne 'in simulation mode:'
       if be_verbose?
         if try_to_use_colours
           e steelblue(i)
@@ -959,35 +608,545 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
     )
     if be_verbose?
       target = extract_to+
-               remove_file_extension(
-                 File.basename(i)
-               )+
+               remove_file_extension(File.basename(i))+
                '/'
-       opnn; e "#{rev}Finished extracting to `"\
-               "#{sdir(target)}#{rev}`." # This is an Array.
+       opne "#{rev}Finished extracting to `"\
+            "#{sdir(target)}#{rev}`." # This is an Array.
     end
   end
 
   # ========================================================================= #
-  # === be_verbose
+  # === try_to_extract_this_iso_file
   # ========================================================================= #
-  def be_verbose
-    set_be_verbose(true)
+  def try_to_extract_this_iso_file(i)
+    opne 'Extracting an .iso file is a bit more complicated '\
+         'than extracting a .tar.gz tarball'
+    opne 'archive. This class will first create a helper '\
+         'directory; then mount the .iso there,'
+    opne 'then copy the content to the main directory.'
+    helper_directory = File.dirname(i)+
+                       '/READ_ONLY_DIRECTORY_'+
+                       File.basename(
+                         i.delete_suffix(File.extname(i))
+                       )+
+                       '/'
+    mkdir(helper_directory) unless File.directory? helper_directory
+    esystem 'mount -o loop '+i+' '+helper_directory
+    opne 'The helper directory in use is '\
+         '`'+sdir(File.absolute_path(helper_directory))+'`.'
+    main_directory = File.dirname(i)+
+                     '/'+
+                     File.basename(
+                       i.delete_suffix(File.extname(i))
+                     )+
+                     '/'
+    opne 'Next creating the main directory at `'+sdir(main_directory)+'`.'
+    mkdir(main_directory) unless File.directory? main_directory
+    opne 'Next copying the content of the helper directory recursively '
+    opne 'from `'+sdir(helper_directory)+'`'
+    opne 'onto `'+sdir(
+      main_directory+File.basename(helper_directory)+'/'
+    )+'`.'
+    cpr(
+      helper_directory,
+      main_directory+File.basename(helper_directory)+'/'
+    )
+    a = main_directory+File.basename(helper_directory)+'/'
+    opne 'Relocating the files next from:'
+    e
+    e "  #{sdir(a)}"
+    e
+    Dir[a+'*'].each {|entry|
+      mv(
+        entry,
+        main_directory
+      )
+    }
+    # ======================================================================= #
+    # And remove the directory:
+    # ======================================================================= #
+    remove_this_directory(a)
+    opne 'The content of the extracted (or rather, mounted) archive is:'
+    e
+    pp Dir["#{main_directory}*"]
+    e
+  end
+
+  # ========================================================================= #
+  # === try_to_extract_this_img_file
+  # ========================================================================= #
+  def try_to_extract_this_img_file(i)
+    opne 'Handling a squashfs .img file format next:'
+    name_without_extension = i.delete_suffix(File.extname(i))
+    mkdir(name_without_extension) unless File.directory? name_without_extension
+    esystem "mount -o loop -t squashfs #{i} #{name_without_extension}"
+    opne 'The content of the extracted (or rather, mounted) archive is:'
+    pp Dir["#{name_without_extension}*"]
+  end
+
+  # ========================================================================= #
+  # === do_show_the_full_name_of_the_archive
+  # ========================================================================= #
+  def do_show_the_full_name_of_the_archive
+    @internal_hash[:show_the_full_name_of_the_archive] = true
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  #
+  # This method will show the available - and documented - help options
+  # for class Extracter.
+  #
+  # To call this method via the commandline try:
+  #
+  #   extract --help
+  #
+  # ========================================================================= # 
+  def show_help
+    e
+    opne 'How to extract archives, without helper scripts?'
+    e
+    e '  tar -zxvf foobar.tar.gz                                         # → for .tar.gz'
+    e '  tar xvzf foobar.tgz                                             # → for .tgz'
+    e '  tar xvfJ foobar.tar.xz                                          # → for .tar.xz'
+    e '  tar jxf foobar.tar.bz2                                          # → for .tar.bz2'
+    e '  tar -xf foobar.tar.bz2                                          # → for .tbz'
+    e '  tar --lzip -xvf zutils-1.5.tar.lz                               # → for .tar.lz'
+    e '  unsquashfs foobar-1.2.3.sxz                                     # → for .sxz'
+    e '  7z x -so C:\home\x\src\htop\htop-3.0.5.tar.xz | 7z x -si -ttar  # → on windows'
+    e
+    opne 'Furthermore, there are some commandline options that can'
+    opne 'be used for this class (class Extracter).'
+    e
+    e '  --to=/home/Temp # extract into the '\
+      'directory /home/Temp/'
+    e
+  end
+
+  # ========================================================================= #
+  # === prefix_namespace_with
+  # ========================================================================= #
+  def prefix_namespace_with(i)
+    @internal_hash[:namespace] = "#{i}#{@internal_hash[:namespace].dup}"
+    update_the_main_hash # Also update the opn-hash here.
+  end
+
+  # ========================================================================= #
+  # === prepare_the_hash_for_opn
+  # ========================================================================= #  
+  def prepare_the_hash_for_opn(
+      use_this_hash = {
+        namespace:     namespace?,
+        use_colours:   use_colours?,
+        show_the_name: show_the_name?
+      }
+    )
+    # ======================================================================= #
+    # === :use_this_opn_hash
+    # ======================================================================= #
+    @internal_hash[:use_this_opn_hash] = use_this_hash
+    return @internal_hash[:use_this_opn_hash]
+  end; alias update_the_opn_hash            prepare_the_hash_for_opn # === update_the_opn_hash
+       alias determine_default_opn_hash     prepare_the_hash_for_opn # === determine_default_opn_hash
+       alias determine_the_default_opn_hash prepare_the_hash_for_opn # === determine_the_default_opn_hash
+       alias update_the_main_hash           prepare_the_hash_for_opn # === update_the_main_hash
+
+  # ========================================================================= #
+  # === show_only_the_short_name_of_the_archive?
+  # ========================================================================= #
+  def show_only_the_short_name_of_the_archive?
+    @internal_hash[:show_only_the_short_name_of_the_archive]
+  end
+
+  # ========================================================================= #
+  # === set_run_simulation
+  #
+  # This should always default to false, if no other argument has been
+  # supplied.
+  # ========================================================================= #
+  def set_run_simulation(i = false)
+    @internal_hash[:run_simulation] = i
   end
 
   # ========================================================================= #
-  # === do_be_quiet
+  # === padded_extract_to?
   # ========================================================================= #
-  def do_be_quiet
-    set_be_verbose(false)
-  end; alias be_silent do_be_quiet # === be_silent
-       alias be_quiet  do_be_quiet # === be_quiet
+  def padded_extract_to?
+    " -C #{extract_to?} "
+  end
+
+  # ========================================================================= #
+  # === set_colour_for_directories
+  #
+  # Set the colour for directories to use.
+  # ========================================================================= #
+  def set_colour_for_directories(i)
+    @internal_hash[:colour_to_use_for_directories] = ::Colours.beautify(i)
+  end
+
+  # ========================================================================= #
+  # === do_not_show_name
+  #
+  # Tells us whether to use opn() or not.
+  # ========================================================================= #
+  def do_not_show_name
+    @internal_hash[:show_the_name] = false
+  end
+
+  # ========================================================================= #
+  # === check_whether_rar_is_available
+  #
+  # We try to find out whether unrar is available.
+  # ========================================================================= #
+  def check_whether_rar_is_available
+    is_available = false
+    ENV['PATH'].split(':').each {|entry|
+      is_available = true if File.exist? "#{entry}/unrar"
+    }
+    unless is_available
+      opne 'unrar appears to be unavailable. Please install it first.'
+    end
+  end
+
+  # ========================================================================= #
+  # === show_the_name?
+  # ========================================================================= #
+  def show_the_name?
+    @internal_hash[:show_the_name]
+  end
+
+  # ========================================================================= #
+  # === run_already?
+  # ========================================================================= #
+  def run_already?
+    @internal_hash[:run_already]
+  end
+
+  # ========================================================================= #
+  # === extract_to?
+  #
+  # Note that this method is guaranteed to return a String.
+  # ========================================================================= #
+  def extract_to?
+    @internal_hash[:extract_to].to_s
+  end; alias extract_to_this_location? extract_to? # === extract_to_this_location?
+       alias extracted_to?             extract_to? # === extracted_to?
+       alias extracted_path?           extract_to? # === extracted_path?
+       alias source_package_location   extract_to? # === source_package
+
+  # ========================================================================= #
+  # === pad_opn_with_n_tokens
+  # ========================================================================= #
+  def pad_opn_with_n_tokens(n_tokens = nil)
+    if n_tokens
+      determine_default_opn_hash # Update this, just in case.
+      main_hash?.update(padding: n_tokens)
+    end
+  end; alias set_pad_opn_with_n_tokens pad_opn_with_n_tokens # === set_pad_opn_with_n_tokens
+
+  # ========================================================================= #
+  # === set_work_on_these_files
+  # ========================================================================= #
+  def set_work_on_these_files(
+      i = []
+    )
+    if i.is_a?(Array) and i.empty?
+      # ===================================================================== #
+      # === Check for .zip files
+      #
+      # In this case, try to see if the current directory has a .zip
+      # file. We will use this in that case.
+      # ===================================================================== #
+      is_there_a_zip_file = Dir['*.zip']
+      unless is_there_a_zip_file.empty?
+        use_this_zip_file = is_there_a_zip_file.first
+        notify_the_user_that_no_input_was_given_but_this_file_was_found(use_this_zip_file)
+        i << use_this_zip_file
+      end
+      is_there_at_the_least_one_tar_xz_file = Dir['*.tar.xz']
+      unless is_there_at_the_least_one_tar_xz_file.empty?
+        i << is_there_at_the_least_one_tar_xz_file.first
+      end
+    end
+    i = [i].compact.flatten.map {|entry|
+      unless File.exist? entry
+        entry = try_to_glob_on(entry)
+      end
+      entry
+    }
+    @internal_hash[:array_work_on_these_files] = i
+  end; alias set_input set_work_on_these_files # === set_input
+
+  # ========================================================================= #
+  # === extract_this_archive                                    (extract tag)
+  # ========================================================================= #
+  def extract_this_archive(
+      i,
+      extract_to = extract_to?
+    )
+    i = File.absolute_path(i)
+    # ======================================================================= #
+    # First determine whether we can extract the archive or whether we can
+    # not:
+    # ======================================================================= #
+    unless ::Extracter.is_this_a_valid_archive?(i) or i.end_with?('.pdf')
+      opne 'The given input, '+i+', is not a valid archive format.'
+      return
+    end
+    # ======================================================================= #
+    # Next handle the situation when we are on Windows:
+    # ======================================================================= #
+    if ::Extracter.are_we_on_windows?
+      # ===================================================================== #
+      # On windows we will overrule this completely, for now.
+      # ===================================================================== #
+      Extract.this_on_windows(i)
+      return
+    end
+    if be_verbose?
+      if show_only_the_short_name_of_the_archive?
+        name_of_the_archive = File.basename(i)
+        opne "#{rev}Extracting `#{sfancy(name_of_the_archive)}#{rev}` "\
+             "to `#{sdir(extract_to)}#{rev}`."
+      else
+        opne "#{rev}Extracting `#{sfancy(i)}` to "\
+             "`#{sdir(extract_to)}#{rev}`."               
+      end
+    end
+    unless File.writable? extract_to
+      copn; ewarn 'You do not have sufficient permissions to'
+      copn; ewarn "modify #{sdir(extract_to)}#{swarn('.')}"
+      return
+    end
+    # ===================================================================== #
+    # Next, pad it if it includes a ' ' character or (). This was
+    # disabled as of July 2022.
+    # ===================================================================== #
+    # i = pad(i) if i.include?(' ') or i.include?(')')
+    case i # case tag; those listed on top are more important.
+    # ===================================================================== #
+    # === 7z
+    # ===================================================================== #
+    when '.7z' # 7z does not accept the -C commandline.
+      # _ << '7za e' # <- Deprecated this variant as of 05.06.2020.
+      esystem "7z x #{i}"
+    # ===================================================================== #
+    # === .tar.xz
+    #
+    # Note that .txz is just .tar.xz. Support for .txz was added here
+    # in January of 2012.
+    # ===================================================================== #
+    when /\.tar\.xz$/i,
+         /\.txz$/i,
+         /\.xz$/i
+      esystem consider_verbosity_for(COMMAND_TO_EXTRACT_TAR_XZ_FILES)+
+              ' '+i+padded_extract_to?
+    # ===================================================================== #
+    # === .rpm
+    #
+    # This entry point will handle .rpm files.
+    # ===================================================================== #
+    when /\.rpm$/i
+      name_of_the_directory = i.delete_suffix('.rpm')
+      mkdir(name_of_the_directory)
+      set_extract_to(File.absolute_path(name_of_the_directory))
+      cd(name_of_the_directory)
+      esystem 'rpm2cpio ../'+File.basename(i)+' | cpio -idmv'
+      return # Early return.
+    # ===================================================================== #
+    # === .tar
+    #
+    # This entry point is for simple .tar files.
+    # ===================================================================== #
+    when /\.tar$/i
+      esystem COMMAND_TO_EXTRACT_TAR_FILES+' '+i+padded_extract_to?
+    # ===================================================================== #
+    # === zip
+    # ===================================================================== #
+    when /.zip$/i,
+         /.xpi$/i,
+         /.docx$/i,
+         /.odt$/i, # .docx and .odt format types can be unpacked with zip too.
+         /.apkg$/
+      # =================================================================== #
+      # 'ar -jxf' # unzip #{what} <-- this should work as well.
+      # =================================================================== #
+      i = pad(i) if i.include?(' ') or i.include?(')')
+      esystem "unzip #{i}"
+    # ===================================================================== #
+    # === tgz
+    #
+    # This entry point will also handle ".tar.Z" files.
+    # ===================================================================== #
+    when /\.?tgz$/i,
+         /\.?tar.Z$/i,
+         /\.?taz$/i
+      esystem COMMAND_TO_EXTRACT_TGZ_FILES+' '+i+padded_extract_to?
+    # ===================================================================== #
+    # === .tar.bz2
+    # ===================================================================== #
+    when /\.tar\.bz2$/i,
+         /\.tbz$/i
+      esystem COMMAND_TO_EXTRACT_TAR_BZ2_FILES+' '+i+padded_extract_to?
+    # ===================================================================== #
+    # === gz
+    # ===================================================================== #
+    when /\.?gz$/i,
+         /\.?apk$/i
+      if i.include? '.tar' # Handle .tar.gz here.
+        esystem 'tar -zxvf '+i+padded_extract_to?
+      else
+        esystem "gunzip #{i}"
+      end
+    # ===================================================================== #
+    # === .bz2
+    # ===================================================================== #
+    when /\.?bz2$/,
+         /\.?tbz2$/
+      if i.include? '.tar' # Treat it as a .tar file.
+        esystem 'tar -vjxf '+i
+      else
+        esystem "bunzip2 #{i}"
+      end
+    # ===================================================================== #
+    # === rar
+    # ===================================================================== #
+    when '.rar'
+      check_whether_rar_is_available
+      esystem "unrar e #{i}"
+    # ===================================================================== #
+    # === .zst
+    #
+    # This entry point is for e. g. "pymol-2.3.0-3-x86_64.pkg.tar.zst".
+    # ===================================================================== #
+    when '.zst',
+         '.tar.zst'
+      esystem COMMAND_TO_EXTRACT_ZST_ARCHIVES+' '+i
+    # ===================================================================== #
+    # === deb
+    #
+    # We could use dpkg-deb too, such as via "dpkg-deb". But using "ar"
+    # seems to be the better choice.
+    # ===================================================================== #
+    when /\.?deb$/i
+      esystem COMMAND_TO_EXTRACT_DEB_FILES+' '+i
+    # ===================================================================== #
+    # === gem
+    #
+    # The gem commands needs a specific --target=DIRECTORY option.
+    # ===================================================================== #
+    when /\.?gem$/i
+      esystem GEM_UNPACK_COMMAND+' '+i+" --target=#{extract_to}"
+    # ===================================================================== #
+    # === lzma
+    # ===================================================================== #
+    when '.lzma'
+      esystem "#{COMMAND_TO_EXTRACT_LZMA_FILES} #{i}"
+    # ===================================================================== #
+    # === bin
+    #
+    # This entry point allows the user to handle .bin files. In this
+    # context, "handling" means to simply run that file as-is.
+    # ===================================================================== #
+    when /\.?bin$/i 
+      esystem("./#{i}")
+    # ===================================================================== #
+    # === iso
+    # ===================================================================== #
+    when /\.?iso$/i
+      try_to_extract_this_iso_file(i)
+      return
+    # ===================================================================== #
+    # === img
+    #
+    # Note that .img in this context refers to squafhs .img files.
+    # ===================================================================== #
+    when /\.?img$/i,
+         /\.?squashfs$/i
+      try_to_extract_this_img_file(i)
+      return # Must return early in this case.
+    # ===================================================================== #
+    # === lz
+    #
+    # This entry point requires lzip to be installed.
+    # ===================================================================== #
+    when /\.?lz$/i,
+         /\.?tar\.?lz$/i
+      esystem("#{COMMAND_TO_EXTRACT_LZ_FILES} #{i}#{padded_extract_to?}")
+    # ===================================================================== #
+    # === mp4
+    #
+    # If it is a .mp4 file, we delegate to MultimediaParadise.extract_audio.
+    #
+    # Usage example:
+    #
+    #   rubyextract foobar.mp4
+    #
+    # ===================================================================== #
+    when /\.?mp4$/i
+      begin
+        require 'multimedia_paradise/audio/extract_audio/extract_audio.rb'
+      rescue LoadError; end
+      if Object.const_defined? :MultimediaParadise
+        MultimediaParadise.extract_audio(i)
+      end
+    # ===================================================================== #
+    # === ps
+    # ===================================================================== #
+    when/\.?ps$/i
+      esystem 'ps2ascii '+i+padded_extract_to?
+    # ===================================================================== #
+    # === .jar
+    # ===================================================================== #
+    when /\.?jar$/i
+      esystem COMMAND_TO_EXTRACT_JAR_ARCHIVES+' '+i
+    # ===================================================================== #
+    # === rpm
+    # ===================================================================== #
+    when '.rpm'
+      esystem "#{COMMAND_TO_EXTRACT_BSDTAR_ARCHIVES} #{i}"
+    # ===================================================================== #
+    # === sxz
+    # ===================================================================== #
+    when '.sxz'
+      esystem "unsquashfs #{i}"
+    # ===================================================================== #
+    # === pdf
+    #
+    # For pdf-files we will tap into the pdf_paradise project, if it
+    # is available.
+    # ===================================================================== #
+    when /\.?pdf$/
+      begin
+        require 'pdf_paradise/utility_scripts/convert_pdf_to_text.rb'
+        _ = PdfParadise::ConvertPdfToText.new(i)
+        e _.output_file?
+      rescue LoadError => error
+        e 'No, not there.'
+        pp error # Show the error to the user here.
+      end
+      return # Must return early in this case.
+    else # else tag. We did not find the extension type.
+      if File.exist? i
+        notify_the_user_that_this_extension_has_not_been_registered_yet(i)
+      else
+        opne "#{rev}No file exists at `#{sfile(i)}#{rev}`."
+      end
+    end
+  end; alias do_extract_to      extract_this_archive # === do_extract_to
+       alias do_extract_what_to extract_this_archive # === do_extract_what_to
+       alias start              extract_this_archive # === start
 
   # ========================================================================= #
   # === run                                                (run tag, def tag)
   # ========================================================================= #
   def run
     menu
+    _ = commandline_arguments?
+    _.flatten.select {|entry|
+      File.file?(entry) or File.directory?(entry)
+    }
+    set_work_on_these_files(_)
     work_on_the_given_input
   end
 
@@ -1013,13 +1172,16 @@ class Extracter < ::Extracter::Base # === Extracter::Extracter
   # ========================================================================= #
   # === Extracter::Extracter[]
   # ========================================================================= #
-  def self.[](i = ARGV, extract_where_to = Dir.pwd)
+  def self.[](
+      i = ARGV,
+      extract_where_to = Extracter.return_pwd
+    )
     new(i, extract_where_to)
   end
 
 end
 
-# ========================================================================= #
+# ============================================================================ #
 # === Extracter.extract_what_to
 #
 # Useage example goes like this:
@@ -1027,7 +1189,7 @@ end
 #   Extracter.extract_what_to('foo-1.0.tar.xz', '/tmp')
 #   Extracter.extract_what_to('/Depot/jjjj/tesseract-5.1.0.tar.xz', Dir.pwd+'/')
 #
-# ========================================================================= #
+# ============================================================================ #
 def self.extract_what_to(
     what        = ARGV,
     extract_to  = :default, # ← This can also be a Hash. It denotes where we want to extract to.
@@ -1041,16 +1203,17 @@ def self.extract_what_to(
         &block
       )
   return _ # We must return the class, as other projects may depend on this.
-end; self.instance_eval { alias extract_this extract_what_to } # === Extracter.extract_this
-     self.instance_eval { alias extract      extract_what_to } # === Extracter.extract
-     self.instance_eval { alias what_to      extract_what_to } # === Extracter.what_to
-     self.instance_eval { alias new          extract_what_to } # === Extracter.new
-     self.instance_eval { alias []           extract_what_to } # === Extracter[]
+end; self.instance_eval { alias extract_this               extract_what_to } # === Extracter.extract_this
+     self.instance_eval { alias extract                    extract_what_to } # === Extracter.extract
+     self.instance_eval { alias what_to                    extract_what_to } # === Extracter.what_to
+     self.instance_eval { alias new                        extract_what_to } # === Extracter.new
+     self.instance_eval { alias extract_what_to_on_windows extract_what_to } # === Extracter.extract_what_to_on_windows
+     self.instance_eval { alias extract_it                 extract_what_to } # === Extracter.extract_it
+     self.instance_eval { alias []                         extract_what_to } # === Extracter[]
 
 end
 
 if __FILE__ == $PROGRAM_NAME
-  _ = Extracter::Extracter.new(ARGV) { :do_not_run_yet }
   if ARGV.size > 2
     _ = Extracter::Extracter.new(ARGV, :default) { :do_not_run_yet }
   else
@@ -1066,4 +1229,4 @@ end # rubyextracter
     # extracter xfig-3.2.5.tar.bz2
     # extract htop* /Depot/
     # extract recode-3.7.tar.xz /Depot/
-    # extract qt-4.8.6.tar.xz --to=/home/Temp
+    # extract qt-4.8.6.tar.xz --to=/home/Temp