cgen 0.16.0

data/examples/opaque-struct-test.rb

@@ -0,0 +1,36 @@
+require 'cshadow.rb'
+
+class Test
+  include CShadow
+
+  shadow_library_include_file.include "<sys/time.h>"
+
+  define_method :foo do
+    body %{
+      typedef struct Bar {
+        struct Foo *foo;
+      } Bar;
+      typedef struct Foo {
+        int x;
+      } Foo;
+      
+      Bar bar;
+      char s[20], buf[100];
+      
+      bar.foo->x;
+      
+      {int *x = 0; printf("%d", *x);}
+      
+      sscanf("foo bar", "%s", s);
+      while (gets(buf))
+        printf("%s\n", s);
+    }
+  end
+end
+
+Dir.mkdir "tmp" rescue SystemCallError
+Dir.chdir "tmp"
+
+Test.commit
+
+Test.foo

data/examples/sample.rb

@@ -0,0 +1,184 @@
+#!/usr/bin/env ruby
+
+=begin
+
+Sample for CGenerator.
+
+==version
+
+CGenerator 0.14
+
+The current version of this software can be found at 
+((<"http://redshift.sourceforge.net/cgen
+"|URL:http://redshift.sourceforge.net/cgen>)).
+
+==license
+This software is distributed under the Ruby license.
+See ((<"http://www.ruby-lang.org"|URL:http://www.ruby-lang.org>)).
+
+==author
+Joel VanderWerf,
+((<vjoel@users.sourceforge.net|URL:mailto:vjoel@users.sourceforge.net>))
+
+=end
+
+require 'cgen/cgen'
+require 'fileutils'
+
+FileUtils.mkdir_p "tmp"
+
+lib = CGenerator::Library.new "sample_lib"
+
+class Point; end
+
+lib.declare_extern_struct(:point).instance_eval {
+  # make it extern so we can see it from another lib
+  declare :x => "double x"
+  declare :y => "double y"
+}
+
+lib.define_c_global_function(:new_point).instance_eval {
+  arguments "x", "y"        # 'VALUE' is assumed
+  declare :p => "point *p"
+  declare :result => "VALUE result"
+      # semicolons are added automatically
+  body %{
+    result = Data_Make_Struct(#{declare_module Point}, point, 0, free, p);
+    p->x = NUM2DBL(x);
+    p->y = NUM2DBL(y);
+    
+//#  might want to do something like this, too:
+//#  rb_funcall(result, #{lib.declare_symbol :initialize}, 0);
+  }
+  returns "result"
+      # can put a return statement in the body, if preferred
+}
+
+for var in [:x, :y]   # metaprogramming in C!
+  lib.define_c_method(Point, var).instance_eval {
+    declare :p => "point *p"
+    body %{
+      Data_Get_Struct(self, point, p);
+    }
+    returns "rb_float_new(p->#{var})"
+  }
+end
+
+# A utility function, available to other C files
+lib.define_c_function("distance").instance_eval {
+  arguments "point *p1", "point *p2"
+  return_type "double"
+  scope :extern
+  returns "sqrt(pow(p1->x - p2->x, 2) + pow(p1->y - p2->y, 2))"
+  include "<math.h>"
+  # The include accumulator call propagates up the parent
+  # hierarchy until something handles it. In this case,
+  # the Library lib handles it by adding an include
+  # directive to the .c file. This allows related, but
+  # separate aspects of the C source to be handled in
+  # the same place in the Ruby code. We could also have
+  # called include directly on lib.
+}
+
+lib.define_c_method(Point, :distance).instance_eval {
+  # no name conflict between this "distance" and the previous one,
+  # because "method" and "Point" are both part of the C identifier
+  # for this method
+  arguments "other"
+  declare :p => "point *p"
+  declare :q => "point *q"
+  body %{
+    Data_Get_Struct(self, point, p);
+    Data_Get_Struct(other, point, q);
+  }
+  returns "rb_float_new(distance(p, q))"
+}
+  
+lib.commit # now you can use the new definitions
+
+p1 = new_point(1, 2)
+puts "p1: x is #{p1.x}, y is #{p1.y}"
+
+p2 = new_point(5, 8)
+puts "p2: x is #{p2.x}, y is #{p2.y}"
+
+puts "distance from p1 to p2 is #{p1.distance p2}"
+
+# now let's make another lib, and test Library#c_array_args
+
+lib2 = CGenerator::Library.new "sample_lib_2"
+
+lib2.include "../sample_lib/sample_lib.h"
+
+lib2.define_c_method(Point, :closest).instance_eval {
+  # 'farthest Q_1, Q_2, ...'
+  # returns the Q_i which is closest to self
+  
+  c_array_args    # args get passed in argc, argv
+  
+  declare :i        => "int     i",
+          :dist     => "double  dist",
+          :mindist  => "double  mindist",
+          :p        => "point   *p",
+          :q        => "point   *q",
+          :result   => "VALUE   result"
+    
+  body %{
+    result = Qnil;
+    Data_Get_Struct(self, point, p);
+    for (i = 0; i < argc; i++) {
+      Data_Get_Struct(argv[i], point, q);
+      dist = distance(p, q);
+      if (i == 0 || dist < mindist) {
+        mindist = dist;
+        result = argv[i];
+      }
+    }
+  }
+  returns "result"
+}
+
+lib2.define_c_singleton_method(Point, :test).instance_eval {
+  c_array_args {
+    required  :arg0, :arg1
+    optional  :arg2, :arg3, :arg4
+    typecheck :arg2 => Numeric, :arg3 => Numeric
+    default   :arg3 => "INT2NUM(7)",
+              :arg4 => "INT2NUM(NUM2INT(arg2) + NUM2INT(arg3))"
+    rest      :rest
+    block     :block
+  }
+  body %{\
+    rb_funcall(block, #{declare_symbol :call}, 6,
+               arg0, arg1, arg2, arg3, arg4, rest);
+  }
+  # returns nil by default
+}
+
+lib2.commit
+
+puts
+p3 = new_point(-2, 5)
+
+q = new_point(4.1, 4.2)
+puts "q=(#{q.x}, #{q.y})"
+
+r = q.closest(p1, p2, p3)
+
+for p in [p1, p2, p3]
+  puts "point #{p.x}, #{p.y}. Distance to q: #{q.distance(p)}"
+end
+
+puts "closest to q: (#{r.x}, #{r.y})"
+puts
+
+tester = proc { |arg0, arg1, arg2, arg3, arg4, rest|
+  argstrs = [arg0, arg1, arg2, arg3, arg4, rest].map { |arg| arg.inspect }
+  printf "test args are: %s, %s, %s, %s, %s, %s\n", *argstrs
+}
+
+Point.test(0, 1, 2, &tester)  # omit 2 ==> Ruby fails to convert nil to int.
+Point.test(0, 1, 2, 3, &tester)
+Point.test(0, 1, 2, 3, 4, &tester)
+Point.test(0, 1, 2, 3, 4, 5, &tester)
+Point.test(0, 1, 2, 3, 4, 5, 6, &tester)

data/examples/struct.rb

@@ -0,0 +1,103 @@
+require 'cgen/cshadow'
+
+# see also buffer.rb in redshift
+
+class MyStruct
+  include CShadow
+
+  shadow_library_include_file.declare :MyStruct => %{
+    typedef struct {
+      long    len;
+      double  *ptr;
+    } MyStruct;
+  }.tabto(0)
+  
+  # An embedded struct that holds a pointer +ptr+ to an externally stored array
+  # of doubles of length +len+.
+  class MyStructAttribute < CShadow::CNativeAttribute
+    @pattern = /\A(MyStruct)\s+(\w+)\z/
+    def initialize(*args)
+      super
+      lib = owner_class.shadow_library
+      @reader = "result = mystruct_exhale_array(&shadow->#{@cvar})"
+      @writer = "mystruct_inhale_array(&shadow->#{@cvar}, arg)"
+      @dump = %{
+        rb_ary_push(result, mystruct_exhale_array(&shadow->#{@cvar}));
+      }
+      @load = %{
+        mystruct_inhale_array(&shadow->#{@cvar}, rb_ary_shift(from_array));
+      }
+      @free = "free(shadow->#{@cvar}.ptr)"
+    end
+  end
+
+  shadow_attr_accessor :s => "MyStruct s"
+  
+  define_c_function(:mystruct_inhale_array).instance_eval {
+    arguments "MyStruct *mystruct", "VALUE ary"
+    scope :static
+    body %{
+      int  size, i;
+      
+      Check_Type(ary, T_ARRAY);
+
+      size = RARRAY(ary)->len;
+      if (mystruct->ptr) {
+        REALLOC_N(mystruct->ptr, double, size);
+      }
+      else {
+        mystruct->ptr = ALLOC_N(double, size);
+      }
+      mystruct->len = size;
+
+      for (i = 0; i < size; i++) {
+        mystruct->ptr[i] = NUM2DBL(RARRAY(ary)->ptr[i]);
+      }
+    }
+  }
+  
+  define_c_function(:mystruct_exhale_array).instance_eval {
+    arguments "MyStruct *mystruct"
+    return_type "VALUE"
+    returns "ary"
+    declare :size => "int size",
+            :i => "int i",
+            :ary => "VALUE ary"
+    body %{
+      size = mystruct->len;
+      ary = rb_ary_new2(size);
+      RARRAY(ary)->len = size;
+      for (i = 0; i < size; i++) {
+        RARRAY(ary)->ptr[i] = rb_float_new(mystruct->ptr[i]);
+      }
+    }
+  }
+    
+  define_c_method(:initialize) {
+    c_array_args {
+      required :ary
+      typecheck :ary => Array
+    }
+    declare :size => "int size",
+            :i => "int i"
+    body %{
+      mystruct_inhale_array(&shadow->s, ary);
+    }
+  }
+end
+
+require 'ftools'
+dir = File.join("tmp", RUBY_VERSION)
+File.mkpath dir
+Dir.chdir dir
+
+MyStruct.commit
+
+m = MyStruct.new [1,2,3]
+p m.s
+m.s = [4,5,6]
+p Marshal.load(Marshal.dump(m))
+
+CShadow.allow_yaml
+puts m.to_yaml
+p YAML.load(m.to_yaml)

data/examples/test.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+require 'cgen/cgen'
+
+lib = CGenerator::Library.new("test_lib")
+
+lib.instance_eval {
+
+  define_c_global_function(:test).instance_eval {
+    declare :x => "double x"
+    body %{
+      for (x = 1.0; x >= 0.09; x -= 0.1);
+    }
+    returns "rb_float_new(x)"
+  }
+
+}
+
+#Dir.mkdir "tmp" rescue SystemCallError
+Dir.chdir "tmp"
+
+lib.commit
+
+p test

data/examples/yaml.rb

@@ -0,0 +1,56 @@
+require 'cgen/cshadow'
+require 'yaml'
+
+CShadow.allow_yaml
+
+class YamlExample
+  include CShadow
+  shadow_attr_accessor :x => "int x"
+  shadow_attr_accessor :z => "double z"
+  
+  attr_accessor :a, :b
+  
+#  shadow_attr_accessor :myself => YamlExample
+#  attr_accessor :myself2
+  
+  def initialize(x, z, a, b)
+    self.x = x
+    self.z = z
+    @a = a
+    @b = b
+    
+### These both gag the YAML parser.
+#    self.myself = self
+#    @myself2 = self
+  end
+end
+
+Dir.mkdir('tmp') rescue SystemCallError
+Dir.chdir('tmp') do
+  YamlExample.commit
+end
+
+obj = YamlExample.new(1,2.6, :AAA, "BBB")
+p obj
+y obj
+
+obj2 = YAML.load(YAML.dump(obj))
+p obj2
+y obj2
+
+__END__
+
+Output:
+
+#<YamlExample:0x402b91dc x=1, z=2.6, b="BBB", a=:AAA>
+--- !ruby/cshadow:YamlExample 
+x: 1
+z: 2.6
+b: BBB
+a: !ruby/sym AAA
+#<YamlExample:0x402b67fc x=1, z=2.6, b="BBB", a=:AAA>
+--- !ruby/cshadow:YamlExample 
+x: 1
+z: 2.6
+b: BBB
+a: !ruby/sym AAA

data/install.rb

@@ -0,0 +1,1015 @@
+#
+# This file is automatically generated. DO NOT MODIFY!
+#
+# install.rb
+#
+#   Copyright (c) 2000-2002 Minero Aoki <aamine@loveruby.net>
+#
+#   This program is free software.
+#   You can distribute/modify this program under the terms of
+#   the GNU Lesser General Public License version 2.
+#
+
+### begin compat.rb
+
+unless Enumerable.instance_methods.include? 'inject' then
+module Enumerable
+  def inject( result )
+    each do |i|
+      result = yield(result, i)
+    end
+    result
+  end
+end
+end
+
+def File.read_all( fname )
+  File.open(fname, 'rb') {|f| return f.read }
+end
+
+def File.write( fname, str )
+  File.open(fname, 'wb') {|f| f.write str }
+end
+
+### end compat.rb
+### begin config.rb
+
+if i = ARGV.index(/\A--rbconfig=/) then
+  file = $'
+  ARGV.delete_at(i)
+  require file
+else
+  require 'rbconfig'
+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)))))
+  
+  re = Regexp.new('\A' + Regexp.quote(c['prefix']))
+  subprefix = lambda {|path|
+      re === path and path.sub(re, '$prefix')
+  }
+
+  if c['rubylibdir'] then
+    # 1.6.3 < V
+    stdruby    = subprefix.call(c['rubylibdir'])
+    siteruby   = subprefix.call(c['sitedir'])
+    versite    = subprefix.call(c['sitelibdir'])
+    sodir      = subprefix.call(c['sitearchdir'])
+  elsif newpath_p then
+    # 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
+
+  DESCRIPTER = [
+    [ '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', [ 'make',
+                     'name',
+                     'the make program to compile ruby extentions' ] ],
+    [ 'without-ext', [ 'no',
+                       'yes/no',
+                       'does not compile/install ruby extentions' ] ]
+  ]
+
+  SAVE_FILE = 'config.save'
+
+  def ConfigTable.each_name( &block )
+    keys().each( &block )
+  end
+
+  def ConfigTable.keys
+    DESCRIPTER.collect {|k,*dummy| k }
+  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
+
+    def new
+      c = newobj()
+      c.__send__ :init
+      c
+    end
+
+    def load
+      c = newobj()
+      File.file? SAVE_FILE or
+              raise InstallError, "#{File.basename $0} config first"
+      File.foreach( SAVE_FILE ) do |line|
+        k, v = line.split( '=', 2 )
+        c.instance_eval {
+            @table[k] = v.strip
+        }
+      end
+      c
+    end
+  
+  end
+
+  def initialize
+    @table = {}
+  end
+
+  def init
+    DESCRIPTER.each do |k, (default, vname, desc, default2)|
+      @table[k] = default
+    end
+  end
+  private :init
+
+  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 )
+    ConfigTable.config_key? k or raise InstallError, "unknown config option #{k}"
+    if ConfigTable.path_config? k then
+      @table[k] = (v[0,1] != '$') ? File.expand_path(v) : v
+    else
+      @table[k] = v
+    end
+  end
+    
+  def []( key )
+    @table[key] or return nil
+    @table[key].gsub( %r<\$([^/]+)> ) { self[$1] }
+  end
+
+  def set_raw( key, val )
+    @table[key] = val
+  end
+
+  def get_raw( key )
+    @table[key]
+  end
+
+end
+
+
+class MetaConfigEnvironment
+
+  def self.eval_file( file )
+    return unless File.file? file
+    new.instance_eval File.read_all(file), file, 1
+  end
+
+  private
+
+  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 then
+      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
+
+### end config.rb
+### begin fileop.rb
+
+module FileOperations
+
+  def mkdir_p( dname, prefix = nil )
+    dname = prefix + dname if prefix
+    $stderr.puts "mkdir -p #{dname}" if verbose?
+    return if no_harm?
+
+    # does not check '/'... it's too abnormal case
+    dirs = dname.split(%r_(?=/)_)
+    if /\A[a-z]:\z/i === dirs[0] then
+      disk = dirs.shift
+      dirs[0] = disk + dirs[0]
+    end
+    dirs.each_index do |idx|
+      path = dirs[0..idx].join('')
+      Dir.mkdir path unless 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 then
+      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 dir? fn then
+        verbose_off {
+            rm_rf fn
+        }
+      else
+        verbose_off {
+            rm_f fn
+        }
+      end
+    end
+    Dir.chdir '..'
+    Dir.rmdir dn
+  end
+
+  def mv( src, dest )
+    rm_f dest
+    begin
+      File.link src, dest
+    rescue
+      File.write dest, File.read_all(src)
+      File.chmod File.stat(src).mode, dest
+    end
+    rm_f src
+  end
+
+  def install( from, dest, mode, prefix = nil )
+    $stderr.puts "install #{from} #{dest}" if verbose?
+    return if no_harm?
+
+    realdest = prefix + dest if prefix
+    if dir? realdest then
+      realdest += '/' + File.basename(from)
+    end
+    str = File.read_all(from)
+    if diff? str, realdest then
+      verbose_off {
+          rm_f realdest if File.exist? realdest
+      }
+      File.write realdest, str
+      File.chmod mode, realdest
+
+      File.open( objdir + '/InstalledFiles', 'a' ) {|f| f.puts realdest }
+    end
+  end
+
+  def diff?( orig, targ )
+    return true unless File.exist? targ
+    orig != File.read_all(targ)
+  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 dir?( dname )
+    # for corrupted windows stat()
+    File.directory?( (dname[-1,1] == '/') ? dname : dname + '/' )
+  end
+
+  def all_files( dname )
+    Dir.open( dname ) {|d|
+        return d.find_all {|n| File.file? "#{dname}/#{n}" }
+    }
+  end
+
+  def all_dirs( dname )
+    Dir.open( dname ) {|d|
+        return d.find_all {|n| dir? "#{dname}/#{n}" } - %w(. ..)
+    }
+  end
+
+end
+
+### end fileop.rb
+### begin base.rb
+
+class InstallError < StandardError; end
+
+
+class Installer
+
+  Version   = '3.1.2'
+  Copyright = 'Copyright (c) 2000-2002 Minero Aoki'
+
+
+  @toplevel = nil
+
+  def self.declear_toplevel_installer( inst )
+    @toplevel and
+        raise ArgumentError, 'more than one toplevel installer decleared'
+    @toplevel = inst
+  end
+
+  def self.toplevel_installer
+    @toplevel
+  end
+
+
+  FILETYPES = %w( bin lib ext data )
+
+  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
+    "#<#{type} #{__id__}>"
+  end
+
+  #
+  # configs/options
+  #
+
+  def get_config( key )
+    @config[key]
+  end
+
+  alias config get_config
+
+  def set_config( key, val )
+    @config[key] = val
+  end
+
+  def no_harm?
+    @options['no-harm']
+  end
+
+  def verbose?
+    @options['verbose']
+  end
+
+  def verbose_off
+    save, @options['verbose'] = @options['verbose'], false
+    yield
+    @options['verbose'] = save
+  end
+
+  #
+  # srcdir/objdir
+  #
+
+  attr_reader :srcdir
+  alias srcdir_root srcdir
+  alias package_root srcdir
+
+  def curr_srcdir
+    "#{@srcdir}/#{@currdir}"
+  end
+
+  attr_reader :objdir
+  alias objdir_root objdir
+
+  def curr_objdir
+    "#{@objdir}/#{@currdir}"
+  end
+
+  def srcfile( path )
+    curr_srcdir + '/' + path
+  end
+
+  def srcexist?( path )
+    File.exist? srcfile(path)
+  end
+
+  def srcdirectory?( path )
+    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(. ..) - hookfilenames
+    }
+  end
+
+  def srcfiles( path = '.' )
+    srcentries(path).find_all {|fname|
+        File.file? File.join(curr_srcdir, path, fname)
+    }
+  end
+
+  def srcdirectories( path = '.' )
+    srcentries(path).find_all {|fname|
+        dir? File.join(curr_srcdir, path, fname)
+    }
+  end
+
+  def dive_into( rel )
+    return unless dir? "#{@srcdir}/#{rel}"
+
+    dir = File.basename(rel)
+    Dir.mkdir dir unless dir? dir
+    save = Dir.pwd
+    Dir.chdir dir
+    $stderr.puts '---> ' + rel if verbose?
+    @currdir = rel
+    yield
+    Dir.chdir save
+    $stderr.puts '<--- ' + rel if verbose?
+    @currdir = File.dirname(rel)
+  end
+
+  #
+  # 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
+
+  #
+  # setup
+  #
+
+  def exec_setup
+    exec_task_traverse 'setup'
+  end
+
+  def setup_dir_bin( relpath )
+    all_files( curr_srcdir ).each do |fname|
+      add_rubypath "#{curr_srcdir}/#{fname}"
+    end
+  end
+
+  SHEBANG_RE = /\A\#!\s*\S*ruby\S*/
+
+  def add_rubypath( path )
+    $stderr.puts %Q<set #! line to "\#!#{config('ruby-path')}" for #{path} ...> if verbose?
+    return if no_harm?
+
+    tmpfile = File.basename(path) + '.tmp'
+    begin
+      File.open( path ) {|r|
+      File.open( tmpfile, 'w' ) {|w|
+          first = r.gets
+          return unless SHEBANG_RE === first   # reject '/usr/bin/env ruby'
+
+          w.print first.sub( SHEBANG_RE, '#!' + config('ruby-path') )
+          w.write r.read
+      } }
+      mv tmpfile, File.basename(path)
+    ensure
+      rm_f tmpfile if File.exist? tmpfile
+    end
+  end
+
+  def setup_dir_lib( relpath )
+  end
+
+  def setup_dir_ext( relpath )
+    if extdir? curr_srcdir then
+      make
+    end
+  end
+
+  def make
+    command config('make-prog')
+  end
+
+  def setup_dir_data( relpath )
+  end
+
+  #
+  # install
+  #
+
+  def exec_install
+    exec_task_traverse 'install'
+  end
+
+  def install_dir_bin( rel )
+    install_files targfiles, config('bin-dir') + '/' + rel, 0755
+  end
+
+  def install_dir_lib( rel )
+    install_files targfiles, config('rb-dir') + '/' + rel, 0644
+  end
+
+  def install_dir_ext( rel )
+    if extdir? curr_srcdir then
+      install_dir_ext_main File.dirname(rel)
+    end
+  end
+
+  def install_dir_ext_main( rel )
+    install_files allext('.'), config('so-dir') + '/' + rel, 0555
+  end
+
+  def install_dir_data( rel )
+    install_files targfiles, 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 targfiles
+    (targfilenames() - hookfilenames()).collect {|fname|
+        File.exist?(fname) ? fname : File.join(curr_srcdir(), fname)
+    }
+  end
+
+  def targfilenames
+    [ curr_srcdir(), '.' ].inject([]) {|ret, dir|
+        ret | all_files(dir)
+    }
+  end
+
+  def hookfilenames
+    %w( pre-%s post-%s pre-%s.rb post-%s.rb ).collect {|fmt|
+        %w( config setup install clean ).collect {|t| sprintf fmt, t }
+    }.flatten
+  end
+
+  def allext( dir )
+    _allext(dir) or raise InstallError,
+        "no extention exists: Have you done 'ruby #{$0} setup' ?"
+  end
+
+  DLEXT = /\.#{ ::Config::CONFIG['DLEXT'] }\z/
+
+  def _allext( dir )
+    Dir.open( dir ) {|d|
+        return d.find_all {|fname| DLEXT === fname }
+    }
+  end
+
+  #
+  # 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 )
+    clean
+  end
+  
+  def clean
+    command config('make-prog') + ' clean' if File.file? 'Makefile'
+  end
+
+  def clean_dir_data( rel )
+  end
+
+  #
+  # lib
+  #
+
+  def exec_task_traverse( task )
+    run_hook 'pre-' + task
+    FILETYPES.each do |type|
+      if config('without-ext') == 'yes' and type == 'ext' then
+        $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( curr_srcdir ).each do |d|
+          traverse task, rel + '/' + d, mid
+        end
+        run_hook 'post-' + task
+    }
+  end
+
+  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
+
+    env = self.dup
+    begin
+      env.instance_eval File.read_all(fname), fname, 1
+    rescue
+      raise InstallError, "hook #{fname} failed:\n" + $!.message
+    end
+    true
+  end
+
+  def extdir?( dir )
+    File.exist? dir + '/MANIFEST'
+  end
+
+end
+
+### end base.rb
+### begin toplevel.rb
+
+class ToplevelInstaller < Installer
+
+  TASKS = [
+    [ 'config',   'saves your configurations' ],
+    [ 'show',     'shows current configuration' ],
+    [ 'setup',    'compiles extention or else' ],
+    [ 'install',  'installs files' ],
+    [ 'clean',    "does `make clean' for each extention" ]
+  ]
+
+
+  def initialize( root )
+    super nil, {'verbose' => true}, root, '.'
+    Installer.declear_toplevel_installer self
+  end
+
+
+  def execute
+    run_metaconfigs
+
+    case task = parsearg_global()
+    when 'config'
+      @config = ConfigTable.new
+    else
+      @config = ConfigTable.load
+    end
+    parsearg_TASK task
+
+    exectask task
+  end
+
+
+  def run_metaconfigs
+    MetaConfigEnvironment.eval_file "#{srcdir_root}/#{metaconfig}"
+  end
+
+  def metaconfig
+    'metaconfig'
+  end
+
+
+  def exectask( task )
+    if task == 'show' then
+      exec_show
+    else
+      try task
+    end
+  end
+
+  def try( task )
+    $stderr.printf "#{File.basename $0}: entering %s phase...\n", task if verbose?
+    begin
+      __send__ 'exec_' + task
+    rescue
+      $stderr.printf "%s failed\n", task
+      raise
+    end
+    $stderr.printf "#{File.basename $0}: %s done.\n", task if verbose?
+  end
+
+  #
+  # processing arguments
+  #
+
+  def parsearg_global
+    task_re = /\A(?:#{TASKS.collect {|i| i[0] }.join '|'})\z/
+
+    while arg = ARGV.shift do
+      case arg
+      when /\A\w+\z/
+        task_re === arg or raise InstallError, "wrong 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, 'no task or global option given'
+  end
+
+
+  def parsearg_TASK( task )
+    mid = "parsearg_#{task}"
+    if respond_to? mid, true then
+      __send__ mid
+    else
+      ARGV.empty? or
+          raise InstallError, "#{task}:  unknown options: #{ARGV.join ' '}"
+    end
+  end
+
+  def parsearg_config
+    re = /\A--(#{ConfigTable.keys.join '|'})(?:=(.*))?\z/
+    @options['config-opt'] = []
+
+    while i = ARGV.shift do
+      if /\A--?\z/ === i then
+        @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 then
+        if ConfigTable.bool_config?(name) then
+          /\A(y(es)?|n(o)?|t(rue)?|f(alse))\z/i === value or raise InstallError, "config: --#{name} allows only yes/no for argument"
+          value = (/\Ay(es)?|\At(rue)/i === value) ? 'yes' : 'no'
+        end
+      else
+        ConfigTable.bool_config?(name) or raise InstallError, "config: --#{name} requires argument"
+        value = 'yes'
+      end
+      @config[name] = value
+    end
+  end
+
+  def parsearg_install
+    @options['no-harm'] = false
+    @options['install-prefix'] = ''
+    while a = ARGV.shift do
+      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
+    out.puts '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.puts
+  end
+
+  #
+  # config
+  #
+
+  def exec_config
+    super
+    @config.save
+  end
+
+  #
+  # show
+  #
+
+  def exec_show
+    ConfigTable.each_name do |k|
+      v = @config.get_raw(k)
+      if not v or v.empty? then
+        v = '(not specified)'
+      end
+      printf "%-10s %s\n", k, v
+    end
+  end
+
+end
+
+### end toplevel.rb
+
+if $0 == __FILE__ then
+  begin
+    installer = ToplevelInstaller.new( File.dirname($0) )
+    installer.execute
+  rescue
+    raise if $DEBUG
+    $stderr.puts $!.message
+    $stderr.puts "try 'ruby #{$0} --help' for usage"
+    exit 1
+  end
+end