autorequire 0.0.0

data/README

@@ -0,0 +1,337 @@
+URLS
+
+  http://codeforpeople.com/lib/ruby/autorequire/
+  http://rubyforge.org/frs/?group_id=1024
+
+ABOUT
+
+  autorequire is sleeker, more aerodynamic, greasier version of autoload.
+
+  like autoload it's primary usage is to speed up the load time of large
+  libraries which, themselves, do many requires.
+
+INSTALL
+
+  gem install autorequire
+
+VERSION
+
+  0.0.0
+
+HISTORY
+
+  0.0.0 :
+
+    initial release
+
+AUTHOR
+
+  ara [dot] t [dot] howard [at] noaa [dot] gov
+
+SAMPLES
+
+  <========< emsg.rb >========>
+
+  ~ > cat emsg.rb 
+    #
+    # rescues err and prints msg - support method for samples/*
+    #
+    def emsg
+      yield
+    rescue Exception => e
+      puts "#{ e } (#{ e.class })!"
+    end
+
+  <========< libgen.rb >========>
+
+  ~ > cat libgen.rb 
+    #
+    # generates a temporaray ruby lib - support method for samples/*
+    #
+    require 'fileutils'
+    def libgen path, libdir = './.lib/'
+      f, fu = File, FileUtils
+      dirname, basename = f.split path
+      dirname = f.join libdir, dirname
+      fu.mkdir_p dirname
+      path = f.join dirname, basename
+      open(path,'w'){|fd| fd << yield}
+      at_exit{ Dir.glob(f.join(libdir, '*')){|e| fu.rm_rf e} }
+      path
+    end
+
+
+  <========< sample/a.rb >========>
+
+  ~ > cat sample/a.rb
+
+    #
+    # simple use is much like autoload
+    #
+    emsg{ p Queue }
+    
+    autorequire 'Queue', 'thread'
+    
+    emsg{ p Queue }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/a.rb
+
+    Queue (NameError)!
+    Queue
+
+
+  <========< sample/b.rb >========>
+
+  ~ > cat sample/b.rb
+
+    #
+    # but we can also specify nested classes.  note the alternative hash syntax.
+    # a list of const => lib pairs may also be given.
+    #
+    emsg{ p CGI::Session }
+    
+    autorequire 'CGI::Session' => 'cgi/session'
+    
+    emsg{ p CGI::Session }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/b.rb
+
+    CGI (NameError)!
+    CGI::Session
+
+
+  <========< sample/c.rb >========>
+
+  ~ > cat sample/c.rb
+
+    #
+    # like autoload, calling autorequire on a class defines the lib to be loaded
+    # when the const_missing hook for __that__ class is called
+    #
+    class C
+      lib = libgen('a.rb'){ 'class C::A; end' }
+    
+      emsg{ p A }
+    
+      autorequire 'A' => lib 
+    
+      emsg{ p A }
+    end
+    
+    emsg{ p A}
+    emsg{ p C::A}
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/c.rb
+
+    A (NameError)!
+    C::A
+    A (NameError)!
+    C::A
+
+
+  <========< sample/d.rb >========>
+
+  ~ > cat sample/d.rb
+
+    #
+    # however, we can scope the constant to the top-level, even from within
+    # another class
+    #
+    emsg{ p A }
+    
+    class C
+      lib = libgen('a.rb'){ 'class ::A; end' }
+      autorequire '::A' => lib 
+      emsg{ p A }
+      emsg{ p ::A }
+    end
+    
+    emsg{ p A }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/d.rb
+
+    A (NameError)!
+    A (NameError)!
+    A
+    A
+
+
+  <========< sample/e.rb >========>
+
+  ~ > cat sample/e.rb
+
+    #
+    # this is a nice way to setup bulk autoloads in a large library 
+    #
+    emsg{ p Net::Ftp }
+    emsg{ p CGI::Session }
+    
+    module M
+      autorequire '::Net::FTP' => 'net/ftp', '::CGI::Session' => 'cgi/session'
+    end
+    
+    emsg{ p Net::FTP }
+    emsg{ p CGI::Session }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/e.rb
+
+    Net (NameError)!
+    CGI (NameError)!
+    Net::FTP
+    CGI::Session
+
+
+  <========< sample/f.rb >========>
+
+  ~ > cat sample/f.rb
+
+    #
+    # you may have notice autorequire works for nested constants.  it does this be
+    # dynamically setting up proxy modules to resolve a name.  once the names have
+    # actually been resolved the proxy is dropped.
+    #
+    emsg{ p Net }
+    emsg{ p CGI }
+    
+    autorequire '::Net::FTP' => 'net/ftp', '::CGI::Session' => 'cgi/session'
+    
+    emsg{ p Net }
+    emsg{ p CGI }
+    
+    emsg{ p Net::FTP }
+    emsg{ p CGI::Session }
+    
+    emsg{ p Net }
+    emsg{ p CGI }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/f.rb
+
+    Net (NameError)!
+    CGI (NameError)!
+    "ConstProxy(Net)"
+    "ConstProxy(CGI)"
+    Net::FTP
+    CGI::Session
+    Net
+    CGI
+
+
+  <========< sample/g.rb >========>
+
+  ~ > cat sample/g.rb
+
+    #
+    # this actually works for arbitrarily deep const nestings
+    #
+    lib =
+      libgen('a/b/c/d.rb'){
+        '
+        module A
+          module B
+            module C
+              class D
+              end
+            end
+          end
+        end
+        '
+      }
+    
+    autorequire 'A::B::C::D' => lib
+    
+    p A
+    p A::B
+    p A::B::C
+    p A::B::C::D
+    p A::B::C
+    p A::B
+    p A
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/g.rb
+
+    "ConstProxy(A)"
+    "ConstProxy(B)"
+    "ConstProxy(C)"
+    A::B::C::D
+    A::B::C
+    A::B
+    A
+
+
+  <========< sample/h.rb >========>
+
+  ~ > cat sample/h.rb
+
+    #
+    # if you don't specify which lib to load it's name is guessed using a rather
+    # naive approach.  
+    #
+    emsg{ p PStore }
+    emsg{ p CGI::Session }
+    emsg{ p FileUtils }
+    
+    autorequire 'PStore'       # requires 'pstore'
+    autorequire 'CGI::Session' # requires 'cgi/session'
+    autorequire '::FileUtils'  # requires 'fileutils'
+    
+    emsg{ p PStore }
+    emsg{ p CGI::Session }
+    emsg{ p FileUtils }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/h.rb
+
+    PStore (NameError)!
+    CGI (NameError)!
+    FileUtils
+    PStore
+    CGI::Session
+    FileUtils
+
+
+  <========< sample/i.rb >========>
+
+  ~ > cat sample/i.rb
+
+    #
+    # if you're feeling risque you can set Autorequire.everything = true to use
+    # this default loading for __any__ const missing.
+    #
+    Autorequire.everything = 42 
+    
+    emsg{ p PStore }
+    emsg{ p CGI::Session }
+    emsg{ p FileUtils }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/i.rb
+
+    PStore
+    CGI::Session
+    FileUtils
+
+
+  <========< sample/j.rb >========>
+
+  ~ > cat sample/j.rb
+
+    #
+    # you do, at least, get a meaningful error if the const to lib translation
+    # fails
+    #
+    autorequire 'FuBar' => 'does-not-exist.rb'
+    
+    emsg{ p FuBar }
+
+  ~ > ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb sample/j.rb
+
+    resolving <FuBar> by loading <does-not-exist.rb> failed (Autorequire::NameError)!
+
+
+CAVEATS
+
+  this library is experimental.  nonetheless it's relatively straight forward
+  and i have no plans to change it's interface - though i may add to it in
+  future release.
+
+LICENSE
+
+  same as ruby's

data/README.tmpl

@@ -0,0 +1,73 @@
+URLS
+
+  http://codeforpeople.com/lib/ruby/autorequire/
+  http://rubyforge.org/frs/?group_id=1024
+
+ABOUT
+
+  autorequire is sleeker, more aerodynamic, greasier version of autoload.
+
+  like autoload it's primary usage is to speed up the load time of large
+  libraries which, themselves, do many requires.
+
+INSTALL
+
+  gem install autorequire
+
+VERSION
+
+  0.0.0
+
+HISTORY
+
+  0.0.0 :
+
+    initial release
+
+AUTHOR
+
+  ara [dot] t [dot] howard [at] noaa [dot] gov
+
+SAMPLES
+
+  <========< emsg.rb >========>
+
+  ~ > cat emsg.rb 
+    #
+    # rescues err and prints msg - support method for samples/*
+    #
+    def emsg
+      yield
+    rescue Exception => e
+      puts "#{ e } (#{ e.class })!"
+    end
+
+  <========< libgen.rb >========>
+
+  ~ > cat libgen.rb 
+    #
+    # generates a temporaray ruby lib - support method for samples/*
+    #
+    require 'fileutils'
+    def libgen path, libdir = './.lib/'
+      f, fu = File, FileUtils
+      dirname, basename = f.split path
+      dirname = f.join libdir, dirname
+      fu.mkdir_p dirname
+      path = f.join dirname, basename
+      open(path,'w'){|fd| fd << yield}
+      at_exit{ Dir.glob(f.join(libdir, '*')){|e| fu.rm_rf e} }
+      path
+    end
+
+  @samples
+
+CAVEATS
+
+  this library is experimental.  nonetheless it's relatively straight forward
+  and i have no plans to change it's interface - though i may add to it in
+  future release.
+
+LICENSE
+
+  same as ruby's

data/emsg.rb

@@ -0,0 +1,5 @@
+def emsg
+  yield
+rescue Exception => e
+  puts "#{ $! } (#{ $!.class })!"
+end

data/gemspec.rb

@@ -0,0 +1,23 @@
+lib, version = File::basename(File::dirname(File::expand_path(__FILE__))).split %r/-/, 2
+
+require 'rubygems'
+
+Gem::Specification::new do |spec|
+  spec.name = lib 
+  spec.version = version 
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = lib 
+
+  # spec.files = Dir[ File::join("{lib,bin}", "*") ]
+  # spec.require_path = "lib" 
+
+  spec.files = Dir::glob "**/**"
+  spec.executables = Dir::glob("bin/*").map{|exe| File::basename exe}
+
+  spec.has_rdoc = File::exist? "doc" 
+  spec.test_suite_file = "test/#{ lib }.rb" if File::directory? "test"
+
+  spec.author = "Ara T. Howard"
+  spec.email = "ara.t.howard@noaa.gov"
+  spec.homepage = "http://codeforpeople.com/lib/ruby/#{ lib }/"
+end

data/gen_readme.rb

@@ -0,0 +1,32 @@
+$VERBOSE=nil
+def indent s, n = 2
+  ws = ' ' * n
+  s.gsub %r/^/, ws 
+end
+
+template = IO::read 'README.tmpl'
+
+samples = ''
+prompt = '~ > '
+
+libs = Dir['lib/*'].map{|lib| " -r #{ lib } "}.join
+
+Dir['sample/*'].sort.each do |sample|
+  samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+  cmd = "cat #{ sample }" 
+  samples << indent(prompt + cmd, 2) << "\n\n" 
+  samples << indent(`#{ cmd }`, 4) << "\n" 
+
+  cmd = "ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb #{ sample }" 
+  samples << indent(prompt + cmd, 2) << "\n\n" 
+
+  #cmd = "ruby -r ./emsg.rb -I ./lib #{ libs } #{ sample }" 
+  cmd = "ruby -r ./emsg.rb -r ./libgen.rb -r ./lib/autorequire.rb #{ sample }" 
+  samples << indent(`#{ cmd } 2>&1`, 4) << "\n" 
+end
+
+#samples.gsub! %r/^/, '  '
+
+readme  = template.gsub %r/^[\ ]*@samples\s*$/, samples
+print readme 

data/install.rb

@@ -0,0 +1,201 @@
+#!/usr/bin/env ruby
+require 'rbconfig'
+require 'find'
+require 'ftools'
+require 'tempfile'
+include Config
+
+LIBDIR      = "lib"
+LIBDIR_MODE = 0644
+
+BINDIR      = "bin"
+BINDIR_MODE = 0755
+
+
+$srcdir            = CONFIG["srcdir"]
+$version           = CONFIG["MAJOR"]+"."+CONFIG["MINOR"]
+$libdir            = File.join(CONFIG["libdir"], "ruby", $version)
+$archdir           = File.join($libdir, CONFIG["arch"])
+$site_libdir       = $:.find {|x| x =~ /site_ruby$/}
+$bindir            = CONFIG["bindir"] || CONFIG['BINDIR']
+$ruby_install_name = CONFIG['ruby_install_name'] || CONFIG['RUBY_INSTALL_NAME'] || 'ruby'
+$ruby_ext          = CONFIG['EXEEXT'] || ''
+$ruby              = File.join($bindir, ($ruby_install_name + $ruby_ext))
+
+if !$site_libdir
+  $site_libdir = File.join($libdir, "site_ruby")
+elsif $site_libdir !~ %r/#{Regexp.quote($version)}/
+  $site_libdir = File.join($site_libdir, $version)
+end
+
+def install_rb(srcdir=nil, destdir=nil, mode=nil, bin=nil)
+#{{{
+  path   = []
+  dir    = []
+  Find.find(srcdir) do |f|
+    next unless FileTest.file?(f)
+    next if (f = f[srcdir.length+1..-1]) == nil
+    next if (/CVS$/ =~ File.dirname(f))
+    next if f =~ %r/\.lnk/
+    path.push f
+    dir |= [File.dirname(f)]
+  end
+  for f in dir
+    next if f == "."
+    next if f == "CVS"
+    File::makedirs(File.join(destdir, f))
+  end
+  for f in path
+    next if (/\~$/ =~ f)
+    next if (/^\./ =~ File.basename(f))
+    unless bin
+      File::install(File.join(srcdir, f), File.join(destdir, f), mode, true)
+    else
+      from = File.join(srcdir, f)
+      to = File.join(destdir, f)
+      shebangify(from) do |sf|
+        $deferr.print from, " -> ", File::catname(from, to), "\n"
+        $deferr.printf "chmod %04o %s\n", mode, to 
+        File::install(sf, to, mode, false)
+      end
+    end
+  end
+#}}}
+end
+def shebangify f
+#{{{
+  open(f) do |fd|
+    buf = fd.read 42 
+    if buf =~ %r/^\s*#\s*!.*ruby/o
+      ftmp = Tempfile::new("#{ $$ }_#{ File::basename(f) }")
+      begin
+        fd.rewind
+        ftmp.puts "#!#{ $ruby  }"
+        while((buf = fd.read(8192)))
+          ftmp.write buf
+        end
+        ftmp.close
+        yield ftmp.path
+      ensure
+        ftmp.close!
+      end
+    else
+      yield f
+    end
+  end
+#}}}
+end
+def ARGV.switch
+#{{{
+  return nil if self.empty?
+  arg = self.shift
+  return nil if arg == '--'
+  if arg =~ /^-(.)(.*)/
+    return arg if $1 == '-'
+    raise 'unknown switch "-"' if $2.index('-')
+    self.unshift "-#{$2}" if $2.size > 0
+    "-#{$1}"
+  else
+    self.unshift arg
+    nil
+  end
+#}}}
+end
+def ARGV.req_arg
+#{{{
+  self.shift || raise('missing argument')
+#}}}
+end
+def linkify d, linked = []
+#--{{{
+  if test ?d, d
+    versioned = Dir[ File::join(d, "*-[0-9].[0-9].[0-9].rb") ]
+    versioned.each do |v| 
+      src, dst = v, v.gsub(%r/\-[\d\.]+\.rb$/, '.rb')
+      lnk = nil
+      begin
+        if test ?l, dst
+          lnk = "#{ dst }.lnk"
+          puts "#{ dst } -> #{ lnk }"
+          File::rename dst, lnk
+        end
+        unless test ?e, dst
+          puts "#{ src } -> #{ dst }"
+          File::copy src, dst 
+          linked << dst
+        end
+      ensure
+        if lnk
+          at_exit do
+            puts "#{ lnk } -> #{ dst }"
+            File::rename lnk, dst
+          end
+        end
+      end
+    end
+  end
+  linked
+#--}}}
+end
+
+
+#
+# main program
+#
+
+libdir = $site_libdir
+bindir = $bindir
+no_linkify = false
+linked = nil
+help = false
+
+usage = <<-usage
+  #{ File::basename $0 }
+    -d, --destdir    <destdir>
+    -l, --libdir     <libdir>
+    -b, --bindir     <bindir>
+    -r, --ruby       <ruby>
+    -n, --no_linkify
+    -h, --help
+usage
+
+begin
+  while switch = ARGV.switch
+    case switch
+    when '-d', '--destdir'
+      libdir = ARGV.req_arg
+    when '-l', '--libdir'
+      libdir = ARGV.req_arg
+    when '-b', '--bindir'
+      bindir = ARGV.req_arg
+    when '-r', '--ruby'
+      $ruby = ARGV.req_arg
+    when '-n', '--no_linkify'
+      no_linkify = true
+    when '-h', '--help'
+      help = true
+    else
+      raise "unknown switch #{switch.dump}"
+    end
+  end
+rescue
+  STDERR.puts $!.to_s
+  STDERR.puts usage
+  exit 1
+end    
+
+if help
+  STDOUT.puts usage
+  exit
+end
+
+unless no_linkify
+  linked = linkify('lib') + linkify('bin')
+end
+
+install_rb(LIBDIR, libdir, LIBDIR_MODE)
+install_rb(BINDIR, bindir, BINDIR_MODE, bin=true)
+
+if linked
+  linked.each{|path| File::rm_f path}
+end

data/lib/autorequire.rb

@@ -0,0 +1,152 @@
+module Autorequire
+  class NameError < ::NameError; end
+  class LoadError < ::LoadError; end
+  class << self
+    attr_accessor "everything"
+    alias_method "everything?", "everything"
+  end
+end
+
+class Module
+  alias_method "const_missing!", "const_missing"
+  def const_missing c
+    c = c.to_s
+
+    if autorequire.has_key? c
+      value = autorequire[c]
+      if ConstProxy?(value)
+        return value
+      else
+        value.flatten.each do |lib| 
+          begin
+            require lib
+          rescue LoadError
+            #raise NameError, "resolving <#{ c }> by loading <#{ lib }> failed"
+            raise Autorequire::NameError, "resolving <#{ c }> by loading <#{ lib }> failed"
+          end
+        end
+      end
+    elsif Autorequire.everything?
+      lib4 = lambda{|k| k.to_s.sub(%r/^::/,'').downcase.gsub(%r/::/, File::SEPARATOR)}
+      lib = Object == self ? lib4[c] : lib4["#{ name }::#{ c }"]
+      begin
+        require lib
+      rescue LoadError
+        raise Autorequire::NameError, "resolving <#{ c }> by loading <#{ lib }> failed"
+      end
+    else
+      #const_missing! c
+      raise NameError, c
+    end
+
+    #begin
+      if ConstProxy?(self)
+        raise NameError, c unless to_const.const_defined? c
+        to_const.const_get c
+      else
+        raise NameError, c unless const_defined? c
+        const_get c
+      end
+    #rescue NameError => ne
+      ##const_missing! c
+      #raise NameError, c
+    #end
+  end
+  def autorequire c = nil, *libs
+    if c
+      lib4 = lambda{|k| k.to_s.sub(%r/^::/,'').downcase.gsub(%r/::/, File::SEPARATOR)}
+      h = Hash === c ? c : {c => libs}
+      h.each do |c,libs| 
+        libs << lib4[c] if libs.empty?
+        m = self 
+        if c =~ %r/::/
+          if c =~ %r/^::/
+            c = c.gsub %r/^::/, ''
+            ::Object.autorequire(c, *libs)
+            next
+          end
+          list = c.split %r/::/
+          c = list.pop
+          while((name = list.shift))
+            cp = ConstProxy(name,m)
+            m.autorequire[name] = cp
+            m = cp 
+          end
+        end
+        m.autorequire[c.to_s] = [libs].flatten 
+      end
+      self
+    else
+      @autorequire ||= {}
+    end
+  end
+  def Autorequire(*a, &b) autorequire(*a, &b) end
+end
+
+module ConstProxy
+  def self.new name, parent
+    name = name.to_s
+    Module.new do
+      include ConstProxy
+      singleton_class = class << self; self; end
+      singleton_class.module_eval do
+        define_method('name'){ name }
+        define_method('parent'){ parent }
+        define_method('to_s'){ "ConstProxy(#{ name })" }
+        define_method('inspect'){ "\"#{ to_s }\"" }
+        define_method('to_const'){ 
+          if ConstProxy?(parent)
+            parent.to_const.const_get name # recurse
+          else
+            parent.const_get name
+          end
+        }
+      end
+    end
+  end
+  module ::Kernel
+    def ConstProxy(*a, &b) ConstProxy.new(*a, &b) end
+    def ConstProxy?(other) other.is_a?(Module) and other.ancestors.include?(ConstProxy) end
+  end
+end
+
+class Object
+  def autorequire(*a, &b) self.class.autorequire(*a, &b) end
+  def Autorequire(*a, &b) self.class.autorequire(*a, &b) end
+end
+
+
+
+if $0 == __FILE__
+  autorequire 'Net::FTP' => %w( net/ftp net/http )
+  p Net
+  p Net::FTP
+  p Net
+
+
+  autorequire 'A::B::C::D' => 'a/b/c/d'
+  p A
+  p A::B
+  p A::B::C
+  p A::B::C::D
+  p A::B::C
+  p A::B
+  p A
+
+  autorequire 'Net::FTP'
+  p Net
+  p Net::FTP
+  p Net
+
+  autorequire 'CGI::Session'
+  p CGI
+  p CGI::Session
+  p CGI
+
+  autorequire 'PStore'
+  p PStore
+
+  Autorequire.everything = true
+  p CGI::Session
+  p CGI
+end

data/libgen.rb

@@ -0,0 +1,12 @@
+require 'fileutils'
+
+def libgen path, libdir = './.lib/'
+  f, fu = File, FileUtils
+  dirname, basename = f.split path
+  dirname = f.join libdir, dirname
+  fu.mkdir_p dirname
+  path = f.join dirname, basename
+  open(path,'w'){|fd| fd << yield}
+  at_exit{ Dir.glob(f.join(libdir, '*')){|e| fu.rm_rf e} }
+  path
+end

data/sample/a.rb

@@ -0,0 +1,8 @@
+#
+# simple use is much like autoload
+#
+emsg{ p Queue }
+
+autorequire 'Queue', 'thread'
+
+emsg{ p Queue }

data/sample/b.rb

@@ -0,0 +1,9 @@
+#
+# but we can also specify nested classes.  note the alternative hash syntax.
+# a list of const => lib pairs may also be given.
+#
+emsg{ p CGI::Session }
+
+autorequire 'CGI::Session' => 'cgi/session'
+
+emsg{ p CGI::Session }

data/sample/c.rb

@@ -0,0 +1,16 @@
+#
+# like autoload, calling autorequire on a class defines the lib to be loaded
+# when the const_missing hook for __that__ class is called
+#
+class C
+  lib = libgen('a.rb'){ 'class C::A; end' }
+
+  emsg{ p A }
+
+  autorequire 'A' => lib 
+
+  emsg{ p A }
+end
+
+emsg{ p A}
+emsg{ p C::A}

data/sample/d.rb

@@ -0,0 +1,14 @@
+#
+# however, we can scope the constant to the top-level, even from within
+# another class
+#
+emsg{ p A }
+
+class C
+  lib = libgen('a.rb'){ 'class ::A; end' }
+  autorequire '::A' => lib 
+  emsg{ p A }
+  emsg{ p ::A }
+end
+
+emsg{ p A }

data/sample/e.rb

@@ -0,0 +1,12 @@
+#
+# this is a nice way to setup bulk autoloads in a large library 
+#
+emsg{ p Net::Ftp }
+emsg{ p CGI::Session }
+
+module M
+  autorequire '::Net::FTP' => 'net/ftp', '::CGI::Session' => 'cgi/session'
+end
+
+emsg{ p Net::FTP }
+emsg{ p CGI::Session }

data/sample/f.rb

@@ -0,0 +1,18 @@
+#
+# you may have notice autorequire works for nested constants.  it does this be
+# dynamically setting up proxy modules to resolve a name.  once the names have
+# actually been resolved the proxy is dropped.
+#
+emsg{ p Net }
+emsg{ p CGI }
+
+autorequire '::Net::FTP' => 'net/ftp', '::CGI::Session' => 'cgi/session'
+
+emsg{ p Net }
+emsg{ p CGI }
+
+emsg{ p Net::FTP }
+emsg{ p CGI::Session }
+
+emsg{ p Net }
+emsg{ p CGI }

data/sample/g.rb

@@ -0,0 +1,26 @@
+#
+# this actually works for arbitrarily deep const nestings
+#
+lib =
+  libgen('a/b/c/d.rb'){
+    '
+    module A
+      module B
+        module C
+          class D
+          end
+        end
+      end
+    end
+    '
+  }
+
+autorequire 'A::B::C::D' => lib
+
+p A
+p A::B
+p A::B::C
+p A::B::C::D
+p A::B::C
+p A::B
+p A

data/sample/h.rb

@@ -0,0 +1,15 @@
+#
+# if you don't specify which lib to load it's name is guessed using a rather
+# naive approach.  
+#
+emsg{ p PStore }
+emsg{ p CGI::Session }
+emsg{ p FileUtils }
+
+autorequire 'PStore'       # requires 'pstore'
+autorequire 'CGI::Session' # requires 'cgi/session'
+autorequire '::FileUtils'  # requires 'fileutils'
+
+emsg{ p PStore }
+emsg{ p CGI::Session }
+emsg{ p FileUtils }

data/sample/i.rb

@@ -0,0 +1,9 @@
+#
+# if you're feeling risque you can set Autorequire.everything = true to use
+# this default loading for __any__ const missing.
+#
+Autorequire.everything = 42 
+
+emsg{ p PStore }
+emsg{ p CGI::Session }
+emsg{ p FileUtils }

data/sample/j.rb

@@ -0,0 +1,7 @@
+#
+# you do, at least, get a meaningful error if the const to lib translation
+# fails
+#
+autorequire 'FuBar' => 'does-not-exist.rb'
+
+emsg{ p FuBar }

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: autorequire
+version: !ruby/object:Gem::Version 
+  version: 0.0.0
+date: 2006-04-11 00:00:00.000000 -06:00
+summary: autorequire
+require_paths: 
+  - lib
+email: ara.t.howard@noaa.gov
+homepage: http://codeforpeople.com/lib/ruby/autorequire/
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+  - Ara T. Howard
+files: 
+  - lib
+  - install.rb
+  - gemspec.rb
+  - autorequire-0.0.0.gem
+  - README.tmpl
+  - gen_readme.rb
+  - sample
+  - README
+  - emsg.rb
+  - libgen.rb
+  - lib/autorequire.rb
+  - sample/a.rb
+  - sample/f.rb
+  - sample/b.rb
+  - sample/e.rb
+  - sample/c.rb
+  - sample/d.rb
+  - sample/i.rb
+  - sample/j.rb
+  - sample/h.rb
+  - sample/g.rb
+test_files: []
+rdoc_options: []
+extra_rdoc_files: []
+executables: []
+extensions: []
+requirements: []
+dependencies: []