repackage 1.0.30 → 1.1.8

data/lib/repackage/class/repackage.rb

@@ -2,759 +2,80 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === Repackage
+# === Repackage::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 primary purpose of this class is to repackage a .tar.gz archive into
+# a .tar.bz2 file or into another format.
 #
-# The default target format is to .tar.xz or more accurately,
-# to whatever value is specified via the constant
+# Thus, the ideal input to this class are files such as "foobar-1.2.3.tar.gz"
+# or something similar to this. These will be stored as an Array internally,
+# to allow batch-processing from the get go.
+#
+# The default target format is to .tar.xz or more accurately, to whatever
+# the value is that has been 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.
+# so it used to be a fairly "old" class. Obviously its use case was
+# necessary even a long time ago as-is.
+#
+# Over the years the class 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, thus allowing web-related use.
+#
+# In May 2022 the main class has again been rewritten. It was made
+# more logical, made most of its external gems optional (including
+# colour support) and more extensively documented - at the least
+# compared to the pre-2022 state.
 #
 # Usage example:
 #
-#   Repackage.new(ARGV)
+#   Repackage::Repackage.new(ARGV)
+#   Repackage.new(ARGV) # or this shorter variant.
 #
 # =========================================================================== #
 # require 'repackage/class/repackage.rb'
 # =========================================================================== #
-class Repackage
-
-  require 'fileutils'
-  require 'repackage/version/version.rb'
+module Repackage
 
-  require 'esystem/method'
+class Repackage # === Repackage::Repackage
 
-  require 'remove_file_suffix'
-  require 'totarxz'
+  alias e puts
 
-  begin
-    require 'colours'
-    include Colours
-  rescue LoadError; end
+  require 'extracter' # This external gem is mandatory - no need to begin/rescue it.
+  require 'fileutils'
+  require 'repackage/colours/colours.rb'
+  require 'repackage/class/constants.rb'
+  require 'repackage/class/misc.rb'
+  require 'repackage/version/version.rb'
 
   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
-
+  # === Repackage::Repackage[]
   # ========================================================================= #
-  # === 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)
+  def self.[](this = ARGV)
     new(this)
-  end; self.instance_eval { alias [] repackage } # === Repackage[]
+  end; self.instance_eval { alias repackage [] } # === 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
+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
+# =========================================================================== #
+# === Repackage.new
+# =========================================================================== #
+def self.new(i = ARGV)
+  ::Repackage::Repackage.new(i)
+end; self.instance_eval { alias repackage new } # === Repackage.repackage
 
 end
 
 if __FILE__ == $PROGRAM_NAME
   Repackage.new(ARGV)
-end
+end # repackage_class
 # =========================================================================== #
 # Usage examples with full syntax:
 #