extracter 1.1.6

data/lib/extracter/do_extract_what_to.rb

@@ -0,0 +1,305 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'extracter/do_extract_what_to.rb'
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  # ========================================================================= #
+  # === do_extract_what_to
+  #
+  # This method should only be called from the method
+  # work_on_the_given_input().
+  #
+  # It will attempt to extract the specified archive.
+  # ========================================================================= #
+  def do_extract_what_to(
+      what, # ← The archive or file that we wish to extract.
+      to = extract_to?
+    )
+    name_of_the_archive = what.dup
+    @did_we_extract_already = false
+    to = extract_to? if to.nil?
+    set_source_location(what)
+    set_extract_to_this_location(to) # Keep it in sync.
+    # ======================================================================= #
+    # Create the directory if it does not yet exist.
+    # ======================================================================= #
+    create_directory(to) if !File.directory?(to)
+    if be_verbose?
+      if @show_only_the_short_name_of_the_archive
+        name_of_the_archive = File.basename(name_of_the_archive)
+        copn; e "Extracting `#{sfancy(name_of_the_archive)}` to `#{sdir(to)}` next."
+      else
+        copn; e "Extracting `#{sfancy(name_of_the_archive)}` to `#{sdir(to)}` next."
+      end
+    end
+    _ = ''.dup # Default.
+    extname = File.extname(what)
+    unless ARRAY_REGISTERED_ARCHIVES.include? extname.delete('.')
+      opn; e 'We did not register the following extension: '+extname.delete('.')
+      fail_message_not_registered(extname)
+      @skip_extracting = true
+    end
+    case extname # Case tag. Those listed on top are more important.
+    # ======================================================================= #
+    # === .tar
+    # ======================================================================= #
+    when '.tar',
+         '.tar.bz2',
+         '.tbz'
+      _ << 'tar -xvf'
+    # ======================================================================= #
+    # === pdf
+    #
+    # For pdf-files we will tap into the pdf_paradise project.
+    # ======================================================================= #
+    when /\.?pdf$/
+      begin
+        require 'pdf_paradise/convert_pdf_to_text.rb'
+        _ = PdfParadise::ConvertPdfToText.new(what)
+        _.output_file?
+      rescue LoadError; end
+      return # Must return early in this case.
+    # ======================================================================= #
+    # === img
+    #
+    # Note that .img in this context refers to squafhs .img files.
+    # ======================================================================= #
+    when '.img',
+         '.squashfs'
+      opnn; e 'Handling a squashfs .img file format next:'
+      name_without_extension = what.sub(/#{File.extname(what)}$/,'')
+      mkdir(name_without_extension) unless File.directory? name_without_extension
+      esystem 'mount -o loop -t squashfs '+what+' '+name_without_extension
+      e 'The content of the extracted (or rather, mounted) archive is:'
+      pp Dir["#{name_without_extension}*"]
+      return # Must return early in this case.
+    # ======================================================================= #
+    # === iso
+    # ======================================================================= #
+    when '.iso'
+      opnn; e 'Extracting an .iso file is a bit more complicated '\
+              'than a .tar.gz tarball release.'
+      opnn; e 'We will first create a directory; and then mount '\
+              'the .iso there.'
+      name_without_extension = what.sub(/#{File.extname(what)}$/,'')
+      mkdir(name_without_extension) unless File.directory? name_without_extension
+      esystem 'mount -o loop '+what+' '+name_without_extension
+      e 'The content of the extracted (or rather, mounted) archive is:'
+      pp Dir[name_without_extension+'*']
+      return
+    # ======================================================================= #
+    # === sxz
+    # ======================================================================= #
+    when '.sxz'
+      _ = 'unsquashfs '.dup # This requires squashfs with xz-support.
+    # ======================================================================= #
+    # === lz
+    # ======================================================================= #
+    when '.lz','.tar.lz'
+      _ = 'tar --lzip -xvf '.dup # This requires lzip to be installed.
+    # ======================================================================= #
+    # === tar.Z
+    # ======================================================================= #
+    when '.tar.Z','.taz'
+      _ << 'tar -xvzf'
+    # ======================================================================= #
+    # === .jar
+    # ======================================================================= #
+    when /\.?jar$/i
+      _ << 'jar xvf'
+    # ======================================================================= #
+    # === .zst
+    #
+    # This entry point is for e. g. "pymol-2.3.0-3-x86_64.pkg.tar.zst".
+    # ======================================================================= #
+    when '.zst','.tar.zst'
+      _ << 'tar -I zstd -xvf '
+    # ======================================================================= #
+    # === txz
+    # ======================================================================= #
+    when '.txz'
+      _ << 'tar Jxvf' # Since Jan 2012.
+    # ======================================================================= #
+    # === gz
+    # ======================================================================= #
+    when '.gz'
+      if what.include? '.tar'
+        _ << 'tar -zxvf'
+      else
+        _ << 'gunzip'
+      end
+    # ======================================================================= #
+    # === xz
+    # ======================================================================= #
+    when '.xz'
+      if _.include? '.tar'
+      end
+      _ << 'tar -xvf' # tar -Jxv #{what} would be an alternative.
+    # ======================================================================= #
+    # === rpm
+    # ======================================================================= #
+    when '.rpm'
+      _ << 'bsdtar xfv'
+    # ======================================================================= #
+    # === bin
+    # ======================================================================= #
+    when '.bin' # handle .bin files here.
+      # _ = 'tar -jxf '+package
+      _ << "./#{what}"
+    # ======================================================================= #
+    # === zip
+    # ======================================================================= #
+    when '.zip','.xpi','.docx','.odt', # .docx and .odt format types can be unpacked with zip too.
+         '.apkg'
+      # _ << 'ar -jxf' # unzip #{what} <-- this should work as well.
+      _ << 'unzip '
+    when /\.bz2/,'.tbz2'
+      if what.include? '.tar' # Treat it as a .tar file.
+        _ << 'tar -vjxf '
+      else
+        _ << 'bunzip2 '
+      end
+    # ======================================================================= #
+    # === lzma
+    # ======================================================================= #
+    when '.lzma'
+      _ << 'unlzma '
+    # ======================================================================= #
+    # === 7z
+    # ======================================================================= #
+    when '.7z' # 7z does not accept the -C commandline.
+      # _ << '7za e' # <- Deprecated as of 05.06.2020.
+      _ << '7z x'
+    # ======================================================================= #
+    # === gem
+    # ======================================================================= #
+    when '.gem'
+      _ << GEM_UNPACK_COMMAND
+    # ======================================================================= #
+    # === rar
+    # ======================================================================= #
+    when '.rar'
+      check_whether_rar_is_available
+      _ << 'unrar e'
+    # ======================================================================= #
+    # === deb
+    # ======================================================================= #
+    when '.deb'
+      #_ = 'dpkg-deb -x' # {to}
+      _ << 'ar -x' # ar -x #{what} This could work too.
+    # ======================================================================= #
+    # === tgz
+    # ======================================================================= #
+    when '.tgz'
+      _ << 'tar -xvzf'
+    # ======================================================================= #
+    # === ps
+    # ======================================================================= #
+    when '.ps'
+      _ << 'ps2ascii'
+    # ======================================================================= #
+    # === mp4
+    # ======================================================================= #
+    when '.mp4' # If it is a .mp4 file, we delegate to ExtractAudio instead.
+      if Object.const_defined? :MultimediaParadise
+        MultimediaParadise.extract_audio(@source_package_location)
+      end
+      exit
+    else # else tag. We did not find the extension type.
+      @skip_extracting = true
+      copn; ewarn "We did not find: `#{sfile(what)}`. "
+      copn; ewarn 'The file-type (extension) was: `'+simp(extname)+'`.'
+      # Try to rescue though.
+      result = run_this_system_command("file #{what}")
+      copn; e result
+      if result.include? 'bzip2 compressed'
+        copn; e 'We assume it is a .bz2 file though.'
+        _ = 'tar -vjxf '.dup
+        @skip_extracting = false
+      end
+    end unless @skip_extracting
+    unless File.exist? what
+      @skip_extracting = true
+      copn; e "The file `#{sfile(what)}"\
+              "` does not exist - can not extract."
+    end
+    # ======================================================================= #
+    # Handle the situation when the given input includes a ')' character.
+    # We will pad such an input with '"' characters.
+    # ======================================================================= #
+    if what.include? ')'
+      what = pad(what, '"') #sanitize_input(what)
+    end
+    # ======================================================================= #
+    # Next, pad it if it includes a ' ' character.
+    # ======================================================================= #
+    what = pad(what) if what.include?(' ')
+    _ << " #{what}" unless _.empty?
+    if _.include? GEM_UNPACK_COMMAND # Gem command needs a --target=DIR option.
+      _ << " --target=#{to}"
+    elsif _.include?('ar -x') and ! _.include?('.tar') # Do nothing in this case.
+    elsif _.end_with? '.sxz'
+      # .sxz does not require the -C option.
+    elsif _.end_with? '.zip','.xpi','.7z','.jar','.apkg'
+      # Do not use -C option for 7z, as it hates this option.
+      # .jar files also do not support the -C option.
+    elsif _.include? 'bunzip'
+      # Do not use -C option for bunzip, as it hates this option.
+    else
+      # ===================================================================== #
+      # Next, we need to determine the location where we extract our
+      # archive to.
+      # ===================================================================== #
+      _ << ' '
+      # ===================================================================== #
+      # Add -C option except for .deb packages and gunzip-based archives.
+      # ===================================================================== #
+      unless _ =~ /deb$/ or _.include?('gunzip')
+        _ << '-C '
+        _ << to
+      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:'
+      e _
+    else # Ok, here we are not in a simulation, hence we can run the command.
+      unless @skip_extracting
+        if File.writable? to
+          # ================================================================= #
+          # Next, run the sys-command, with some padding.
+          # ================================================================= #
+          begin
+            run_this_system_command(
+              "  #{_}", :also_show_what_we_will_do
+            )
+          # ================================================================= #
+          # We have to rescue because unrar might not be available and so on.
+          # ================================================================= #
+          rescue Exception => error
+            e 'An error has happened upon attempting to run this system command:'
+            e
+            e "  #{_}"
+            e
+            pp error
+            e '-----------'
+            pp error.class
+            e '-----------'
+          end
+          @did_we_extract_already = true
+        else
+          copn; ewarn 'You do not have sufficient permissions to'
+          copn; ewarn "modify #{sdir(to)}."
+        end
+      end
+    end
+  end; alias do_extract_to do_extract_what_to # === do_extract_to
+       alias start         do_extract_what_to # === start
+
+end; end

data/lib/extracter/extract_it/extract_it.rb

@@ -0,0 +1,237 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Extracter::ExtractIt
+#
+# 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 example:
+#
+#   Extracter::ExtractIt.new(ARGV)
+#
+# =========================================================================== #
+# require 'extracter/extract_it/extract_it.rb'
+# =========================================================================== #
+module Extracter
+
+class ExtractIt # === Extracter::ExtractIt
+
+  begin
+    require 'opn'
+  rescue LoadError; end
+
+  begin
+    require 'remove_file_suffix'
+  rescue LoadError; end
+
+  begin
+    require 'colours'
+    include Colours if Object.const_defined? :Colours
+  rescue LoadError; end
+
+  require 'extracter/extracter.rb'
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === ExtractIt::ARRAY_ARCHIVE_TYPES
+  #
+  # Register the available (and handled) archive types here.
+  # ========================================================================= #
+  ARRAY_ARCHIVE_TYPES = %w(
+    .apkg
+    .xz
+    .zip
+    .tar
+    .bz2
+    .7z
+  )
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      optional_set_input = nil,
+      run_already        = true
+    )
+    reset
+    set_input(optional_set_input)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    @debug = false
+  end
+
+  # ========================================================================= #
+  # === set_input
+  #
+  # We will work on an Array as value to @input, at the end of this
+  # method.
+  # ========================================================================= #
+  def set_input(i = N)
+    case i
+    # ======================================================================= #
+    # === extract_it --help
+    # ======================================================================= #
+    when /-?-?help$/i # Show some help stuff here.
+      e 'We will show a little bit help, then exit.'
+      e
+      e 'To extract .tar.xz, do:'
+      e
+      efancy '  -> tar -xJf *.tar.xz'
+      exit
+    end
+    i = [i] if i.is_a? String # Need an Array.
+    if @debug
+      opn; e 'The input given to us is: `'+sfile(i)+'`'
+    end
+    if i.is_a?(Array) and i.empty?
+      # ===================================================================== #
+      # 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
+    @input = i # Should be an array, always.
+  end
+
+  # ========================================================================= #
+  # === be_silent
+  # ========================================================================= #
+  def be_silent
+    @be_silent = true
+  end
+
+  # ========================================================================= #
+  # === be_verbose
+  # ========================================================================= #
+  def be_verbose
+    @be_silent = false
+  end; alias show_commands_used be_verbose # === show_commands_used
+
+  # ========================================================================= #
+  # === notify_the_user_that_no_input_was_given_but_this_file_was_found
+  # ========================================================================= #
+  def notify_the_user_that_no_input_was_given_but_this_file_was_found(
+      this_file
+    )
+    opn; e 'No input was given to '+sfancy(NAMESPACE)+' but a '\
+           '.zip file was'
+    opn; e 'found in this directory ('+sdir(Dir.pwd)+'): '+
+            sfancy(this_file)
+    opn; e 'We will use this zip file.'
+  end
+
+  # ========================================================================= #
+  # === extract_input
+  # ========================================================================= #
+  def extract_input
+    pp @input if @debug
+    @input.each {|entry|
+      to_this_dir = Dir.pwd
+      to_this_dir << '/' unless to_this_dir.end_with? '/'
+      unless File.exist? entry
+        entry = try_to_glob_on(entry)
+      end
+      # ===================================================================== #
+      # Delegate to class Extracter next.
+      # ===================================================================== #
+      Extracter.extract_what_to(
+        entry,
+        to_this_dir,
+        @be_silent
+      )
+      _ = RemoveFileSuffix[entry]
+      if File.exist? entry
+        # =================================================================== #
+        # Must also check whether the extracted directory exists.
+        # =================================================================== #
+        name_of_the_extracted_archive = to_this_dir+_
+        ARRAY_ARCHIVE_TYPES.each {|extension_name|
+          if name_of_the_extracted_archive.include? extension_name
+            quoted = Regexp.quote(extension_name)
+            name_of_the_extracted_archive.sub!(/#{quoted}$/,'')
+          end
+        }
+        if File.exist?(name_of_the_extracted_archive) and
+          # ================================================================= #
+          # The following check ensures that we really have another name
+          # for the extracted directory.
+          # ================================================================= #
+          !(entry == name_of_the_extracted_archive)
+          opn; e "Finished extracting #{sfile(_)} to `#{sdir(to_this_dir)}`."
+        else
+          opn; e "No file called `#{sfile(name_of_the_extracted_archive)}"\
+                 "` appears to exist."
+        end
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === is_archive?
+  # ========================================================================= #
+  def is_archive?(i)
+    ARRAY_ARCHIVE_TYPES.include?(
+      File.extname(File.basename(i))
+    )
+  end
+
+  # ========================================================================= #
+  # === try_to_glob_on
+  # ========================================================================= #
+  def try_to_glob_on(i)
+    result = Dir["#{i}*"]
+    # ======================================================================= #
+    # Next, sort this result to put archives on the beginning of the Array.
+    # ======================================================================= #
+    result = result.partition {|entry| is_archive?(entry) }
+    result.flatten!
+    unless result.empty?
+      # ===================================================================== #
+      # Ok, we grab the first entry next.
+      # ===================================================================== #
+      i = result.first
+      opn; e "No result could be found for the given input, thus "\
+             "using #{sfancy(i)} instead."
+    end
+    i
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    extract_input
+  end
+
+  # ========================================================================= #
+  # === Extracter::ExtractIt[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Extracter::ExtractIt.new(ARGV)
+end # extract_it.rb

data/lib/extracter/extracter.rb

@@ -0,0 +1,66 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Extracter
+#
+# The 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.
+#
+# We can also "extract" Audio files, by calling the module ExtractAudio.
+# You can try this - just pass a .mp4 file as first argument to
+# this class.
+#
+# Usage examples for class Extracter:
+#
+#   Extracter.new('foo.mp3')
+#   Extracter.new('xyz-1.0.tar.gz')
+#
+# Usage example:
+#
+#   Extracter.new
+#
+# =========================================================================== #
+# require 'extracter/extracter.rb'
+# =========================================================================== #
+
+# =========================================================================== #
+# Next, load up .rb files that belong to extracter/.
+# =========================================================================== #
+require 'extracter/version/version.rb'
+require 'extracter/constants/constants.rb'
+require 'extracter/class_methods.rb'
+require 'extracter/colours.rb'
+require 'extracter/do_extract_what_to.rb'
+require 'extracter/help.rb'
+require 'extracter/initialize.rb'
+require 'extracter/misc.rb'
+require 'extracter/reset.rb'
+require 'extracter/opn.rb'
+
+module Extracter
+
+class Extracter # === Extracter
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  # The second argument to Extracter.new is where we will
+  # extract to.
+  if ARGV.size > 2
+    _ = Extracter::Extracter.new(ARGV, :default, false)
+  else
+    _ = Extracter::Extracter.new(ARGV[0], ARGV[1], false)
+  end
+  _.extract_to Dir.pwd unless ARGV[1]
+  # _.enable_debug
+  _.be_verbose
+  _.run
+end # extracter
+    # extracter htop-1.0.2.tar.xz
+    # 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

data/lib/extracter/help.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  #
+  # This method will show the available - and documented - help options
+  # for class Extracter.
+  # ========================================================================= # 
+  def show_help
+    e
+    opnn; e 'How to extract archives, without helper scripts?'
+    e
+    opnn; e '  tar -zxvf foobar.tar.gz           # for .tar.gz'
+    opnn; e '  tar xvzf foobar.tgz               # for .tgz'
+    opnn; e '  tar xvfJ foobar.tar.xz            # for .tar.xz'
+    opnn; e '  tar jxf foobar.tar.bz2            # for .tar.bz2'
+    opnn; e '  tar -xf foobar.tar.bz2            # for .tbz'
+    opnn; e '  tar --lzip -xvf zutils-1.5.tar.lz # for .tar.lz'
+    opnn; e '  unsquashfs foobar-1.2.3.sxz       # for .sxz'
+    e
+    opnn; e 'Furthermore, there are some commandline options '\
+            'that can be used for this class (class Extracter).'
+    e
+    opnn; e '  --to=/home/Temp # extract into the '\
+            'directory /home/Temp/'
+    e
+  end
+
+end; end