repackage 1.0.30

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4fdc05b46d4354b945db15f713602e1e3440dad372a828edc0f8815eb274787e
+  data.tar.gz: 55f1972e66f6edb4867c9aabd9d60140651010140a50fcbb13d32158c4e8c285
+SHA512:
+  metadata.gz: 8e1321698dfb40877514a0569dc87f10f2375ff0d31e0d0e65f55afc9b714d14f44c72ac40bdf2530c3b898b5a90664f5967c9cb6edc08cc003a07400bdf78de
+  data.tar.gz: 9f83ff0a55d551a6d517da53aec3411cc4fea1abad1975ac2f07583e28a7886ad856a91e6107f2281c013ad668db1c7d67997e3ded3bdcc7365bef46f91d2047

data/bin/repackager

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'repackage'
+
+Repackage.new(ARGV)

data/lib/repackage/class/repackage.rb

@@ -0,0 +1,768 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Repackage
+#
+# The purpose of this class is to repackage a .tar.gz file into
+# a .tar.bz2 file or into another format. Thus, the ideal input
+# are files such as "foobar-1.2.3.tar.gz" or something similar
+# to this.
+#
+# The default target format is to .tar.xz or more accurately,
+# to whatever value is specified via the constant
+# DEFAULT_TARGET_FORMAT_TYPE.
+#
+# Historically this class was first created at the end of August 2005,
+# so it used to be a fairly "old" class. Over the years it has been
+# extended to allow for more flexibility. In June 2021 it was re-written
+# from scratch, primarily to make use of @internal_hash rather than a
+# multitude of different instance variables; this coincided with 
+# making this functionality available via sinatra as well.
+#
+# Usage example:
+#
+#   Repackage.new(ARGV)
+#
+# =========================================================================== #
+# require 'repackage/class/repackage.rb'
+# =========================================================================== #
+class Repackage
+
+  require 'fileutils'
+  require 'repackage/version/version.rb'
+
+  require 'esystem/method'
+
+  require 'remove_file_suffix'
+  require 'totarxz'
+
+  begin
+    require 'colours'
+    include Colours
+  rescue LoadError; end
+
+  begin
+    require 'opn'
+  rescue LoadError; end
+
+  begin
+    require 'extracter'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === LAST_DOWNLOADED_FILE
+  # ========================================================================= #
+  begin
+    require 'wget'
+    LAST_DOWNLOADED_FILE = Wget.download_to?
+  rescue LoadError
+    LAST_DOWNLOADED_FILE = ENV['HOME'].to_s+'/LAST_DOWNLOADED_FILE.md'
+  end
+
+  # ========================================================================= #
+  # === DEFAULT_TARGET_FORMAT_TYPE
+  #
+  # The target format comes here.
+  # ========================================================================= #
+  DEFAULT_TARGET_FORMAT_TYPE = '.tar.xz' # '.tar.bz2'
+
+  # ========================================================================= #
+  # === MY_TEMP
+  # ========================================================================= #
+  if ENV['MY_TEMP']
+    EXTRACT_TO = ENV['MY_TEMP'].to_s+'/'  # Denote where to extract the stuff to.
+  else
+    EXTRACT_TO = '/tmp/'
+  end
+
+  # ========================================================================= #
+  # === CREATE_TAR_XZ
+  #
+  # This is the command that is used when a .tar.xz file is to be created.
+  # ========================================================================= #
+  CREATE_TAR_XZ = 'tar -vcJf'
+
+  # ========================================================================= #
+  # === CREATE_TAR_GZ
+  #
+  # Command to create a .tar.gz archive.
+  # ========================================================================= #
+  CREATE_TAR_GZ  = 'tar cfvz'
+
+  # ========================================================================= #
+  # === CREATE_TAR_BZ2
+  #
+  # Command to create a .tar.bz2 archive.
+  # ========================================================================= #
+  CREATE_TAR_BZ2 = 'tar cfvj'
+
+  # ========================================================================= #
+  # === CREATE_ZIP
+  #
+  # Command to create a .zip archive.
+  # ========================================================================= #
+  CREATE_ZIP = 'zip -r '
+
+  # ========================================================================= #
+  # === SHALL_WE_DELETE_THE_OLD_ARCHIVE
+  #
+  # Remove the old source if this constant is true. Since as of June 2021
+  # this defaults to false, except in certain conditions met on my home
+  # setup.
+  # ========================================================================= #
+  SHALL_WE_DELETE_THE_OLD_ARCHIVE = false
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument given to this class must be the name of (or path
+  # to) a locally existing file, such as "foobar-1.0.tar.gz".
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    register_sigint
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    # ========================================================================= #
+    # === Handle given blocks next
+    # ========================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :do_not_delete_the_old_source
+      # ===================================================================== #
+      when :do_not_delete_the_old_source
+        set_shall_we_delete_old_source(false)
+      # ===================================================================== #
+      # === :run_already
+      # ===================================================================== #
+      when :run_already
+        run_already = true
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    # ========================================================================= #
+    # === @internal_hash
+    # ========================================================================= #
+    @internal_hash = {}
+    set_start_dir
+    # ========================================================================= #
+    # === :repackage_to_this_format
+    # ========================================================================= #
+    set_repackage_to_this_format(DEFAULT_TARGET_FORMAT_TYPE)
+    # ========================================================================= #
+    # === :the_new_file_is_at
+    #
+    # This entry will keep track at which new location the file can be
+    # found.
+    # ========================================================================= #
+    @internal_hash[:the_new_file_is_at] = nil
+    # ========================================================================= #
+    # === :file_size
+    # ========================================================================= #
+    @internal_hash[:file_size] = 0
+    set_shall_we_delete_the_old_archive(:default)
+    set_extract_to(:default)
+  end
+
+  # ========================================================================= #
+  # === determine_file_size
+  # ========================================================================= #
+  def determine_file_size(
+      i = filename?
+    )
+    if i and File.exist?(i)
+      @internal_hash[:file_size] = File.stat(i).size? # Obtain some information.
+    end
+  end
+
+  # ========================================================================= #
+  # === shall_we_delete_the_old_archive?
+  # ========================================================================= #
+  def shall_we_delete_the_old_archive?
+    @internal_hash[:shall_we_delete_the_old_archive]
+  end
+
+  # ========================================================================= #
+  # === set_repackage_to_this_format
+  #
+  # We will repackage to this format here.
+  # ========================================================================= #
+  def set_repackage_to_this_format(
+      i = DEFAULT_TARGET_FORMAT_TYPE
+    )
+    i = i.downcase if i # Only want it downcased.
+    case i # case tag
+    # ========================================================================= #
+    # === .tar.xz
+    # ========================================================================= #
+    when 'xz',
+         'tar.xz'
+      i = '.tar.xz'
+    # ========================================================================= #
+    # === .tar.bz2
+    # ========================================================================= #
+    when 'bz2',
+         '.tar.bz2'
+      i = '.tar.bz2'
+    # ========================================================================= #
+    # === .tar.gz
+    # ========================================================================= #
+    when 'targz',
+         'gz',
+         'tar.gz'
+      i = '.tar.gz'
+    # ========================================================================= #
+    # === nil
+    # ========================================================================= #
+    when nil # Assume a default here.
+      i = DEFAULT_TARGET_FORMAT_TYPE
+    else # else tag
+      # warn 'Did not find registered format type.'
+    end
+    @internal_hash[:repackage_to_this_format] = i
+  end; alias set_target_format_type set_repackage_to_this_format # === set_target_format_type
+       alias format=                set_repackage_to_this_format # === format=
+
+  # ========================================================================= #
+  # === repackage_to_which_format?
+  # ========================================================================= #
+  def repackage_to_which_format?
+    @internal_hash[:repackage_to_this_format]
+  end; alias format?             repackage_to_which_format? # === format?
+       alias target_format?      repackage_to_which_format? # === target_format?
+       alias target_format_type? repackage_to_which_format? # === target_format_type?
+
+  # ========================================================================= #
+  # === return_pwd
+  # ========================================================================= #
+  def return_pwd
+    "#{Dir.pwd}/".squeeze('/')
+  end
+
+  # ========================================================================= #
+  # === register_sigint
+  # ========================================================================= #
+  def register_sigint
+    Signal.trap('SIGINT') { exit }
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end; alias first? first_argument? # === first?
+
+  # ========================================================================= #
+  # === determine_relevant_entries
+  # ========================================================================= #
+  def determine_relevant_entries
+    set_repackage_this_file(first?)
+    second_argument = @commandline_arguments[1]
+    if second_argument
+      # ===================================================================== #
+      # Let the user determine the format type:
+      # ===================================================================== #
+      set_target_format_type(
+        second_argument
+      )
+    end
+  end
+
+  # ========================================================================= #
+  # === real_file_name
+  #
+  # This method will return the filename of this class.
+  # ========================================================================= #
+  def real_file_name
+    return File.basename(__FILE__)+': '
+  end
+
+  # ========================================================================= #
+  # === remove
+  #
+  # Remove a file or a directory with this method.
+  # ========================================================================= #
+  def remove(i)
+    if File.directory?(i)
+      FileUtils.rm_rf(i) unless i.strip == '/'
+    elsif File.file?(i)
+      File.delete(i)
+    end
+  end
+
+  # ========================================================================= #
+  # === cliner
+  # ========================================================================= #
+  def cliner
+    e ('=' * 80)
+  end
+
+  # ========================================================================= #
+  # === set_extract_to
+  #
+  # Set the @extract_to variable here.
+  # ========================================================================= #
+  def set_extract_to(i = EXTRACT_TO)
+    case i
+    when nil, :default
+      i = EXTRACT_TO
+    end
+    i = i.to_s.dup
+    i = '/tmp/' if i.empty? # Hardcoded in this case.
+    i << '/' unless i.end_with? '/' # A directory has a trailing /.
+    @internal_hash[:extract_to] = i
+  end
+  
+  # ========================================================================= #
+  # === extract_to?
+  #
+  # Defaults to /home/Temp/ on my home system.
+  # ========================================================================= #
+  def extract_to?
+    @internal_hash[:extract_to]
+  end; alias extract_to extract_to? # === extract_to
+
+  # ========================================================================= #
+  # === set_repackage_this_file
+  # ========================================================================= #
+  def set_repackage_this_file(i = first?)
+    if i.is_a? Array
+      i = i.first
+    end
+    case i
+    when nil
+      # ===================================================================== #
+      # Since as of May 2013 we try to fetch a random file from a list.
+      # ===================================================================== # 
+      _ = Dir['*'].reject {|entry| File.directory? entry}
+      i = _.first if _.size == 1 # if we only have one entry, continue here.
+    # ========================================================================= #
+    # === --last
+    # ========================================================================= #
+    when 'LAST','LAST_DOWNLOADED',
+         /^-?-?last/i,
+         '-l'
+      i = File.readlines(LAST_DOWNLOADED_FILE).first
+      # ===================================================================== #
+      # The format of the file has changed a bit. We have to check
+      # whether it includes a '#' character. If so then we discard
+      # all that comes after said '#' token.
+      # ===================================================================== #
+      if i.include? '#'
+        i = i[0..(i.index('#')-1)].strip
+      end
+    end
+    i = i.to_s.dup
+    if File.directory?(i) and !i.end_with?('/')
+      i << '/'
+    end
+    if i.nil? or i.empty?
+      raise 'Please provide a valid archive to repackage.'
+    end
+    determine_file_size if File.exist? i
+    @internal_hash[:repackage_this_file] = i
+    # ========================================================================= #
+    # === :original_directory_where_the_archive_was_kept
+    #
+    # This variant will always refer to the directory where the archive
+    # is situated in.
+    # ========================================================================= #
+    @internal_hash[:original_directory_where_the_archive_was_kept] = rds(
+      File.absolute_path(
+        File.dirname(i)
+      )+'/'
+    )
+  end; alias set_package set_repackage_this_file # === set_package
+
+  # ========================================================================= #
+  # === rds
+  # ========================================================================= #
+  def rds(i)
+    i.squeeze '/'
+  end
+
+  # ========================================================================= #
+  # === change_dir_to                                                (cd tag)
+  # ========================================================================= #
+  def change_dir_to(
+      where_to = extract_to?
+    )
+    Dir.chdir(where_to)
+  end; alias cd change_dir_to # === cd
+
+  # ========================================================================= #
+  # === is_on_roebe?
+  # ========================================================================= #
+  def is_on_roebe?
+    ENV['IS_ROEBE'].to_s == '1'
+  end
+
+  # ========================================================================= #
+  # === set_start_dir
+  # ========================================================================= #
+  def set_start_dir(
+      i = return_pwd
+    )
+    @internal_hash[:start_dir] = i
+  end
+
+  # ========================================================================= #
+  # === remove_archive_from
+  # ========================================================================= #
+  def remove_archive_from(i)
+    i.delete_suffix('.xz').
+      delete_suffix('.gz').
+      delete_suffix('.bz2').
+      delete_suffix('.zip').
+      delete_suffix('.tar')
+  end; alias remove_extension remove_archive_from # === remove_extensions
+
+  # ========================================================================= #
+  # === set_the_new_file_is_at
+  # ========================================================================= #
+  def set_the_new_file_is_at(i)
+    @internal_hash[:the_new_file_is_at] = i
+  end; alias set_final_location set_the_new_file_is_at # === set_final_location
+
+  # ========================================================================= #
+  # === the_final_location_is_at?
+  # ========================================================================= #
+  def the_final_location_is_at?
+    @internal_hash[:the_new_file_is_at]
+  end; alias the_new_file_is_at? the_final_location_is_at? # === the_new_file_is_at?
+       alias the_file_is_where?  the_final_location_is_at? # === the_file_is_where?
+
+  # ========================================================================= #
+  # === remove_extracted_data
+  # ========================================================================= #
+  def remove_extracted_data # remove the extracted archive again.
+    _ = "#{extract_to?}/#{remove_extension(filename?)}"
+    remove(_) if File.exist? _ # We remove a possibly-existing, extracted directory first.
+  end
+
+  # ========================================================================= #
+  # === internal_hash?
+  # ========================================================================= #
+  def internal_hash?
+    @internal_hash
+  end; alias hash? internal_hash? # === hash?
+
+  # ========================================================================= #
+  # === create_archive_from_this_directory                       (create tag)
+  # ========================================================================= # 
+  def create_archive_from_this_directory(
+      this_directory,
+      repackage_to_this_format = repackage_to_which_format?
+    )
+    esystem "#{CREATE_TAR_XZ} #{this_directory}#{repackage_to_this_format} #{File.basename(this_directory)}"
+  end; alias package_this_directory create_archive_from_this_directory # === package_this_directory
+
+  # ========================================================================= #
+  # === Repackage.repackage
+  # ========================================================================= #
+  def self.repackage(this)
+    new(this)
+  end; self.instance_eval { alias [] repackage } # === Repackage[]
+
+  # ========================================================================= #
+  # === package_full_name?
+  # ========================================================================= #
+  def package_full_name?(
+      i = repackage_which_file?
+    )
+    File.absolute_path(i)
+  end
+
+  # ========================================================================= #
+  # === repackage_which_file?
+  # ========================================================================= #
+  def repackage_which_file?
+    @internal_hash[:repackage_this_file]
+  end; alias filename? repackage_which_file? # === filename?
+
+  # ========================================================================= #
+  # === move_this_package_to                                       (move tag)
+  #
+  # Use this method to move a package to a new location.
+  # ========================================================================= #
+  def move_this_package_to(
+      new_location = the_file_is_where?,
+      where_to     = start_dir?
+    )
+    package_full_name = File.absolute_path(new_location)
+    if File.exist? package_full_name
+      opn; e 'Moving the package at '+sfile(package_full_name)+
+             ' to '+sfile(where_to)+' next.'
+      FileUtils.mv(package_full_name, where_to)
+      set_final_location(where_to)
+    else
+      e 'No file at '+sfile(package_full_name)+' exists, thus '\
+        'we can not move anything.'
+    end
+  end
+
+  # ========================================================================= #
+  # === start_dir?
+  # ========================================================================= #
+  def start_dir?
+    @internal_hash[:start_dir]
+  end
+
+  # ========================================================================= #
+  # === cd_to_the_extract_to_directory_then_set_it_as_the_start_dir
+  # ========================================================================= #
+  def cd_to_the_extract_to_directory_then_set_it_as_the_start_dir
+    cd EXTRACT_TO
+    set_start_dir EXTRACT_TO
+  end
+
+  # ========================================================================= #
+  # === consider_refusing_the_repackaging_action
+  #
+  # This method acts as a tiny "safeguard", so we don't repackage when
+  # the target format is the same as the original archive format.
+  # ========================================================================= #
+  def consider_refusing_the_repackaging_action(
+      i = repackage_which_file?
+    )
+    target_format_type = target_format_type?
+    if i.include? target_format_type
+      opn; e "We can not repackage #{simp(i)} into the"
+      opn; e "same target archive format (#{sfancy(target_format_type)})."
+      exit
+    end
+  end
+
+  # ========================================================================= #
+  # === try_glob
+  #
+  # Try a glob with this method.
+  # ========================================================================= #
+  def try_glob(i)
+    return Dir[i+'*']
+  end
+
+  # ========================================================================= #
+  # === dir_where_the_archive_resides?
+  # ========================================================================= #
+  def dir_where_the_archive_resides?
+    @internal_hash[:original_directory_where_the_archive_was_kept]
+  end
+
+  # ========================================================================= #
+  # === extract                                                 (extract tag)
+  #
+  # Extract it here. Before we do so, though, we must check if the target
+  # does not exist yet.
+  # ========================================================================= #
+  def extract(
+      what = filename?
+    )
+    if what.frozen?
+      what = what.dup
+    end
+    unless what.include? '/'
+      what = dir_where_the_archive_resides?+File.basename(what)
+    end
+    remove_extracted_data
+    Extracter.extract_what_to(what, extract_to?)
+  end
+
+  # ========================================================================= #
+  # === warn_about_missing_file_then_exit
+  # ========================================================================= #
+  def warn_about_missing_file_then_exit(
+      i = target_file?
+    )
+    opn;e swarn('The file `')+
+          sfile(i)+
+          swarn('` does not exist.')
+    raise "The argument must be an existing (local) file. As "\
+          "the file does not exist, this class can not continue."
+  end
+
+  # ========================================================================= #
+  # === check_whether_the_archive_exists
+  # ========================================================================= #
+  def check_whether_the_archive_exists(
+      _ = dir_where_the_archive_resides?+repackage_which_file?
+    )
+    cliner
+    if File.file? _
+      opn; e "Good, the file `#{sfile(_)}` exists."
+      opn; e 'We will try to repackage it into `'+
+              simportant(target_format_type?)+'` format type.'
+      opn; e 'We will extract into the directory '+sdir(extract_to?)+'.'
+    else
+      # ===================================================================== #
+      # Ok - in this case the file does not exist. We will first try
+      # to check if we have a number as input; if so we then we may
+      # try a glob-action. And if not, we will raise an error.
+      # ===================================================================== #
+      if first? and (first? =~ /^\d$/) # If input is a (positional) number like "3"
+        _ = Dir['*'].sort[first?.to_i - 1]
+        set_repackage_this_file(_)
+      else
+        # =================================================================== #
+        # Try a glob first before giving up.
+        # =================================================================== #
+        _ = try_glob(first?) if first?
+        if _.empty?
+          warn_about_missing_file_then_exit
+        else
+          check_if_this_target_exists_or_not(_.first)
+        end
+      end
+    end
+    cliner
+  end; alias check_if_this_target_exists_or_not check_whether_the_archive_exists # === check_if_this_target_exists_or_not
+       alias check_if_target_exists_or_not      check_whether_the_archive_exists # === check_if_target_exists_or_not
+
+  # ========================================================================= #
+  # === do_repackage_everything
+  #
+  # This is the main workforce of this class, the "powerhorse method".
+  #
+  # Call it when you are ready to go and wish to re-package a given
+  # archive.
+  # ========================================================================= #
+  def do_repackage_everything
+    check_whether_the_archive_exists
+    consider_refusing_the_repackaging_action
+    target_file = repackage_which_file?
+    # ======================================================================= #
+    # Next extract this file:
+    # ======================================================================= #
+    extract(target_file)
+    # ======================================================================= #
+    # Now we have to repackage the extracted directory:
+    # ======================================================================= #
+    repackage_to_this_format = repackage_to_which_format?
+    _ = extract_to?+remove_archive_from(File.basename(target_file))
+    cd extract_to? # Ideally, we should not change directory ever.
+    case repackage_to_this_format # case tag
+    when '.tar.xz',
+         'xz',
+         '.tar.bz2',
+         'tar.bz2',
+         'tarbz2',
+         'totarbz2',
+         'tbz2',
+         'zip'
+      if File.directory? _
+        create_archive_from_this_directory(_, repackage_to_this_format)
+      end
+      new_location = _+repackage_to_this_format
+      if File.exist? new_location
+        set_the_new_file_is_at(new_location)
+        cd @internal_hash[:original_directory_where_the_archive_was_kept]
+        move_this_package_to(
+          new_location,
+          @internal_hash[:original_directory_where_the_archive_was_kept]
+        )
+        cd start_dir?
+        if shall_we_delete_the_old_archive?
+          remove_the_old_archive
+          remove_extracted_data
+        end
+      end
+    else
+      e tomato('Unhandled format type: ')+
+        steelblue(repackage_to_this_format)
+    end
+  end; alias repackage_data do_repackage_everything # === repackage_data
+
+  # ========================================================================= #
+  # === set_shall_we_delete_the_old_archive
+  # ========================================================================= #
+  def set_shall_we_delete_the_old_archive(
+      i = :default
+    )
+    case i
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default,
+         nil
+      i = SHALL_WE_DELETE_THE_OLD_ARCHIVE
+      if is_on_roebe?
+        i = true
+      end
+    end
+    @internal_hash[:shall_we_delete_the_old_archive] = i
+  end; alias set_shall_we_delete_old_source set_shall_we_delete_the_old_archive # === set_shall_we_delete_old_source
+
+  # ========================================================================= #
+  # === remove_the_old_archive
+  #
+  # Only call this when we are sure to remove the old source. I recommend
+  # to delete the old source. Of course we must make sure to delete the
+  # right package.
+  # ========================================================================= #
+  def remove_the_old_archive(
+      i = dir_where_the_archive_resides?+filename?
+    )
+    opn; e "Removing the old archive at #{sfile(i)} next, as requested."
+    remove(i)
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    determine_relevant_entries
+    cd_to_the_extract_to_directory_then_set_it_as_the_start_dir
+    opn; e 'Working from the directory '+sdir(start_dir?)+'.'
+    do_repackage_everything
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Repackage.new(ARGV)
+end
+# =========================================================================== #
+# Usage examples with full syntax:
+#
+#   rer filename.tar.gz format_type
+#   rer xpdf-3.00.tar.gz gzip
+#   rer AUD_MusicBox-020.tgz
+#   rer AUD_MusicBox-020.tgz
+#   rer
+#   repackagerb zlib-1.2.11.tar.gz
+#
+# =========================================================================== #

data/lib/repackage/requires/require_the_sinatra_interface.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'repackage/requires/embeddable_interface.rb'
+# =========================================================================== #
+require 'repackage/www/embeddable_interface.rb'

data/lib/repackage/version/version.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'repackage/version/version.rb'
+# =========================================================================== #
+class Repackage
+
+  # =========================================================================== #
+  # === VERSION
+  # =========================================================================== #
+  VERSION = '1.0.30'
+
+  # =========================================================================== #
+  # === LAST_UPDATE
+  # =========================================================================== #
+  LAST_UPDATE = '01.04.2022'
+
+end

data/lib/repackage/www/README.md

@@ -0,0 +1,2 @@
+The code in this directory can be used to make the repackage functionality
+available via the www, such as through sinatra.

data/lib/repackage/www/embeddable_interface.rb

@@ -0,0 +1,66 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'repackage/www/embeddable_interface.rb'
+# =========================================================================== #
+class Repackage
+
+module EmbeddableInterface
+
+  # ========================================================================= #
+  # === Repackage::EmbeddableInterface.routes?
+  #
+  # Define all legal routes via this Array. This Array will then be used
+  # to add more routes to any sinatra-application that needs it.
+  # ========================================================================= #
+  def self.routes?
+    [
+      'repackage',
+      'repackage/*'
+    ]
+  end
+
+  # ========================================================================= #
+  # === return_sinatra_repackage
+  # ========================================================================= #
+  def return_sinatra_repackage
+    'Please provide the name of the target archive that is to be repackaged.'
+  end
+
+  # ========================================================================= #
+  # === return_sinatra_repackage_with_arguments
+  # ========================================================================= #
+  def return_sinatra_repackage_with_arguments(
+      i = web_params_as_string?
+    )
+    i = i.dup if i.frozen?
+    _ = ''.dup
+    _ << 'The parameters given were: <b style="darkblue">'+i+'</b><br>'
+    i.prepend('/') unless i.start_with? '/'
+    if File.exist? i
+      _ << 'Repackaging this file next.<br>'
+      result = Repackage.new(i) {
+        :do_not_delete_the_old_source
+      }
+      _ << 'The archive is now available at: <b>'+
+            result.the_final_location_is_at?.to_s+
+            '</b>'
+    else
+      _ << 'No file exists at '+i
+    end
+    return _
+  end
+
+end
+
+# =========================================================================== #
+# === Repackage.embeddable_interface
+# =========================================================================== #
+def self.embeddable_interface
+  object = Object.new
+  object.extend(Repackage::EmbeddableInterface)
+  return object
+end
+
+end

data/lib/repackage.rb

@@ -0,0 +1,2 @@
+require 'repackage/class/repackage.rb'
+require 'repackage/www/embeddable_interface.rb'

data/repackage.gemspec

@@ -0,0 +1,55 @@
+# =========================================================================== #
+# Gemspec for Project Repackage.
+# =========================================================================== #
+require 'repackage/version/version.rb'
+require 'roebe'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'repackage'
+  s.version = Repackage::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+  
+  s.summary = <<-EOF
+
+This library is called repackage. It allows you to 
+repackage an archive, i.e. .tar.gz to .tar.xz format.
+
+If the target (the input you give to this class) can
+not be found, we will try a glob before giving up
+first, since version 1.0.2.
+
+  EOF
+  
+  s.description = <<-EOF
+
+This library is called repackage. It allows you to 
+repackage an archive, i.e. .tar.gz to .tar.xz format.
+
+Since as of April 2021 (not an april joke), the
+licence is now LGPL-2.1 rather than GPL-2.x. It
+was considered to simplify integrating LGPL
+into other projects rather than GPL.
+
+  EOF
+  
+  s.extra_rdoc_files = %w()
+
+  s.authors     = ['Robert A. Heiler']
+  s.email       = Roebe.email?
+  s.files       = Dir['**/*']
+  s.licenses    = 'MIT'
+
+  s.homepage    = 'https://rubygems.org/gems/repackage'
+  s.executables = Dir['bin/*'].map { |f| File.basename(f) }
+
+  s.required_ruby_version     = '>= '+Roebe.third_most_stable_version_of_ruby
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  s.add_dependency 'colours'
+  s.add_dependency 'extracter'
+  s.add_dependency 'esystem'
+  s.add_dependency 'opn'
+
+}

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: repackage
+version: !ruby/object:Gem::Version
+  version: 1.0.30
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-04-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colours
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: extracter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: esystem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: opn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "\nThis library is called repackage. It allows you to \nrepackage an
+  archive, i.e. .tar.gz to .tar.xz format.\n\nSince as of April 2021 (not an april
+  joke), the\nlicence is now LGPL-2.1 rather than GPL-2.x. It\nwas considered to simplify
+  integrating LGPL\ninto other projects rather than GPL.\n\n"
+email: shevy@inbox.lt
+executables:
+- repackager
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/repackager
+- lib/repackage.rb
+- lib/repackage/class/repackage.rb
+- lib/repackage/requires/require_the_sinatra_interface.rb
+- lib/repackage/version/version.rb
+- lib/repackage/www/README.md
+- lib/repackage/www/embeddable_interface.rb
+- repackage.gemspec
+homepage: https://rubygems.org/gems/repackage
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.8
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.7
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: This library is called repackage. It allows you to  repackage an archive,
+  i.e. .tar.gz to .tar.xz format.  If the target (the input you give to this class)
+  can not be found, we will try a glob before giving up first, since version 1.0.2.
+test_files: []