extracter 1.1.1

data/lib/extracter/initialize.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'extracter/initialize.rb'
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument to this method is the archive that should be extracted.
+  # This must be a (locally) existing archive, such as foobar.tar.xz or
+  # something similar.
+  #
+  # The second argument to this method, called `to`, specifies the target
+  # location, where this class will extract the archive into, if available.
+  # Some keywords and shortcuts exist for this option - for instance, TEMP
+  # means $MY_TEMP, which can be set by the user.
+  #
+  # Specific usage example in pure Ruby:
+  #
+  #   x = Extracter.what_to('pry-0.9.9.4.gem', '/Depot/Temp')
+  #
+  # ========================================================================= #
+  def initialize(
+      what        = nil,
+      where_to    = nil, # Where to extract into.
+      run_already = true
+    )
+    register_sigint
+    reset
+    if where_to.is_a? Symbol
+      if where_to.to_s.include? 'dont' # This also covers :dont_run_yet
+        where_to    = nil # This is ok because we expect the user to provide the target location.
+        run_already = false
+      end
+    end
+    if debug? # Some debug-information.
+      e "The first argument what is: `#{what}`"
+      e "The second argument to is:  `#{to}`"
+    end
+    set_source_location(what)
+    set_extract_to(where_to)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === Handle Hash input next:
+      # ===================================================================== #
+      if yielded.is_a? Hash
+        if yielded.has_key? :run_already
+          run_already = yielded.delete(:run_already)
+        end
+        # =================================================================== #
+        # === :use_colours
+        # =================================================================== #
+        if yielded.has_key? :use_colours
+          set_use_colours yielded.delete(:use_colours)
+        end
+        if yielded.has_key? :extract_to
+          set_extract_to yielded.delete(:extract_to)
+        end
+        if yielded.has_key? :run_simulation
+          set_run_simulation(yielded.delete(:run_simulation))
+        end
+        if yielded.has_key? :use_opn
+          set_use_opn(yielded.delete(:use_opn))
+        end
+      else
+        case yielded
+        when :dont_run_yet,
+             :do_not_run_yet
+          run_already = false
+        end
+      end
+    end
+    case run_already
+    when :dont_run_yet,
+         :do_not_run_yet
+      run_already = false
+    end
+    run if run_already
+  end
+
+end; end

data/lib/extracter/misc.rb

@@ -0,0 +1,430 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'extracter/misc.rb'
+# =========================================================================== #
+module Extracter
+
+class Extracter # === Extracter
+
+  require 'fileutils'
+
+  begin
+    require 'multimedia_paradise/audio/extract_audio/extract_audio.rb'
+  rescue LoadError; end
+
+  begin
+    require 'remove_file_suffix'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # Shall we run in simulation mode or not.
+  # ========================================================================= #
+  attr_accessor :run_simulation
+
+  # ========================================================================= #
+  # === debug?
+  # ========================================================================= #
+  def debug?
+    @debug
+  end
+
+  # ========================================================================= #
+  # === enable_debug
+  # ========================================================================= #
+  def enable_debug
+    @debug = true
+  end
+
+  # ========================================================================= #
+  # === do_not_show_name
+  #
+  # Tells us whether to use opn() or not.
+  # ========================================================================= #
+  def do_not_show_name
+    @do_not_show_name = true
+  end
+
+  # ========================================================================= #
+  # === do_show_name
+  #
+  # If this is enabled, we will show the name of the file when we invoke
+  # copn().
+  # ========================================================================= #
+  def do_show_name
+    @do_not_show_name = false
+  end
+
+  # ========================================================================= #
+  # === sanitize_input
+  # ========================================================================= #
+  def sanitize_input(i)
+    if i.include? '('
+      i.gsub!(/\(/,'\(')
+      i.gsub!(/\)/,'\)') if i.include? ')'
+      i = pad(i, '"')
+    end
+    return i
+  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
+
+  # ========================================================================= #
+  # === run_simulation?
+  # ========================================================================= #
+  def run_simulation?
+    @run_simulation
+  end
+
+  # ========================================================================= #
+  # === set_run_simulation
+  # ========================================================================= #
+  def set_run_simulation(i)
+    @run_simulation = i
+  end
+
+  # ========================================================================= #
+  # === pad
+  # ========================================================================= #
+  def pad(i, with_this_character = "'")
+    return with_this_character+i+with_this_character
+  end
+
+  # ========================================================================= #
+  # === extract_to?
+  #
+  # Simply output the result of @extract_to_this_location variable.
+  # ========================================================================= #
+  def extract_to?
+    @extract_to_this_location.to_s
+  end; alias source_package_location extract_to? # === source_package
+
+  # ========================================================================= #
+  # === set_source_location
+  #
+  # Use this method to designate the source location of a given (input)
+  # program. In other words - the tarball or archive that must be
+  # extracted. It will however be stored as Array.
+  #
+  # If we pass a hash to this method, we assume that the user wants
+  # to also populate some other values.
+  # ========================================================================= #
+  def set_source_location(i = nil)
+    if i.nil?
+      copn; e 'You should set a file.'
+    end
+    if i.is_a? Array
+      i = i.flatten
+    else
+      i = [i]
+    end # After this point, we will have an Array.
+    case i.first # case tag
+    when /^-?-?help$/i
+      show_help
+      exit
+    end
+    i.map! {|entry| # Iterate over our Array next.
+      # ======================================================================= #
+      # Handle the case when the user did input a number.
+      # ======================================================================= #
+      begin
+        if entry =~ /^\d$/
+          entry = Dir['*'][( entry.to_i - 1 )] unless File.exist?(entry)
+        end
+      rescue ArgumentError => error
+        e 'Error for '+sfancy(entry)+':'
+        pp error
+      end
+      entry = rds(entry.to_s)
+      # ======================================================================= #
+      # Next, find the proper working directory.
+      # ======================================================================= #
+      unless entry.include? '/'
+        entry = rds( (Dir.pwd+'/'+entry) )
+      end
+      # ======================================================================= #
+      # If the user supplied a directory instead, we will randomly grab an
+      # entry from said directory.
+      # ======================================================================= #
+      if File.directory? entry
+        entry = Dir[rds(entry+'/')+'*'].sample
+      end
+      entry
+    } # Sanitize the result, just in case.
+    i = [i] unless i.is_a? Array # Much more convenient to work with an array.
+    @source_location = i
+  end; alias set_what set_source_location # === set_what
+
+  # ========================================================================= #
+  # === source_location?
+  # ========================================================================= #
+  def source_location?
+    @source_location.first
+  end; alias input? source_location? # === input?
+
+  # ========================================================================= #
+  # === did_we_extract_already?
+  #
+  # Whether we already did extract or whether we did not.
+  # ========================================================================= #
+  def did_we_extract_already?
+    @did_we_extract_already
+  end; alias did_we_extract_already did_we_extract_already? # === did_we_extract_already
+
+  # ========================================================================= #
+  # === extract_to_this_location?
+  #
+  # Extract to this location.
+  # ========================================================================= #
+  def extract_to_this_location?
+    @extract_to_this_location
+  end; alias extract_to_this_location extract_to_this_location? # === extract_to_this_location
+
+  # ========================================================================= #
+  # === extracted_to?
+  #
+  # This method is different from extract_to?.
+  #
+  # It will keep track of the directory to where we extracted to
+  # exactly.
+  # ========================================================================= #
+  def extracted_to?
+    rds(
+      extract_to?+
+      File.basename(input?).sub(/\.xz$/,'').sub(/\.gz$/,'').
+                            sub(/\.tar$/,'')+'/'
+    )
+  end; alias extracted_path? extracted_to? # === extracted_path?
+
+  # ========================================================================= #
+  # === namespace?
+  # ========================================================================= #
+  def namespace?
+    @namespace
+  end
+
+  # ========================================================================= #
+  # === set_extract_to_this_location
+  #
+  # Use this when setting the variable @extract_to_this_location.
+  #
+  # This can be modified from the commandline such as by doing this:
+  # ========================================================================= #
+  def set_extract_to_this_location(
+      i = TEMP_DIR
+    )
+    if i.is_a? Hash
+      if i.has_key? :to
+        i = i.delete :to
+      elsif i.has_key? :extract_to
+        i = i.delete :extract_to
+      end
+    end
+    case i # case tag
+    when :default
+      i = Dir.pwd
+    when 'TEMP',
+         'MY_TEMP',
+         'MYTEMP'
+      i = TEMP_DIR
+    end
+    i = TEMP_DIR if i.nil?
+    i = i.to_s.dup
+    i << '/' unless i.end_with? '/'
+    i = rds(i)
+    i.gsub!(/--to=/,'') if i.include? '--to='
+    @extract_to_this_location = i
+  end; alias set_extract_to set_extract_to_this_location # === set_extract_to
+       alias extract_to=    set_extract_to_this_location # === extract_to=
+       alias extract_to     set_extract_to_this_location # === extract_to
+
+  # ========================================================================= #
+  # === run_this_system_command
+  # ========================================================================= #
+  def run_this_system_command(
+      i, instruction = :do_nothing_special
+    )
+    if instruction == :also_show_what_we_will_do
+      copn; e i
+    end
+    return `#{i}` # system tag
+  end
+
+  # ========================================================================= #
+  # === prefix_namespace_with
+  # ========================================================================= #
+  def prefix_namespace_with(i)
+    @namespace = "#{i}#{@namespace.dup}"
+    update_the_opn_hash # Also update the opn-hash here.
+  end
+
+  # ========================================================================= #
+  # === report_to_the_user
+  #
+  # This method reports to the user. Usually this is done only via this
+  # file here though.
+  # ========================================================================= #
+  def report_to_the_user
+    if @be_verbose
+      unless @skip_extracting
+        copn; e 'Finished extracting to `'+sdir(
+          extract_to?+remove_file_extension(
+            @source_location.first # This is an Array.
+          )+'/'
+        )+'`.'
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === be_verbose?
+  #
+  # Getter method for whether we will be verbose or not.
+  # ========================================================================= #
+  def be_verbose?
+    @be_verbose
+  end
+
+  # ========================================================================= #
+  # === be_verbose
+  # ========================================================================= #
+  def be_verbose
+    set_be_verbose(true)
+  end
+
+  # ========================================================================= #
+  # === be_silent
+  # ========================================================================= #
+  def be_silent
+    set_be_verbose(false)
+  end
+
+  # ========================================================================= #
+  # === set_be_verbose
+  #
+  # 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)
+    @be_verbose = i
+  end; alias set_verbosity set_be_verbose # === set_verbosity
+
+  # ========================================================================= #
+  # === determine_default_opn_hash
+  # ========================================================================= #
+  def determine_default_opn_hash
+    @use_this_opn_hash = {
+      namespace:   namespace?,
+      use_colours: use_colours?
+    }
+  end; alias update_the_opn_hash determine_default_opn_hash # === update_the_opn_hash
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === fail_message_not_registered
+  #
+  # Output a fail message when the archive format is not registered. 
+  # ========================================================================= #
+  def fail_message_not_registered(i)
+    copn; e "Can not extract `#{sfancy(i)}` - it is not "\
+            "registered."
+  end
+
+  # ========================================================================= #
+  # === work_on_the_given_input
+  # ========================================================================= #
+  def work_on_the_given_input
+    if @source_location.empty?
+      copn; e 'Can not extract anything as no input has been given.'
+    else
+      @source_location.each {|entry|
+        if Extracter.is_this_a_valid_archive?(entry)
+          do_extract_what_to(entry)
+          report_to_the_user
+        else
+          fail_message_not_registered(entry)
+        end
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === create_directory
+  #
+  # Use this to create directories.
+  # ========================================================================= #
+  def create_directory(i)
+    FileUtils.mkdir_p(i)
+  end; alias mkdir create_directory # === mkdir
+
+  # ========================================================================= #
+  # === remove_file_extension
+  # ========================================================================= #
+  def remove_file_extension(i)
+    _ = File.basename(i)
+    return RemoveFileSuffix[_]
+  end
+
+  # ========================================================================= #
+  # === rds
+  # ========================================================================= #
+  def rds(i)
+    i.squeeze('/')
+  end
+
+  # ========================================================================= #
+  # === esystem
+  # ========================================================================= #
+  def esystem(i)
+    e i
+    system i
+  end
+
+  # ========================================================================= #
+  # === e
+  # ========================================================================= #
+  def e(i = '')
+    puts i
+  end
+
+  # ========================================================================= #
+  # === do_show_the_full_name_of_the_archive
+  # ========================================================================= #
+  def do_show_the_full_name_of_the_archive
+    @show_only_the_short_name_of_the_archive = false
+  end
+
+  # ========================================================================= #
+  # === run                                                (run tag, def tag)
+  # ========================================================================= #
+  def run
+    work_on_the_given_input
+  end
+
+end; end

data/lib/extracter/opn.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  begin
+    require 'opn'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === custom_opn
+  #
+  # This is like opn(), except that we also check whether
+  # we should show the name or not.
+  # ========================================================================= #
+  def custom_opn
+    opnn unless @do_not_show_name
+  end; alias copn custom_opn # === copn
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    if @use_opn and Object.const_defined?(:Opn)
+      Opn.opn(@use_this_opn_hash)
+    end
+  end
+
+  # ========================================================================= #
+  # === set_use_opn
+  # ========================================================================= #
+  def set_use_opn(i = true)
+    @use_opn = i
+  end
+
+  # ========================================================================= #
+  # === pad_opn_with_n_tokens
+  # ========================================================================= #
+  def pad_opn_with_n_tokens(n_tokens)
+    determine_default_opn_hash # Update this, just in case.
+    @use_this_opn_hash.update(padding: n_tokens)
+  end; alias set_pad_opn_with_n_tokens pad_opn_with_n_tokens # === set_pad_opn_with_n_tokens
+
+end; end

data/lib/extracter/reset.rb

@@ -0,0 +1,66 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  #
+  # Reset our main instance variables here.
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @namespace
+    #
+    # Specify the main namespace to be used. This setting can be modified
+    # at "runtime".
+    # ======================================================================= #
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # === @debug
+    # ======================================================================= #
+    @debug = false
+    # ======================================================================= #
+    # === Extract to this location
+    #
+    # Next specify where to extract the archive in question, defaulting to
+    # the TEMP_DIR constant.
+    # ======================================================================= #
+    @extract_to_this_location = TEMP_DIR
+    # ======================================================================= #
+    # === @did_we_extract_already
+    #
+    # We will keep track of whether we already extracted or not.
+    # ======================================================================= #
+    @did_we_extract_already = false
+    # ======================================================================= #
+    # === @do_not_show_name
+    # ======================================================================= #
+    @do_not_show_name = false
+    # ======================================================================= #
+    # === @use_opn
+    # ======================================================================= #
+    @use_opn = true # ← Whether to use Opn by default or not.
+    # ======================================================================= #
+    # === @show_only_the_short_name_of_the_archive
+    # ======================================================================= #
+    @show_only_the_short_name_of_the_archive = SHOW_ONLY_THE_SHORT_NAME_OF_THE_ARCHIVE
+    # ======================================================================= #
+    # === @skip_extracting
+    # ======================================================================= #
+    @skip_extracting = false
+    # ======================================================================= #
+    # === @run_simulation
+    # ======================================================================= #
+    @run_simulation = false # ← Whether to run in simulation, or for "real".
+    set_extract_to_this_location
+    do_show_name # We will show the name usually.
+    enable_colours
+    determine_default_opn_hash
+    set_be_verbose(false)
+  end
+
+end; end

data/lib/extracter/version/version.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'extracter/version/version.rb'
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  # ========================================================================= #
+  # === Extracter::VERSION
+  #
+  # Which specific version to use for class Extracter.
+  # ========================================================================= #
+  VERSION = '1.1.1'
+
+end; end

data/lib/extracter.rb

@@ -0,0 +1,6 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'extracter/extracter.rb'
+require 'extracter/extract_it/extract_it.rb'

data/test/testing_class_extracter.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+if __FILE__ == $PROGRAM_NAME
+  require 'fileutils'
+  require 'extracter'
+  require 'colours/colours_e_autoinclude.rb'
+  extract_to = '/Depot/Temp/'
+  e 'Now testing class Extracter - some will fail, do not worry:'
+  e
+  e Colours.orange('1) Testing Extracter.is_this_a_valid_archive? functionality:')
+  e
+  e Extracter.is_this_a_valid_archive? 'foo.php'
+  # Extracter.new(ARGV)
+  FileUtils.cp('/Users/x/SRC/recode/recode-3.7.tar.xz','/Depot/j')
+  Extracter.what_to '/Depot/j/recode-3.7.tar.xzg', '/Depot/jj' # This line is deliberately wrong.
+  Extracter.what_to '/Depot/j/recode-3.7.tar.xz',  '/Depot/jj'
+  Extracter.what_to '/Depot/j/recode-3.7.gzip',  '/Depot/jj'
+  e Colours.orange("2) Next testing "+sfancy("Extracter['/Users/x/SRC/htop/']"))
+  Extracter['/Users/x/SRC/htop/']
+  e Colours.orange("3) Next testing "+sfancy("Extracter['/Users/x/SRC/libzip/']"))
+  Extracter['/Users/x/SRC/libzip/', to: extract_to]
+end # testextracter