net-scp 1.0.0

data/lib/net/scp/download.rb

@@ -0,0 +1,150 @@
+require 'net/scp/errors'
+
+module Net; class SCP
+
+  # This module implements the state machine for downloading information from
+  # a remote server. It exposes no public methods. See Net::SCP#download for
+  # a discussion of how to use Net::SCP to download data.
+  module Download
+    private
+
+    # This is the starting state for the download state machine. The
+    # #start_command method puts the state machine into this state the first
+    # time the channel is processed. This state does some basic error checking
+    # and scaffolding and then sends a 0-byte to the remote server, indicating
+    # readiness to proceed. Then, the state machine is placed into the
+    # "read directive" state (see #read_directive_state).
+    def download_start_state(channel)
+      if channel[:local].respond_to?(:write) && channel[:options][:recursive]
+        raise Net::SCP::Error, "cannot recursively download to an in-memory location"
+      elsif channel[:local].respond_to?(:write) && channel[:options][:preserve]
+        lwarn { ":preserve option is ignored when downloading to an in-memory buffer" }
+        channel[:options].delete(:preserve)
+      elsif channel[:options][:recursive] && !File.exists?(channel[:local])
+        Dir.mkdir(channel[:local])
+      end
+
+      channel.send_data("\0")
+      channel[:state] = :read_directive
+    end
+
+    # This state parses the next full line (up to a new-line) for the next
+    # directive. (See the SCP protocol documentation in Net::SCP for the
+    # possible directives).
+    def read_directive_state(channel)
+      return unless line = channel[:buffer].read_to("\n")
+      channel[:buffer].consume!
+
+      directive = parse_directive(line)
+      case directive[:type]
+      when :times then
+        channel[:times] = directive
+      when :directory
+        read_directory(channel, directive)
+      when :file
+        read_file(channel, directive)
+      when :end
+        channel[:local] = File.dirname(channel[:local])
+        channel[:stack].pop
+        channel[:state] = :finish if channel[:stack].empty?
+      end
+
+      channel.send_data("\0")
+    end
+
+    # Reads data from the channel for as long as there is data remaining to
+    # be read. As soon as there is no more data to read for the current file,
+    # the state machine switches to #finish_read_state.
+    def read_data_state(channel)
+      return if channel[:buffer].empty?
+      data = channel[:buffer].read!(channel[:remaining])
+      channel[:io].write(data)
+      channel[:remaining] -= data.length
+      progress_callback(channel, channel[:file][:name], channel[:file][:size] - channel[:remaining], channel[:file][:size])
+      await_response(channel, :finish_read) if channel[:remaining] <= 0
+    end
+
+    # Finishes off the read, sets the times for the file (if any), and then
+    # jumps to either #finish_state (for single-file downloads) or
+    # #read_directive_state (for recursive downloads). A 0-byte is sent to the
+    # server to indicate that the file was recieved successfully.
+    def finish_read_state(channel)
+      channel[:io].close unless channel[:io] == channel[:local]
+
+      if channel[:options][:preserve] && channel[:file][:times]
+        File.utime(channel[:file][:times][:atime],
+          channel[:file][:times][:mtime], channel[:file][:name])
+      end
+
+      channel[:file] = nil
+      channel[:state] = channel[:stack].empty? ? :finish : :read_directive
+      channel.send_data("\0")
+    end
+
+    # Parses the given +text+ to extract which SCP directive it contains. It
+    # then returns a hash with at least one key, :type, which describes what
+    # type of directive it is. The hash may also contain other, directive-specific
+    # data.
+    def parse_directive(text)
+      case type = text[0]
+      when ?T
+        parts = text[1..-1].split(/ /, 4).map { |i| i.to_i }
+        { :type  => :times,
+          :mtime => Time.at(parts[0], parts[1]),
+          :atime => Time.at(parts[2], parts[3]) }
+      when ?C, ?D
+        parts = text[1..-1].split(/ /, 3)
+        { :type => (type == ?C ? :file : :directory),
+          :mode => parts[0].to_i(8),
+          :size => parts[1].to_i,
+          :name => parts[2].chomp }
+      when ?E
+        { :type => :end }
+      else raise ArgumentError, "unknown directive: #{text.inspect}"
+      end
+    end
+
+    # Sets the new directory as the current directory, creates the directory
+    # if it does not exist, and then falls back into #read_directive_state.
+    def read_directory(channel, directive)
+      if !channel[:options][:recursive]
+        raise Net::SCP::Error, ":recursive not specified for directory download"
+      end
+
+      channel[:local] = File.join(channel[:local], directive[:name])
+
+      if File.exists?(channel[:local]) && !File.directory?(channel[:local])
+        raise "#{channel[:local]} already exists and is not a directory"
+      elsif !File.exists?(channel[:local])
+        Dir.mkdir(channel[:local], directive[:mode] | 0700)
+      end
+
+      if channel[:options][:preserve] && channel[:times]
+        File.utime(channel[:times][:atime], channel[:times][:mtime], channel[:local])
+      end
+
+      channel[:stack] << directive
+      channel[:times] = nil
+    end
+
+    # Opens the given file locally, and switches to #read_data_state to do the
+    # actual read.
+    def read_file(channel, directive)
+      if !channel[:local].respond_to?(:write)
+        directive[:name] = (channel[:options][:recursive] || File.directory?(channel[:local])) ?
+          File.join(channel[:local], directive[:name]) :
+          channel[:local]
+      end
+
+      channel[:file] = directive.merge(:times => channel[:times])
+      channel[:io] = channel[:local].respond_to?(:write) ? channel[:local] :
+        File.new(directive[:name], File::CREAT|File::TRUNC|File::RDWR, directive[:mode] | 0600)
+      channel[:times] = nil
+      channel[:remaining] = channel[:file][:size]
+      channel[:state] = :read_data
+
+      progress_callback(channel, channel[:file][:name], 0, channel[:file][:size])
+    end
+  end
+
+end; end

data/lib/net/scp/errors.rb

@@ -0,0 +1,5 @@
+module Net; class SCP
+
+  class Error < RuntimeError; end
+
+end; end

data/lib/net/scp/upload.rb

@@ -0,0 +1,142 @@
+require 'net/scp/errors'
+
+module Net; class SCP
+
+  # This module implements the state machine for uploading information to
+  # a remote server. It exposes no public methods. See Net::SCP#upload for
+  # a discussion of how to use Net::SCP to upload data.
+  module Upload
+    private
+
+    # The default read chunk size, if an explicit chunk-size is not specified
+    # by the client.
+    DEFAULT_CHUNK_SIZE = 2048
+
+    # The start state for uploads. Simply sets up the upload scaffolding,
+    # sets the current item to upload, and jumps to #upload_current_state.
+    def upload_start_state(channel)
+      if channel[:local].respond_to?(:read)
+        channel[:options].delete(:recursive)
+        channel[:options].delete(:preserve)
+      end
+
+      channel[:chunk_size] = channel[:options][:chunk_size] || DEFAULT_CHUNK_SIZE
+      set_current(channel, channel[:local])
+      await_response(channel, :upload_current)
+    end
+
+    # Determines what the next thing to upload is, and branches. If the next
+    # item is a file, goes to #upload_file_state. If it is a directory, goes
+    # to #upload_directory_state.
+    def upload_current_state(channel)
+      if channel[:current].respond_to?(:read)
+        upload_file_state(channel)
+      elsif File.directory?(channel[:current])
+        raise Net::SCP::Error, "can't upload directories unless :recursive" unless channel[:options][:recursive]
+        upload_directory_state(channel)
+      elsif File.file?(channel[:current])
+        upload_file_state(channel)
+      else
+        raise Net::SCP::Error, "not a directory or a regular file: #{channel[:current].inspect}"
+      end
+    end
+
+    # After transferring attributes (if requested), sends a 'D' directive and
+    # awaites the server's 0-byte response. Then goes to #next_item_state.
+    def upload_directory_state(channel)
+      if preserve_attributes_if_requested(channel)
+        mode = channel[:stat].mode & 07777
+        directive = "D%04o %d %s\n" % [mode, 0, File.basename(channel[:current])]
+        channel.send_data(directive)
+        channel[:cwd] = channel[:current]
+        channel[:stack] << Dir.entries(channel[:current]).reject { |i| i == "." || i == ".." }
+        await_response(channel, :next_item)
+      end
+    end
+
+    # After transferring attributes (if requested), sends a 'C' directive and
+    # awaits the server's 0-byte response. Then goes to #send_data_state.
+    def upload_file_state(channel)
+      if preserve_attributes_if_requested(channel)
+        mode = channel[:stat] ? channel[:stat].mode & 07777 : channel[:options][:mode]
+        channel[:name] = channel[:current].respond_to?(:read) ? channel[:remote] : channel[:current]
+        directive = "C%04o %d %s\n" % [mode || 0640, channel[:size], File.basename(channel[:name])]
+        channel.send_data(directive)
+        channel[:io] = channel[:current].respond_to?(:read) ? channel[:current] : File.open(channel[:current], "rb")
+        channel[:sent] = 0
+        progress_callback(channel, channel[:name], channel[:sent], channel[:size])
+        await_response(channel, :send_data)
+      end
+    end
+
+    # If any data remains to be transferred from the current file, sends it.
+    # Otherwise, sends a 0-byte and transfers to #next_item_state.
+    def send_data_state(channel)
+      data = channel[:io].read(channel[:chunk_size])
+      if data.nil?
+        channel[:io].close unless channel[:local].respond_to?(:read)
+        channel.send_data("\0")
+        await_response(channel, :next_item)
+      else
+        channel[:sent] += data.length
+        progress_callback(channel, channel[:name], channel[:sent], channel[:size])
+        channel.send_data(data)
+      end
+    end
+
+    # Checks the work queue to see what needs to be done next. If there is
+    # nothing to do, calls Net::SCP#finish_state. If we're at the end of a
+    # directory, sends an 'E' directive and waits for the server to respond
+    # before moving to #next_item_state. Otherwise, sets the next thing to
+    # upload and moves to #upload_current_state.
+    def next_item_state(channel)
+      if channel[:stack].empty?
+        finish_state(channel)
+      else
+        next_item = channel[:stack].last.shift
+        if next_item.nil?
+          channel[:stack].pop
+          channel[:cwd] = File.dirname(channel[:cwd])
+          channel.send_data("E\n")
+          await_response(channel, channel[:stack].empty? ? :finish : :next_item)
+        else
+          set_current(channel, next_item)
+          upload_current_state(channel)
+        end
+      end
+    end
+
+    # Sets the given +path+ as the new current item to upload.
+    def set_current(channel, path)
+      path = channel[:cwd] ? File.join(channel[:cwd], path) : path
+      channel[:current] = path
+
+      if channel[:current].respond_to?(:read)
+        channel[:stat] = channel[:current].stat if channel[:current].respond_to?(:stat)
+      else
+        channel[:stat] = File.stat(channel[:current])
+      end
+
+      channel[:size] = channel[:stat] ? channel[:stat].size : channel[:current].size
+    end
+
+    # If the :preserve option is set, send a 'T' directive and wait for the
+    # server to respond before proceeding to either #upload_file_state or
+    # #upload_directory_state, depending on what is being uploaded.
+    def preserve_attributes_if_requested(channel)
+      if channel[:options][:preserve] && !channel[:preserved]
+        channel[:preserved] = true
+        stat = channel[:stat]
+        directive = "T%d %d %d %d\n" % [stat.mtime.to_i, stat.mtime.usec, stat.atime.to_i, stat.atime.usec]
+        channel.send_data(directive)
+        type = stat.directory? ? :directory : :file
+        await_response(channel, "upload_#{type}")
+        return false
+      else
+        channel[:preserved] = false
+        return true
+      end
+    end
+  end
+
+end; end

data/lib/net/scp/version.rb

@@ -0,0 +1,18 @@
+require 'net/ssh/version'
+
+module Net; class SCP
+
+  # Describes the current version of the Net::SCP library.
+  class Version < Net::SSH::Version
+    MAJOR = 1
+    MINOR = 0
+    TINY  = 0
+
+    # The current version, as a Version instance
+    CURRENT = new(MAJOR, MINOR, TINY)
+
+    # The current version, as a String instance
+    STRING  = CURRENT.to_s
+  end
+
+end; end

data/lib/uri/open-scp.rb

@@ -0,0 +1,18 @@
+require 'open-uri'
+require 'uri/scp'
+require 'net/scp'
+
+module URI
+
+  class SCP
+    def buffer_open(buf, proxy, open_options)
+      options = open_options.merge(:port => port, :password => password)
+      progress = options.delete(:progress_proc)
+      buf << Net::SCP.download!(host, user, path, nil, open_options, &progress)
+      buf.io.rewind
+    end
+
+    include OpenURI::OpenRead
+  end
+
+end

data/lib/uri/scp.rb

@@ -0,0 +1,35 @@
+require 'uri/generic'
+
+module URI
+  class SCP < Generic
+    DEFAULT_PORT = 22
+
+    COMPONENT = [
+      :scheme,
+      :userinfo,
+      :host, :port, :path,
+      :query  
+    ].freeze
+
+    attr_reader :options
+
+    def self.new2(user, password, host, port, path, query)
+      new('scp', [user, password], host, port, nil, path, nil, query)
+    end
+
+    def initialize(*args)
+      super(*args)
+
+      @options = Hash.new
+      (query || "").split(/&/).each do |pair|
+        name, value = pair.split(/=/, 2)
+        opt_name = name.to_sym
+        values = value.split(/,/).map { |v| v.to_i.to_s == v ? v.to_i : v }
+        values = values.first if values.length == 1
+        options[opt_name] = values
+      end
+    end
+  end
+
+  @@schemes['SCP'] = SCP
+end

data/net-scp.gemspec

@@ -0,0 +1,60 @@
+
+# Gem::Specification for Net-scp-1.0.0
+# Originally generated by Echoe
+
+Gem::Specification.new do |s|
+  s.name = %q{net-scp}
+  s.version = "1.0.0"
+
+  s.specification_version = 2 if s.respond_to? :specification_version=
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jamis Buck"]
+  s.date = %q{2008-05-01}
+  s.description = %q{A pure Ruby implementation of the SCP client protocol}
+  s.email = %q{jamis@jamisbuck.org}
+  s.files = ["CHANGELOG.rdoc", "lib/net/scp/download.rb", "lib/net/scp/errors.rb", "lib/net/scp/upload.rb", "lib/net/scp/version.rb", "lib/net/scp.rb", "lib/uri/open-scp.rb", "lib/uri/scp.rb", "Rakefile", "README.rdoc", "setup.rb", "test/common.rb", "test/test_all.rb", "test/test_download.rb", "test/test_scp.rb", "test/test_upload.rb", "Manifest", "net-scp.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://net-ssh.rubyforge.org/scp}
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{net-ssh}
+  s.rubygems_version = %q{1.1.1}
+  s.summary = %q{A pure Ruby implementation of the SCP client protocol}
+  s.test_files = ["test/test_all.rb"]
+
+  s.add_dependency(%q<net-ssh>, [">= 1.99.1"])
+end
+
+
+# # Original Rakefile source (requires the Echoe gem):
+# 
+# $LOAD_PATH.unshift "../net-ssh/lib"
+# require './lib/net/scp/version'
+# 
+# begin
+#   require 'echoe'
+# rescue LoadError
+#   abort "You'll need to have `echoe' installed to use Net::SCP's Rakefile"
+# end
+# 
+# version = Net::SCP::Version::STRING.dup
+# if ENV['SNAPSHOT'].to_i == 1
+#   version << "." << Time.now.utc.strftime("%Y%m%d%H%M%S")
+# end
+# 
+# Echoe.new('net-scp', version) do |p|
+#   p.project          = "net-ssh"
+#   p.changelog        = "CHANGELOG.rdoc"
+# 
+#   p.author           = "Jamis Buck"
+#   p.email            = "jamis@jamisbuck.org"
+#   p.summary          = "A pure Ruby implementation of the SCP client protocol"
+#   p.url              = "http://net-ssh.rubyforge.org/scp"
+# 
+#   p.dependencies     = ["net-ssh >=1.99.1"]
+# 
+#   p.need_zip         = true
+#   p.include_rakefile = true
+# 
+#   p.rdoc_pattern     = /^(lib|README.rdoc|CHANGELOG.rdoc)/
+# end

data/setup.rb

@@ -0,0 +1,1331 @@
+#
+# setup.rb
+#
+# Copyright (c) 2000-2004 Minero Aoki
+#
+# This program is free software.
+# You can distribute/modify this program under the terms of
+# the GNU Lesser General Public License version 2.1.
+#
+
+#
+# For backward compatibility
+#
+
+unless Enumerable.method_defined?(:map)
+  module Enumerable
+    alias map collect
+  end
+end
+
+unless Enumerable.method_defined?(:detect)
+  module Enumerable
+    alias detect find
+  end
+end
+
+unless Enumerable.method_defined?(:select)
+  module Enumerable
+    alias select find_all
+  end
+end
+
+unless Enumerable.method_defined?(:reject)
+  module Enumerable
+    def reject
+      result = []
+      each do |i|
+        result.push i unless yield(i)
+      end
+      result
+    end
+  end
+end
+
+unless Enumerable.method_defined?(:inject)
+  module Enumerable
+    def inject(result)
+      each do |i|
+        result = yield(result, i)
+      end
+      result
+    end
+  end
+end
+
+unless Enumerable.method_defined?(:any?)
+  module Enumerable
+    def any?
+      each do |i|
+        return true if yield(i)
+      end
+      false
+    end
+  end
+end
+
+unless File.respond_to?(:read)
+  def File.read(fname)
+    open(fname) {|f|
+      return f.read
+    }
+  end
+end
+
+#
+# Application independent utilities
+#
+
+def File.binread(fname)
+  open(fname, 'rb') {|f|
+    return f.read
+  }
+end
+
+# for corrupted windows stat(2)
+def File.dir?(path)
+  File.directory?((path[-1,1] == '/') ? path : path + '/')
+end
+
+#
+# Config
+#
+
+if arg = ARGV.detect{|arg| /\A--rbconfig=/ =~ arg }
+  ARGV.delete(arg)
+  require arg.split(/=/, 2)[1]
+  $".push 'rbconfig.rb'
+else
+  require 'rbconfig'
+end
+
+def multipackage_install?
+  FileTest.directory?(File.dirname($0) + '/packages')
+end
+
+
+class ConfigTable
+
+  c = ::Config::CONFIG
+
+  rubypath = c['bindir'] + '/' + c['ruby_install_name']
+
+  major = c['MAJOR'].to_i
+  minor = c['MINOR'].to_i
+  teeny = c['TEENY'].to_i
+  version = "#{major}.#{minor}"
+
+  # ruby ver. >= 1.4.4?
+  newpath_p = ((major >= 2) or
+               ((major == 1) and
+                ((minor >= 5) or
+                 ((minor == 4) and (teeny >= 4)))))
+  
+  subprefix = lambda {|path|
+    path.sub(/\A#{Regexp.quote(c['prefix'])}/o, '$prefix')
+  }
+
+  if c['rubylibdir']
+    # V < 1.6.3
+    stdruby    = subprefix.call(c['rubylibdir'])
+    siteruby   = subprefix.call(c['sitedir'])
+    versite    = subprefix.call(c['sitelibdir'])
+    sodir      = subprefix.call(c['sitearchdir'])
+  elsif newpath_p
+    # 1.4.4 <= V <= 1.6.3
+    stdruby    = "$prefix/lib/ruby/#{version}"
+    siteruby   = subprefix.call(c['sitedir'])
+    versite    = siteruby + '/' + version
+    sodir      = "$site-ruby/#{c['arch']}"
+  else
+    # V < 1.4.4
+    stdruby    = "$prefix/lib/ruby/#{version}"
+    siteruby   = "$prefix/lib/ruby/#{version}/site_ruby"
+    versite    = siteruby
+    sodir      = "$site-ruby/#{c['arch']}"
+  end
+
+  if arg = c['configure_args'].split.detect {|arg| /--with-make-prog=/ =~ arg }
+    makeprog = arg.sub(/'/, '').split(/=/, 2)[1]
+  else
+    makeprog = 'make'
+  end
+
+  common_descripters = [
+    [ 'prefix',    [ c['prefix'],
+                     'path',
+                     'path prefix of target environment' ] ],
+    [ 'std-ruby',  [ stdruby,
+                     'path',
+                     'the directory for standard ruby libraries' ] ],
+    [ 'site-ruby-common', [ siteruby,
+                     'path',
+                     'the directory for version-independent non-standard ruby libraries' ] ],
+    [ 'site-ruby', [ versite,
+                     'path',
+                     'the directory for non-standard ruby libraries' ] ],
+    [ 'bin-dir',   [ '$prefix/bin',
+                     'path',
+                     'the directory for commands' ] ],
+    [ 'rb-dir',    [ '$site-ruby',
+                     'path',
+                     'the directory for ruby scripts' ] ],
+    [ 'so-dir',    [ sodir,
+                     'path',
+                     'the directory for ruby extentions' ] ],
+    [ 'data-dir',  [ '$prefix/share',
+                     'path',
+                     'the directory for shared data' ] ],
+    [ 'ruby-path', [ rubypath,
+                     'path',
+                     'path to set to #! line' ] ],
+    [ 'ruby-prog', [ rubypath,
+                     'name',
+                     'the ruby program using for installation' ] ],
+    [ 'make-prog', [ makeprog,
+                     'name',
+                     'the make program to compile ruby extentions' ] ],
+    [ 'without-ext', [ 'no',
+                       'yes/no',
+                       'does not compile/install ruby extentions' ] ]
+  ]
+  multipackage_descripters = [
+    [ 'with',      [ '',
+                     'name,name...',
+                     'package names that you want to install',
+                     'ALL' ] ],
+    [ 'without',   [ '',
+                     'name,name...',
+                     'package names that you do not want to install',
+                     'NONE' ] ]
+  ]
+  if multipackage_install?
+    DESCRIPTER = common_descripters + multipackage_descripters
+  else
+    DESCRIPTER = common_descripters
+  end
+
+  SAVE_FILE = 'config.save'
+
+  def ConfigTable.each_name(&block)
+    keys().each(&block)
+  end
+
+  def ConfigTable.keys
+    DESCRIPTER.map {|name, *dummy| name }
+  end
+
+  def ConfigTable.each_definition(&block)
+    DESCRIPTER.each(&block)
+  end
+
+  def ConfigTable.get_entry(name)
+    name, ent = DESCRIPTER.assoc(name)
+    ent
+  end
+
+  def ConfigTable.get_entry!(name)
+    get_entry(name) or raise ArgumentError, "no such config: #{name}"
+  end
+
+  def ConfigTable.add_entry(name, vals)
+    ConfigTable::DESCRIPTER.push [name,vals]
+  end
+
+  def ConfigTable.remove_entry(name)
+    get_entry(name) or raise ArgumentError, "no such config: #{name}"
+    DESCRIPTER.delete_if {|n, arr| n == name }
+  end
+
+  def ConfigTable.config_key?(name)
+    get_entry(name) ? true : false
+  end
+
+  def ConfigTable.bool_config?(name)
+    ent = get_entry(name) or return false
+    ent[1] == 'yes/no'
+  end
+
+  def ConfigTable.value_config?(name)
+    ent = get_entry(name) or return false
+    ent[1] != 'yes/no'
+  end
+
+  def ConfigTable.path_config?(name)
+    ent = get_entry(name) or return false
+    ent[1] == 'path'
+  end
+
+
+  class << self
+    alias newobj new
+  end
+
+  def ConfigTable.new
+    c = newobj()
+    c.initialize_from_table
+    c
+  end
+
+  def ConfigTable.load
+    c = newobj()
+    c.initialize_from_file
+    c
+  end
+
+  def initialize_from_table
+    @table = {}
+    DESCRIPTER.each do |k, (default, vname, desc, default2)|
+      @table[k] = default
+    end
+  end
+
+  def initialize_from_file
+    raise InstallError, "#{File.basename $0} config first"\
+        unless File.file?(SAVE_FILE)
+    @table = {}
+    File.foreach(SAVE_FILE) do |line|
+      k, v = line.split(/=/, 2)
+      @table[k] = v.strip
+    end
+  end
+
+  def save
+    File.open(SAVE_FILE, 'w') {|f|
+      @table.each do |k, v|
+        f.printf "%s=%s\n", k, v if v
+      end
+    }
+  end
+
+  def []=(k, v)
+    raise InstallError, "unknown config option #{k}"\
+        unless ConfigTable.config_key?(k)
+    @table[k] = v
+  end
+    
+  def [](key)
+    return nil unless @table[key]
+    @table[key].gsub(%r<\$([^/]+)>) { self[$1] }
+  end
+
+  def set_raw(key, val)
+    @table[key] = val
+  end
+
+  def get_raw(key)
+    @table[key]
+  end
+
+end
+
+
+module MetaConfigAPI
+
+  def eval_file_ifexist(fname)
+    instance_eval File.read(fname), fname, 1 if File.file?(fname)
+  end
+
+  def config_names
+    ConfigTable.keys
+  end
+
+  def config?(name)
+    ConfigTable.config_key?(name)
+  end
+
+  def bool_config?(name)
+    ConfigTable.bool_config?(name)
+  end
+
+  def value_config?(name)
+    ConfigTable.value_config?(name)
+  end
+
+  def path_config?(name)
+    ConfigTable.path_config?(name)
+  end
+
+  def add_config(name, argname, default, desc)
+    ConfigTable.add_entry name,[default,argname,desc]
+  end
+
+  def add_path_config(name, default, desc)
+    add_config name, 'path', default, desc
+  end
+
+  def add_bool_config(name, default, desc)
+    add_config name, 'yes/no', default ? 'yes' : 'no', desc
+  end
+
+  def set_config_default(name, default)
+    if bool_config?(name)
+      ConfigTable.get_entry!(name)[0] = (default ? 'yes' : 'no')
+    else
+      ConfigTable.get_entry!(name)[0] = default
+    end
+  end
+
+  def remove_config(name)
+    ent = ConfigTable.get_entry(name)
+    ConfigTable.remove_entry name
+    ent
+  end
+
+end
+
+#
+# File Operations
+#
+
+module FileOperations
+
+  def mkdir_p(dirname, prefix = nil)
+    dirname = prefix + dirname if prefix
+    $stderr.puts "mkdir -p #{dirname}" if verbose?
+    return if no_harm?
+
+    # does not check '/'... it's too abnormal case
+    dirs = dirname.split(%r<(?=/)>)
+    if /\A[a-z]:\z/i =~ dirs[0]
+      disk = dirs.shift
+      dirs[0] = disk + dirs[0]
+    end
+    dirs.each_index do |idx|
+      path = dirs[0..idx].join('')
+      Dir.mkdir path unless File.dir?(path)
+    end
+  end
+
+  def rm_f(fname)
+    $stderr.puts "rm -f #{fname}" if verbose?
+    return if no_harm?
+
+    if File.exist?(fname) or File.symlink?(fname)
+      File.chmod 0777, fname
+      File.unlink fname
+    end
+  end
+
+  def rm_rf(dn)
+    $stderr.puts "rm -rf #{dn}" if verbose?
+    return if no_harm?
+
+    Dir.chdir dn
+    Dir.foreach('.') do |fn|
+      next if fn == '.'
+      next if fn == '..'
+      if File.dir?(fn)
+        verbose_off {
+          rm_rf fn
+        }
+      else
+        verbose_off {
+          rm_f fn
+        }
+      end
+    end
+    Dir.chdir '..'
+    Dir.rmdir dn
+  end
+
+  def move_file(src, dest)
+    File.unlink dest if File.exist?(dest)
+    begin
+      File.rename src, dest
+    rescue
+      File.open(dest, 'wb') {|f| f.write File.binread(src) }
+      File.chmod File.stat(src).mode, dest
+      File.unlink src
+    end
+  end
+
+  def install(from, dest, mode, prefix = nil)
+    $stderr.puts "install #{from} #{dest}" if verbose?
+    return if no_harm?
+
+    realdest = prefix + dest if prefix
+    realdest = File.join(realdest, File.basename(from)) if File.dir?(realdest)
+    str = File.binread(from)
+    if diff?(str, realdest)
+      verbose_off {
+        rm_f realdest if File.exist?(realdest)
+      }
+      File.open(realdest, 'wb') {|f|
+        f.write str
+      }
+      File.chmod mode, realdest
+
+      File.open("#{objdir_root()}/InstalledFiles", 'a') {|f|
+        if prefix
+          f.puts realdest.sub(prefix, '')
+        else
+          f.puts realdest
+        end
+      }
+    end
+  end
+
+  def diff?(new_content, path)
+    return true unless File.exist?(path)
+    new_content != File.binread(path)
+  end
+
+  def command(str)
+    $stderr.puts str if verbose?
+    system str or raise RuntimeError, "'system #{str}' failed"
+  end
+
+  def ruby(str)
+    command config('ruby-prog') + ' ' + str
+  end
+  
+  def make(task = '')
+    command config('make-prog') + ' ' + task
+  end
+
+  def extdir?(dir)
+    File.exist?(dir + '/MANIFEST')
+  end
+
+  def all_files_in(dirname)
+    Dir.open(dirname) {|d|
+      return d.select {|ent| File.file?("#{dirname}/#{ent}") }
+    }
+  end
+
+  REJECT_DIRS = %w(
+    CVS SCCS RCS CVS.adm
+  )
+
+  def all_dirs_in(dirname)
+    Dir.open(dirname) {|d|
+      return d.select {|n| File.dir?("#{dirname}/#{n}") } - %w(. ..) - REJECT_DIRS
+    }
+  end
+
+end
+
+#
+# Main Installer
+#
+
+class InstallError < StandardError; end
+
+
+module HookUtils
+
+  def run_hook(name)
+    try_run_hook "#{curr_srcdir()}/#{name}" or
+    try_run_hook "#{curr_srcdir()}/#{name}.rb"
+  end
+
+  def try_run_hook(fname)
+    return false unless File.file?(fname)
+    begin
+      instance_eval File.read(fname), fname, 1
+    rescue
+      raise InstallError, "hook #{fname} failed:\n" + $!.message
+    end
+    true
+  end
+
+end
+
+
+module HookScriptAPI
+
+  def get_config(key)
+    @config[key]
+  end
+
+  alias config get_config
+
+  def set_config(key, val)
+    @config[key] = val
+  end
+
+  #
+  # srcdir/objdir (works only in the package directory)
+  #
+
+  #abstract srcdir_root
+  #abstract objdir_root
+  #abstract relpath
+
+  def curr_srcdir
+    "#{srcdir_root()}/#{relpath()}"
+  end
+
+  def curr_objdir
+    "#{objdir_root()}/#{relpath()}"
+  end
+
+  def srcfile(path)
+    "#{curr_srcdir()}/#{path}"
+  end
+
+  def srcexist?(path)
+    File.exist?(srcfile(path))
+  end
+
+  def srcdirectory?(path)
+    File.dir?(srcfile(path))
+  end
+  
+  def srcfile?(path)
+    File.file? srcfile(path)
+  end
+
+  def srcentries(path = '.')
+    Dir.open("#{curr_srcdir()}/#{path}") {|d|
+      return d.to_a - %w(. ..)
+    }
+  end
+
+  def srcfiles(path = '.')
+    srcentries(path).select {|fname|
+      File.file?(File.join(curr_srcdir(), path, fname))
+    }
+  end
+
+  def srcdirectories(path = '.')
+    srcentries(path).select {|fname|
+      File.dir?(File.join(curr_srcdir(), path, fname))
+    }
+  end
+
+end
+
+
+class ToplevelInstaller
+
+  Version   = '3.2.4'
+  Copyright = 'Copyright (c) 2000-2004 Minero Aoki'
+
+  TASKS = [
+    [ 'config',   'saves your configurations' ],
+    [ 'show',     'shows current configuration' ],
+    [ 'setup',    'compiles ruby extentions and others' ],
+    [ 'install',  'installs files' ],
+    [ 'clean',    "does `make clean' for each extention" ],
+    [ 'distclean',"does `make distclean' for each extention" ]
+  ]
+
+  def ToplevelInstaller.invoke
+    instance().invoke
+  end
+
+  @singleton = nil
+
+  def ToplevelInstaller.instance
+    @singleton ||= new(File.dirname($0))
+    @singleton
+  end
+
+  include MetaConfigAPI
+
+  def initialize(ardir_root)
+    @config = nil
+    @options = { 'verbose' => true }
+    @ardir = File.expand_path(ardir_root)
+  end
+
+  def inspect
+    "#<#{self.class} #{__id__()}>"
+  end
+
+  def invoke
+    run_metaconfigs
+    task = parsearg_global()
+    @config = load_config(task)
+    __send__ "parsearg_#{task}"
+    init_installers
+    __send__ "exec_#{task}"
+  end
+
+  def run_metaconfigs
+    eval_file_ifexist "#{@ardir}/metaconfig"
+  end
+
+  def load_config(task)
+    case task
+    when 'config'
+      ConfigTable.new
+    when 'clean', 'distclean'
+      if File.exist?('config.save')
+      then ConfigTable.load
+      else ConfigTable.new
+      end
+    else
+      ConfigTable.load
+    end
+  end
+
+  def init_installers
+    @installer = Installer.new(@config, @options, @ardir, File.expand_path('.'))
+  end
+
+  #
+  # Hook Script API bases
+  #
+
+  def srcdir_root
+    @ardir
+  end
+
+  def objdir_root
+    '.'
+  end
+
+  def relpath
+    '.'
+  end
+
+  #
+  # Option Parsing
+  #
+
+  def parsearg_global
+    valid_task = /\A(?:#{TASKS.map {|task,desc| task }.join '|'})\z/
+
+    while arg = ARGV.shift
+      case arg
+      when /\A\w+\z/
+        raise InstallError, "invalid task: #{arg}" unless valid_task =~ arg
+        return arg
+
+      when '-q', '--quiet'
+        @options['verbose'] = false
+
+      when       '--verbose'
+        @options['verbose'] = true
+
+      when '-h', '--help'
+        print_usage $stdout
+        exit 0
+
+      when '-v', '--version'
+        puts "#{File.basename($0)} version #{Version}"
+        exit 0
+      
+      when '--copyright'
+        puts Copyright
+        exit 0
+
+      else
+        raise InstallError, "unknown global option '#{arg}'"
+      end
+    end
+
+    raise InstallError, <<EOS
+No task or global option given.
+Typical installation procedure is:
+    $ ruby #{File.basename($0)} config
+    $ ruby #{File.basename($0)} setup
+    # ruby #{File.basename($0)} install  (may require root privilege)
+EOS
+  end
+
+
+  def parsearg_no_options
+    raise InstallError, "#{task}:  unknown options: #{ARGV.join ' '}"\
+        unless ARGV.empty?
+  end
+
+  alias parsearg_show       parsearg_no_options
+  alias parsearg_setup      parsearg_no_options
+  alias parsearg_clean      parsearg_no_options
+  alias parsearg_distclean  parsearg_no_options
+
+  def parsearg_config
+    re = /\A--(#{ConfigTable.keys.join '|'})(?:=(.*))?\z/
+    @options['config-opt'] = []
+
+    while i = ARGV.shift
+      if /\A--?\z/ =~ i
+        @options['config-opt'] = ARGV.dup
+        break
+      end
+      m = re.match(i) or raise InstallError, "config: unknown option #{i}"
+      name, value = m.to_a[1,2]
+      if value
+        if ConfigTable.bool_config?(name)
+          raise InstallError, "config: --#{name} allows only yes/no for argument"\
+              unless /\A(y(es)?|n(o)?|t(rue)?|f(alse))\z/i =~ value
+          value = (/\Ay(es)?|\At(rue)/i =~ value) ? 'yes' : 'no'
+        end
+      else
+        raise InstallError, "config: --#{name} requires argument"\
+            unless ConfigTable.bool_config?(name)
+        value = 'yes'
+      end
+      @config[name] = value
+    end
+  end
+
+  def parsearg_install
+    @options['no-harm'] = false
+    @options['install-prefix'] = ''
+    while a = ARGV.shift
+      case a
+      when /\A--no-harm\z/
+        @options['no-harm'] = true
+      when /\A--prefix=(.*)\z/
+        path = $1
+        path = File.expand_path(path) unless path[0,1] == '/'
+        @options['install-prefix'] = path
+      else
+        raise InstallError, "install: unknown option #{a}"
+      end
+    end
+  end
+
+  def print_usage(out)
+    out.puts 'Typical Installation Procedure:'
+    out.puts "  $ ruby #{File.basename $0} config"
+    out.puts "  $ ruby #{File.basename $0} setup"
+    out.puts "  # ruby #{File.basename $0} install (may require root privilege)"
+    out.puts
+    out.puts 'Detailed Usage:'
+    out.puts "  ruby #{File.basename $0} <global option>"
+    out.puts "  ruby #{File.basename $0} [<global options>] <task> [<task options>]"
+
+    fmt = "  %-20s %s\n"
+    out.puts
+    out.puts 'Global options:'
+    out.printf fmt, '-q,--quiet',   'suppress message outputs'
+    out.printf fmt, '   --verbose', 'output messages verbosely'
+    out.printf fmt, '-h,--help',    'print this message'
+    out.printf fmt, '-v,--version', 'print version and quit'
+    out.printf fmt, '   --copyright',  'print copyright and quit'
+
+    out.puts
+    out.puts 'Tasks:'
+    TASKS.each do |name, desc|
+      out.printf "  %-10s  %s\n", name, desc
+    end
+
+    out.puts
+    out.puts 'Options for config:'
+    ConfigTable.each_definition do |name, (default, arg, desc, default2)|
+      out.printf "  %-20s %s [%s]\n",
+                 '--'+ name + (ConfigTable.bool_config?(name) ? '' : '='+arg),
+                 desc,
+                 default2 || default
+    end
+    out.printf "  %-20s %s [%s]\n",
+        '--rbconfig=path', 'your rbconfig.rb to load', "running ruby's"
+
+    out.puts
+    out.puts 'Options for install:'
+    out.printf "  %-20s %s [%s]\n",
+        '--no-harm', 'only display what to do if given', 'off'
+    out.printf "  %-20s %s [%s]\n",
+        '--prefix',  'install path prefix', '$prefix'
+
+    out.puts
+  end
+
+  #
+  # Task Handlers
+  #
+
+  def exec_config
+    @installer.exec_config
+    @config.save   # must be final
+  end
+
+  def exec_setup
+    @installer.exec_setup
+  end
+
+  def exec_install
+    @installer.exec_install
+  end
+
+  def exec_show
+    ConfigTable.each_name do |k|
+      v = @config.get_raw(k)
+      if not v or v.empty?
+        v = '(not specified)'
+      end
+      printf "%-10s %s\n", k, v
+    end
+  end
+
+  def exec_clean
+    @installer.exec_clean
+  end
+
+  def exec_distclean
+    @installer.exec_distclean
+  end
+
+end
+
+
+class ToplevelInstallerMulti < ToplevelInstaller
+
+  include HookUtils
+  include HookScriptAPI
+  include FileOperations
+
+  def initialize(ardir)
+    super
+    @packages = all_dirs_in("#{@ardir}/packages")
+    raise 'no package exists' if @packages.empty?
+  end
+
+  def run_metaconfigs
+    eval_file_ifexist "#{@ardir}/metaconfig"
+    @packages.each do |name|
+      eval_file_ifexist "#{@ardir}/packages/#{name}/metaconfig"
+    end
+  end
+
+  def init_installers
+    @installers = {}
+    @packages.each do |pack|
+      @installers[pack] = Installer.new(@config, @options,
+                                       "#{@ardir}/packages/#{pack}",
+                                       "packages/#{pack}")
+    end
+
+    with    = extract_selection(config('with'))
+    without = extract_selection(config('without'))
+    @selected = @installers.keys.select {|name|
+                  (with.empty? or with.include?(name)) \
+                      and not without.include?(name)
+                }
+  end
+
+  def extract_selection(list)
+    a = list.split(/,/)
+    a.each do |name|
+      raise InstallError, "no such package: #{name}" \
+              unless @installers.key?(name)
+    end
+    a
+  end
+
+  def print_usage(f)
+    super
+    f.puts 'Inluded packages:'
+    f.puts '  ' + @packages.sort.join(' ')
+    f.puts
+  end
+
+  #
+  # multi-package metaconfig API
+  #
+
+  attr_reader :packages
+
+  def declare_packages(list)
+    raise 'package list is empty' if list.empty?
+    list.each do |name|
+      raise "directory packages/#{name} does not exist"\
+              unless File.dir?("#{@ardir}/packages/#{name}")
+    end
+    @packages = list
+  end
+
+  #
+  # Task Handlers
+  #
+
+  def exec_config
+    run_hook 'pre-config'
+    each_selected_installers {|inst| inst.exec_config }
+    run_hook 'post-config'
+    @config.save   # must be final
+  end
+
+  def exec_setup
+    run_hook 'pre-setup'
+    each_selected_installers {|inst| inst.exec_setup }
+    run_hook 'post-setup'
+  end
+
+  def exec_install
+    run_hook 'pre-install'
+    each_selected_installers {|inst| inst.exec_install }
+    run_hook 'post-install'
+  end
+
+  def exec_clean
+    rm_f 'config.save'
+    run_hook 'pre-clean'
+    each_selected_installers {|inst| inst.exec_clean }
+    run_hook 'post-clean'
+  end
+
+  def exec_distclean
+    rm_f 'config.save'
+    run_hook 'pre-distclean'
+    each_selected_installers {|inst| inst.exec_distclean }
+    run_hook 'post-distclean'
+  end
+
+  #
+  # lib
+  #
+
+  def each_selected_installers
+    Dir.mkdir 'packages' unless File.dir?('packages')
+    @selected.each do |pack|
+      $stderr.puts "Processing the package `#{pack}' ..." if @options['verbose']
+      Dir.mkdir "packages/#{pack}" unless File.dir?("packages/#{pack}")
+      Dir.chdir "packages/#{pack}"
+      yield @installers[pack]
+      Dir.chdir '../..'
+    end
+  end
+
+  def verbose?
+    @options['verbose']
+  end
+
+  def no_harm?
+    @options['no-harm']
+  end
+
+end
+
+
+class Installer
+
+  FILETYPES = %w( bin lib ext data )
+
+  include HookScriptAPI
+  include HookUtils
+  include FileOperations
+
+  def initialize(config, opt, srcroot, objroot)
+    @config = config
+    @options = opt
+    @srcdir = File.expand_path(srcroot)
+    @objdir = File.expand_path(objroot)
+    @currdir = '.'
+  end
+
+  def inspect
+    "#<#{self.class} #{File.basename(@srcdir)}>"
+  end
+
+  #
+  # Hook Script API bases
+  #
+
+  def srcdir_root
+    @srcdir
+  end
+
+  def objdir_root
+    @objdir
+  end
+
+  def relpath
+    @currdir
+  end
+
+  #
+  # configs/options
+  #
+
+  def no_harm?
+    @options['no-harm']
+  end
+
+  def verbose?
+    @options['verbose']
+  end
+
+  def verbose_off
+    begin
+      save, @options['verbose'] = @options['verbose'], false
+      yield
+    ensure
+      @options['verbose'] = save
+    end
+  end
+
+  #
+  # TASK config
+  #
+
+  def exec_config
+    exec_task_traverse 'config'
+  end
+
+  def config_dir_bin(rel)
+  end
+
+  def config_dir_lib(rel)
+  end
+
+  def config_dir_ext(rel)
+    extconf if extdir?(curr_srcdir())
+  end
+
+  def extconf
+    opt = @options['config-opt'].join(' ')
+    command "#{config('ruby-prog')} #{curr_srcdir()}/extconf.rb #{opt}"
+  end
+
+  def config_dir_data(rel)
+  end
+
+  #
+  # TASK setup
+  #
+
+  def exec_setup
+    exec_task_traverse 'setup'
+  end
+
+  def setup_dir_bin(rel)
+    all_files_in(curr_srcdir()).each do |fname|
+      adjust_shebang "#{curr_srcdir()}/#{fname}"
+    end
+  end
+
+  # modify: #!/usr/bin/ruby
+  # modify: #! /usr/bin/ruby
+  # modify: #!ruby
+  # not modify: #!/usr/bin/env ruby
+  SHEBANG_RE = /\A\#!\s*\S*ruby\S*/
+
+  def adjust_shebang(path)
+    return if no_harm?
+
+    tmpfile = File.basename(path) + '.tmp'
+    begin
+      File.open(path, 'rb') {|r|
+        File.open(tmpfile, 'wb') {|w|
+          first = r.gets
+          return unless SHEBANG_RE =~ first
+
+          $stderr.puts "adjusting shebang: #{File.basename path}" if verbose?
+          w.print first.sub(SHEBANG_RE, '#!' + config('ruby-path'))
+          w.write r.read
+        }
+      }
+      move_file tmpfile, File.basename(path)
+    ensure
+      File.unlink tmpfile if File.exist?(tmpfile)
+    end
+  end
+
+  def setup_dir_lib(rel)
+  end
+
+  def setup_dir_ext(rel)
+    make if extdir?(curr_srcdir())
+  end
+
+  def setup_dir_data(rel)
+  end
+
+  #
+  # TASK install
+  #
+
+  def exec_install
+    exec_task_traverse 'install'
+  end
+
+  def install_dir_bin(rel)
+    install_files collect_filenames_auto(), "#{config('bin-dir')}/#{rel}", 0755
+  end
+
+  def install_dir_lib(rel)
+    install_files ruby_scripts(), "#{config('rb-dir')}/#{rel}", 0644
+  end
+
+  def install_dir_ext(rel)
+    return unless extdir?(curr_srcdir())
+    install_files ruby_extentions('.'),
+                  "#{config('so-dir')}/#{File.dirname(rel)}",
+                  0555
+  end
+
+  def install_dir_data(rel)
+    install_files collect_filenames_auto(), "#{config('data-dir')}/#{rel}", 0644
+  end
+
+  def install_files(list, dest, mode)
+    mkdir_p dest, @options['install-prefix']
+    list.each do |fname|
+      install fname, dest, mode, @options['install-prefix']
+    end
+  end
+
+  def ruby_scripts
+    collect_filenames_auto().select {|n| /\.rb\z/ =~ n || "module.yml" == n }
+  end
+  
+  # picked up many entries from cvs-1.11.1/src/ignore.c
+  reject_patterns = %w( 
+    core RCSLOG tags TAGS .make.state
+    .nse_depinfo #* .#* cvslog.* ,* .del-* *.olb
+    *~ *.old *.bak *.BAK *.orig *.rej _$* *$
+
+    *.org *.in .*
+  )
+  mapping = {
+    '.' => '\.',
+    '$' => '\$',
+    '#' => '\#',
+    '*' => '.*'
+  }
+  REJECT_PATTERNS = Regexp.new('\A(?:' +
+                               reject_patterns.map {|pat|
+                                 pat.gsub(/[\.\$\#\*]/) {|ch| mapping[ch] }
+                               }.join('|') +
+                               ')\z')
+
+  def collect_filenames_auto
+    mapdir((existfiles() - hookfiles()).reject {|fname|
+             REJECT_PATTERNS =~ fname
+           })
+  end
+
+  def existfiles
+    all_files_in(curr_srcdir()) | all_files_in('.')
+  end
+
+  def hookfiles
+    %w( pre-%s post-%s pre-%s.rb post-%s.rb ).map {|fmt|
+      %w( config setup install clean ).map {|t| sprintf(fmt, t) }
+    }.flatten
+  end
+
+  def mapdir(filelist)
+    filelist.map {|fname|
+      if File.exist?(fname)   # objdir
+        fname
+      else                    # srcdir
+        File.join(curr_srcdir(), fname)
+      end
+    }
+  end
+
+  def ruby_extentions(dir)
+    _ruby_extentions(dir) or
+        raise InstallError, "no ruby extention exists: 'ruby #{$0} setup' first"
+  end
+
+  DLEXT = /\.#{ ::Config::CONFIG['DLEXT'] }\z/
+
+  def _ruby_extentions(dir)
+    Dir.open(dir) {|d|
+      return d.select {|fname| DLEXT =~ fname }
+    }
+  end
+
+  #
+  # TASK clean
+  #
+
+  def exec_clean
+    exec_task_traverse 'clean'
+    rm_f 'config.save'
+    rm_f 'InstalledFiles'
+  end
+
+  def clean_dir_bin(rel)
+  end
+
+  def clean_dir_lib(rel)
+  end
+
+  def clean_dir_ext(rel)
+    return unless extdir?(curr_srcdir())
+    make 'clean' if File.file?('Makefile')
+  end
+
+  def clean_dir_data(rel)
+  end
+
+  #
+  # TASK distclean
+  #
+
+  def exec_distclean
+    exec_task_traverse 'distclean'
+    rm_f 'config.save'
+    rm_f 'InstalledFiles'
+  end
+
+  def distclean_dir_bin(rel)
+  end
+
+  def distclean_dir_lib(rel)
+  end
+
+  def distclean_dir_ext(rel)
+    return unless extdir?(curr_srcdir())
+    make 'distclean' if File.file?('Makefile')
+  end
+
+  #
+  # lib
+  #
+
+  def exec_task_traverse(task)
+    run_hook "pre-#{task}"
+    FILETYPES.each do |type|
+      if config('without-ext') == 'yes' and type == 'ext'
+        $stderr.puts 'skipping ext/* by user option' if verbose?
+        next
+      end
+      traverse task, type, "#{task}_dir_#{type}"
+    end
+    run_hook "post-#{task}"
+  end
+
+  def traverse(task, rel, mid)
+    dive_into(rel) {
+      run_hook "pre-#{task}"
+      __send__ mid, rel.sub(%r[\A.*?(?:/|\z)], '')
+      all_dirs_in(curr_srcdir()).each do |d|
+        traverse task, "#{rel}/#{d}", mid
+      end
+      run_hook "post-#{task}"
+    }
+  end
+
+  def dive_into(rel)
+    return unless File.dir?("#{@srcdir}/#{rel}")
+
+    dir = File.basename(rel)
+    Dir.mkdir dir unless File.dir?(dir)
+    prevdir = Dir.pwd
+    Dir.chdir dir
+    $stderr.puts '---> ' + rel if verbose?
+    @currdir = rel
+    yield
+    Dir.chdir prevdir
+    $stderr.puts '<--- ' + rel if verbose?
+    @currdir = File.dirname(rel)
+  end
+
+end
+
+
+if $0 == __FILE__
+  begin
+    if multipackage_install?
+      ToplevelInstallerMulti.invoke
+    else
+      ToplevelInstaller.invoke
+    end
+  rescue
+    raise if $DEBUG
+    $stderr.puts $!.message
+    $stderr.puts "Try 'ruby #{$0} --help' for detailed usage."
+    exit 1
+  end
+end