extracter 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 88fe5f6b81c9fce68a6d838cfdcef1c9858faf1c736d6d76cb288d1217062043
+  data.tar.gz: 8be661f699fbcd0b42db87235d69b1f0a0fc7ac0da0fa4cf876c2256bc980573
+SHA512:
+  metadata.gz: eff820355199d58175269a382940260b6c1a54702d7f1ccbde8a17999b0cab45dbd6799320a22b6312387692da04d2a200da928186463b773bbe1ef4a1e8bdc0
+  data.tar.gz: fd8139d76229652883f71a44129ff6b589f902ef34466ecff11e10a0f222765b0c933fb62d5f9a9ec5faafc33cd854b3a4a9217491363615db6737bb524fd5d7

data/README.md

@@ -0,0 +1,70 @@
+[![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**.
+
+
+## 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/doc/README.gen

@@ -0,0 +1,53 @@
+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**.
+
+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::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,5 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'extracter/extracter.rb'

data/lib/extracter/class_methods.rb

@@ -0,0 +1,114 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+class 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[]
+  # ========================================================================= #
+  def self.[](i, where_to = Dir.pwd)
+    new(i, where_to)
+  end
+
+end

data/lib/extracter/colours.rb

@@ -0,0 +1,124 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+class Extracter
+
+  begin
+    require 'colours'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === use_colours?
+  #
+  # Determine whether we will use colours in class Extracter.
+  # ========================================================================= #
+  def use_colours?
+    @use_colours
+  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.
+    # ======================================================================= #
+    @use_this_opn_hash.update(use_colours: i)
+    @use_colours = i
+  end
+
+  # ========================================================================= #
+  # === disable_colours
+  #
+  # Use this method if you want to disable colour-support of this class.
+  # ========================================================================= #
+  def disable_colours
+    @use_colours = false
+    @colour_to_use_for_directories = ''.dup
+  end
+
+  # ========================================================================= #
+  # === enable_colours
+  # ========================================================================= #
+  def enable_colours
+    @use_colours = true
+    @colour_to_use_for_directories = cyan?
+  end
+
+  # ========================================================================= #
+  # === set_colour_for_directories
+  #
+  # Set the colour for directories to use.
+  # ========================================================================= #
+  def set_colour_for_directories(i)
+    @colour_to_use_for_directories = Colours.beautify(i)
+  end
+
+  # ========================================================================= #
+  # === colour_to_use_for_directories?
+  # ========================================================================= #
+  def colour_to_use_for_directories?
+    if @use_colours
+      @colour_to_use_for_directories
+    else
+      ''
+    end
+  end
+
+  # ========================================================================= #
+  # === cyan
+  # ========================================================================= #
+  def cyan?
+    if @use_colours
+      Colours::CYAN
+    else
+      ''
+    end
+  end
+
+  # ========================================================================= #
+  # === ewarn
+  # ========================================================================= #
+  def ewarn(i = '')
+    if use_colours?
+      e Colours.swarn(i)
+    else
+      e i
+    end
+  end
+
+  # ========================================================================= #
+  # === simp
+  # ========================================================================= #
+  def simp(i = '')
+    return Colours.simp(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(i = '')
+    return Colours.sfancy(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === sfancy
+  # ========================================================================= #
+  def sfancy(i = '')
+    return Colours.sfancy(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(i = '')
+    return Colours.sdir(i) if @use_colours
+    return i
+  end
+
+end