extracter 1.1.0

data/lib/extracter/constants/constants.rb

@@ -0,0 +1,95 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+class Extracter
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === N
+  # ========================================================================= #
+  N = "\n"
+
+  # ========================================================================= #
+  # === LAST_UPDATED
+  #
+  # When this class was last updated/releasted. This is not a hugely
+  # important constat, so do not worry too much if this may be
+  # heavily outdated eventually.
+  # ========================================================================= #
+  LAST_UPDATED = '14 Jun 2020'
+
+  # ========================================================================= #
+  # === TEMP_DIR
+  #
+  # Set the temp dir here.
+  # ========================================================================= #
+  if ENV['MY_TEMP']
+    TEMP_DIR = ENV['MY_TEMP'].to_s+'/'
+  else
+    # ======================================================================= #
+    # If this environment variable is unavailable then use a conservative
+    # default value.
+    # ======================================================================= #
+    TEMP_DIR = '/tmp/'
+  end
+
+  # ========================================================================= #
+  # === SHOW_ONLY_THE_SHORT_NAME_OF_THE_ARCHIVE
+  #
+  # If this constant is set to true then we will only show the shortened
+  # name of the archive in question by default.
+  # ========================================================================= #
+  SHOW_ONLY_THE_SHORT_NAME_OF_THE_ARCHIVE = true
+
+  # ========================================================================= #
+  # === GEM_UNPACK_COMMAND
+  #
+  # The command to use to unpack ruby .gems.
+  # We can pass the ---target=DIR syntax to extract to a specific location.
+  # ========================================================================= #
+  GEM_UNPACK_COMMAND = 'gem unpack'
+
+  # ========================================================================= #
+  # === ARRAY_REGISTERED_ARCHIVES
+  #
+  # Archives that can be extracted, have to be registered in this Array.
+  #
+  # Sort alphabetically.
+  #
+  # The libreoffice format .odt is just like .zip.
+  # ========================================================================= #
+  ARRAY_REGISTERED_ARCHIVES = %w(
+    7z
+    bin
+    bz2
+    deb
+    gem
+    gz
+    img
+    iso
+    jar
+    lz
+    lzma
+    odt
+    mp4
+    rar
+    rpm
+    squashfs
+    sxz
+    tar
+    taz
+    tgz
+    txz
+    xpi
+    xz
+    zip
+    Z
+    zst
+  )
+
+end

data/lib/extracter/do_extract_what_to.rb

@@ -0,0 +1,288 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'extracter/do_extract_what_to.rb'
+# =========================================================================== #
+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.
+    # ======================================================================= #
+    # === 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
+    # ======================================================================= #
+    # === 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'
+    # ======================================================================= #
+    # === .tar
+    # ======================================================================= #
+    when '.tar','.tar.bz2'
+      _ << 'tar -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.
+      # _ << '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'
+      # 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

data/lib/extracter/extracter.rb

@@ -0,0 +1,62 @@
+#!/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'
+# =========================================================================== #
+
+# =========================================================================== #
+# 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'
+
+class Extracter # === Extracter
+end
+
+if __FILE__ == $PROGRAM_NAME
+  # The second argument to Extracter.new is where we will
+  # extract to.
+  if ARGV.size > 2
+    _ = Extracter.new(ARGV, :default, false)
+  else
+    _ = 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,32 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+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 --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