extracter 1.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b260c677f0670e3f764bf8e90285a356b901a730e7829261a8c25b0136b8df1b
+  data.tar.gz: 7dedb77f42b215ac1d08bf529ae39048cb260e7407239c446275594e717d99b7
+SHA512:
+  metadata.gz: f681459221aac1216b4094d681161982934e1e41f4d15057100b25da08d1cb906dc8cbcefd9e439b7c8fb20bb6047c5783462fa2891d936f100b41dbb73e771e
+  data.tar.gz: 454105cfc7ba001f684a7098be48ecc37cae49e122b19694da9349c340611c03068e3461d1ed4c6159422c693723efac0ac34affda1b863531f5a52d553e292b

data/README.md

@@ -0,0 +1,79 @@
+[![forthebadge](http://forthebadge.com/images/badges/built-with-love.svg)](https://www.gobolinux.org/)
+[![forthebadge](http://forthebadge.com/images/badges/made-with-ruby.svg)](https://www.ruby-lang.org/en/)
+[![Gem Version](https://badge.fury.io/rb/extracter.svg)](https://badge.fury.io/rb/extracter)
+	
+# Extracter
+
+## Scope of Extracter
+
+The scope (and goals) for **class Extracter** are really simple: throw any archive
+format at it, and the class will try to **extract** it.
+
+It can be used on the commandline as well.
+
+## How to find out whether a given file is a valid archive
+
+You can find out whether given input xyz is a valid archive by issuing
+the following toplevel-method:
+
+    Extracter.is_this_a_valid_archive?(path)
+
+This will return either true or false.
+
+## How to extract an archive through class Extracter, in pure ruby
+
+You can use the following method to extract an archive, into a specific
+target location:
+
+    Extracter.extract_what_to('foo-1.0.tar.xz', '/tmp')
+
+The first argument is the local path to an archive. The second
+argument specifies the **target**, usually the target directory.
+
+## Colour support
+
+If the **Colours** gem (**gem install colours**) is available then colour
+support is possible for **class Extracter**. For the class, the instance
+variable **@use_colours** determines this. If you do not want to have
+colours then you can disable this, e. g. through the method call
+**.disable_colours** to give one example for doing so.
+
+## What archives and files can be extracted?
+
+class Extracter can extract .tar.xz, .tar.bz, .tar.gz, tar.Z,
+.zip and numerous more file formats. This requires that tools such
+as **tar** or **gzip** or **xz** are installed and available on the
+target computer-machine.
+
+It can also extract audio-files if ffmpeg is installed and the
+multimedia_paradise project is available (**gem install multimedia_paradise**),
+as well as squashfs files (typically .img files). In the latter case,
+such an .img file will be mounted in the current directory.
+
+Support for extracting .jar files has been added in **May 2020**.
+
+## class Extracter::ExtractIt
+
+class Extracter::ExtractIt was a standalone .gem (named **extract_it**), 
+but since as of September 2020 it is now part of "module Extracter".
+
+Basically this class is is a wrapper over the class Extracter,
+which will extract archives in general. The extraction step
+will go into the current working directory.
+
+
+## Contact information
+
+If your creative mind has ideas and specific suggestions to make this
+gem more useful in general, feel free to drop me an email at any
+time, via:
+
+    shevegen@gmail.com
+
+(Do keep in mind that responding to emails may take some time, depending
+on the amount of work I may have at that moment, due to reallife. I will,
+however had, read feedback. Patches and code changes are welcome too
+of course, as long as they are in the spirit of the project at
+hand, e. g. fitting to the general theme.)
+
+Thank you.

data/USAGE.md

@@ -0,0 +1,22 @@
+= Usage of Library
+
+== Requiring it
+
+  require 'extracter'
+
+== Using it in a project
+
+  _ = Extracter.extract_what_to('foobar-1.0.tar.bz2', '/tmp/')
+  
+  # You can also use the .new variant, which goes
+  # like so::
+
+  _ = Extracter.new('foo.gz', '/tmp', false) # Yes, you can extract .gz files.
+  _.run
+  
+  # The argument false means "do not yet run". You have to
+  # invoke the .run method in that case.
+  
+  # The second argument to the above method is the target
+  # location, the directory where we will extract our
+  # archive to.

data/bin/extract

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'extracter'
+
+Extracter.what_to(ARGV, Dir.pwd)

data/bin/extract_it

@@ -0,0 +1,15 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'extracter/extract_it/extract_it.rb'
+
+if __FILE__ == $PROGRAM_NAME
+  _ = Extracter::ExtractIt.new(ARGV, false)
+  if ARGV[1]
+    _.show_commands_used
+  else 
+    _.be_silent
+  end
+  _.run
+end # extractit

data/doc/README.gen

@@ -0,0 +1,62 @@
+ADD_RUBY_BADGE
+	
+# Extracter
+
+## Scope of Extracter
+
+The scope (and goals) for **class Extracter** are really simple: throw any archive
+format at it, and the class will try to **extract** it.
+
+It can be used on the commandline as well.
+
+## How to find out whether a given file is a valid archive
+
+You can find out whether given input xyz is a valid archive by issuing
+the following toplevel-method:
+
+    Extracter.is_this_a_valid_archive?(path)
+
+This will return either true or false.
+
+## How to extract an archive through class Extracter, in pure ruby
+
+You can use the following method to extract an archive, into a specific
+target location:
+
+    Extracter.extract_what_to('foo-1.0.tar.xz', '/tmp')
+
+The first argument is the local path to an archive. The second
+argument specifies the **target**, usually the target directory.
+
+## Colour support
+
+If the **Colours** gem (**gem install colours**) is available then colour
+support is possible for **class Extracter**. For the class, the instance
+variable **@use_colours** determines this. If you do not want to have
+colours then you can disable this, e. g. through the method call
+**.disable_colours** to give one example for doing so.
+
+## What archives and files can be extracted?
+
+class Extracter can extract .tar.xz, .tar.bz, .tar.gz, tar.Z,
+.zip and numerous more file formats. This requires that tools such
+as **tar** or **gzip** or **xz** are installed and available on the
+target computer-machine.
+
+It can also extract audio-files if ffmpeg is installed and the
+multimedia_paradise project is available (**gem install multimedia_paradise**),
+as well as squashfs files (typically .img files). In the latter case,
+such an .img file will be mounted in the current directory.
+
+Support for extracting .jar files has been added in **May 2020**.
+
+## class Extracter::ExtractIt
+
+class Extracter::ExtractIt was a standalone .gem (named **extract_it**), 
+but since as of September 2020 it is now part of "module Extracter".
+
+Basically this class is is a wrapper over the class Extracter,
+which will extract archives in general. The extraction step
+will go into the current working directory.
+
+ADD_CONTACT_INFORMATION

data/extracter.gemspec

@@ -0,0 +1,111 @@
+# =========================================================================== #
+# Gemspec for Project Extracter.
+# =========================================================================== #
+require 'extracter/version/version.rb'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'extracter'
+  s.version = Extracter::Extracter::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  DESCRIPTION = <<-EOF
+
+This fairly small class/library can be used to extract different archive
+formats such as .tar.bz2 or .tbz - archives such as .gem and .lzma
+will also work.
+
+You can also extract audio, by making use of class ExtractAudio. The
+latter is - and should be - optional though.
+
+Usage example:
+
+    require 'extracter'
+
+    Extracter.new('/foo/bla-1.0.tar.bz2')
+
+The second argument that can be passed to the method new()
+specifies where we should extract to, example:
+
+    Extracter.new('/foo/bla-1.0.tar.bz2', '/opt')
+
+This would extract to the /opt directory.
+
+You can query whether input is an archive or not via:
+
+  Extracter.is_archive? 'foo.tar.xz'
+
+As of April 2014 we also provide a bin/extract file, so that
+you can simply extract something from the commandline.
+
+Since as of November 2018, class Extracter can also "extract"
+.iso files. (The .iso will be mounted to a directory that
+will be created, actually.)
+
+If you have a specific suggestion to make this gem more useful
+for others, please drop me an email at:
+
+    shevegen@gmail.com
+
+Thank you.
+
+EOF
+
+  s.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+
+  s.authors     = ['Robert A. Heiler']
+  s.email       = 'shevegen@gmail.com'
+  s.files       = Dir['**/*']
+  s.files      << 'USAGE.md' 
+  s.licenses    = 'GPL-2.0'
+  s.homepage    = 'http://rubygems.org/gems/extracter'
+
+  # ========================================================================= #
+  # Show this when a user installs the DiamondShell.
+  # ========================================================================= #
+  s.post_install_message = <<-EOF
+
+  class Extracter can be used to extract archives, such as .tar.gz or
+  .zip.
+
+  If you need some help, you can invoke bin/extract via:
+
+      extract --help
+
+  In general, the syntax for extract is kept simple. Just pass in the
+  archive that has to be extracted as the first argument to 
+  extract ( bin/extract) , and class Extracter will try to extract
+  it, if it is a registered archive format.
+
+  In ruby code, you may be able to use class Extracter in this manner:
+
+      require 'extracter'
+      Extracter[file_path_here]
+
+  or
+
+      require 'extracter'
+      Extracter.new(file_path_here)
+
+  Specific example:
+
+      require 'extracter'
+      Extracter.new('htop-2.2.0.tar.xz')
+
+  See the --help option.
+
+  EOF
+
+  s.required_ruby_version     = '>= '+RUBY_VERSION
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # Specify the dependencies for this gem:
+  # ========================================================================= #
+  s.add_dependency 'colours'
+  s.add_dependency 'opn'
+  s.add_dependency 'remove_file_suffix'
+
+}

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/lib/extracter/class_methods.rb

@@ -0,0 +1,143 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Extracter
+
+class Extracter
+
+  # ========================================================================= #
+  # === Extracter::Extracter.is_this_a_valid_archive?
+  #
+  # Query whether the input is a valid archive.
+  #
+  # The registered formats are stored in the constant
+  # ARRAY_REGISTERED_ARCHIVES.
+  # ========================================================================= #
+  def self.is_this_a_valid_archive?(i)
+    return_value = false
+    ARRAY_REGISTERED_ARCHIVES.each {|entry|
+      return_value = true if i =~ /#{entry}$/
+    }
+    return return_value
+  end; self.instance_eval { alias is_archive? is_this_a_valid_archive? } # === Extracter.is_archive?
+
+  # ========================================================================= #
+  # === Extracter.extract_what_to
+  #
+  # This method provides a convenient API to extract something to a 
+  # specified directory, as a class method. It defaults to the
+  # current working directory, as that is by far the most convenient
+  # way to extract a source tarball/archive.
+  #
+  # Useage example goes like this:
+  #
+  #   Extracter.extract_what_to('foo-1.0.tar.xz', '/tmp')
+  #
+  # ========================================================================= #
+  def self.extract_what_to(
+      what,
+      to                 = Dir.pwd, # <- This can also be a Hash.
+      optional_be_silent = false
+    )
+    _ = Extracter.new(what, to, :do_not_run_yet)
+    if to.is_a? Hash
+      # ===================================================================== #
+      # === :prepend_this_namespace
+      # ===================================================================== #
+      if to.has_key? :prepend_this_namespace
+        prefix_with_this = to.delete(:prepend_this_namespace) # Get rid of it from the Hash as well.
+        _.prefix_namespace_with(
+          prefix_with_this
+        )
+      end
+      # ===================================================================== #
+      # === :to
+      # ===================================================================== #
+      if to.has_key? :to
+        to = to.delete(:to)
+      end
+      # ===================================================================== #
+      # === :verbosity
+      #
+      # Handle how verbose we shall be.
+      # ===================================================================== #
+      if to.has_key? :verbosity
+        _.set_verbosity(
+          to.delete(:verbosity)
+        )
+      end
+      # ===================================================================== #
+      # === :use_colours
+      # ===================================================================== #
+      if to.has_key? :use_colours
+        _.set_use_colours(to[:use_colours])
+      end
+      # ===================================================================== #
+      # === :pad_opn_with_n_tokens
+      # ===================================================================== #
+      if to.has_key? :pad_opn_with_n_tokens
+        _.set_pad_opn_with_n_tokens(to[:pad_opn_with_n_tokens])
+      end
+      # ===================================================================== #
+      # === :use_opn
+      # ===================================================================== #
+      if to.has_key? :use_opn
+        _.set_use_opn(to[:use_opn])
+      end
+    end
+    if optional_be_silent
+      _.be_silent
+    else
+      _.be_verbose
+    end
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      when :show_the_full_name_of_the_archive
+        _.do_show_the_full_name_of_the_archive
+      end
+    end
+    _.run
+  end; self.instance_eval { alias extract_this extract_what_to } # === Extracter.extract_this
+       self.instance_eval { alias what_to      extract_what_to } # === Extracter.what_to
+       self.instance_eval { alias extract      extract_what_to } # === Extracter.extract
+
+  # ========================================================================= #
+  # === Extracter::Extracter[]
+  # ========================================================================= #
+  def self.[](i, where_to = Dir.pwd)
+    new(i, where_to)
+  end
+
+end
+
+# =========================================================================== #
+# === Extracter.is_this_a_valid_archive?
+# =========================================================================== #
+def self.is_this_a_valid_archive?(i)
+  ::Extracter::Extracter.is_this_a_valid_archive?(i)
+end
+
+# =========================================================================== #
+# === Extracter.extract_what_to
+# =========================================================================== #
+def self.extract_what_to(
+    what = 'foo-1.0.tar.xz',
+    to   = '/tmp',
+    optional_be_silent = false
+  )
+  ::Extracter::Extracter.extract_what_to(what, to, optional_be_silent)
+end
+
+# =========================================================================== #
+# === Extracter[]
+# =========================================================================== #
+def self.[](i, where_to = Dir.pwd)
+  ::Extracter::Extracter.new(i, where_to)
+end
+
+end