shared 1.0.0 → 1.1.0

data/README

@@ -2,195 +2,36 @@ NAME
   shared.rb
 
 DESCRIPTION
-  super simple super power sharing of instance and class level code
+  shared.rb provides a super easy way to share code between classes or modules
+  in a simple way.  shared code can be at the class and/or instance level and
+  users deferred evaluation so this is more powerful that the normal ruby
+  module inclusion facilities on which it is based.
 
-INSTALL
-  gem install shared
+SYNOPSIS
+  require 'shared'
 
-URIS
-  http://rubyforge.org/projects/codeforpeople
-  http://codeforpeople.com/lib/ruby/
+  Shared 'methods' do
+    class << self
+      attr :classname
+    end
 
-HISTORY
-  1.0.0
-    - add Share/Shared methods
-    - move from @@vars to closure based impl
+    @classname = name.downcase
 
-  0.4.5
-    - add Shared.for as 'shared' alias to rails' style const missing can
-      trigger lib load for a call. usage:  Shared.for(:name){ ... }
-  
-  0.4.3
-    - added version info
-    - move methods from Object to Kernel and made them private (thx Stefan
-      Rusterholz)
+    def objectname
+      self.class.classname + "(#{ object_id })"
+    end
+  end    
 
-  0.4.2
-    initial version
+  class C
+    include Shared('methods')
+  end
 
-SAMPLES
+  class B
+    include Shared('methods')
+  end
 
-  <========< samples/a.rb >========>
-
-  ~ > cat samples/a.rb
-
-    # shared.rb is a very simple and very powerful method of sharing code between
-    # classes.
-    #
-      require 'shared'
-    
-      shared(:code) do
-        def classname() self.class.name end
-      end
-    
-      class Foo 
-        include shared(:code)
-      end
-    
-      class Bar
-        include shared(:code)
-      end
-    
-      p Foo.new.classname #=> "Foo"
-    
-      p Bar.new.classname #=> "Bar"
-
-  ~ > ruby samples/a.rb
-
-    "Foo"
-    "Bar"
-
-
-  <========< samples/b.rb >========>
-
-  ~ > cat samples/b.rb
-
-    # shared.rb allows natural declaration of both instance and class-level
-    # methods - it's more than simple module inclusion
-    #
-    
-      require 'shared'
-    
-      shared('methods') do
-        def self.class_method() 40 end
-    
-        def instance_method() 2 end
-      end
-    
-      class C
-        include shared('methods')
-      end
-    
-      p(C.class_method + C.new.instance_method) #=> 42
-      
-
-  ~ > ruby samples/b.rb
-
-    42
-
-
-  <========< samples/c.rb >========>
-
-  ~ > cat samples/c.rb
-
-    # shared.rb works equally well with individual objects in addition to the
-    # normal class level usage
-    #
-    
-      require 'shared'
-    
-      shared(:meta_tools) do
-        def singleton_class &block
-          singleton_class =
-            class << self
-              self
-            end
-          block ? singleton_class.module_eval(&block) : singleton_class
-        end
-      end
-    
-      a = %w( a b c )
-    
-      a.extend shared(:meta_tools)
-    
-      a.singleton_class do
-        def to_range() first .. last end
-      end
-    
-      p a.to_range #=> "a".."c"
-
-  ~ > ruby samples/c.rb
-
-    "a".."c"
-
-
-  <========< samples/d.rb >========>
-
-  ~ > cat samples/d.rb
-
-    # an example use-case for shared.rb is sharing code bewteen classes that
-    # require both class level and instance level behaviour to be shared
-    #
-    
-      require 'shared'
-    
-      shared(:acts_as_named) do
-        validates_precence_of :name
-    
-        def to_html() "<blink> #{ name } </blink>" end
-      end
-    
-      class Model
-        def Model.validates_precence_of(*a) end
-    
-        def name() 'zaphod' end
-    
-        include shared(:acts_as_named)
-      end
-    
-      p Model.new.to_html #=> "<blink> zaphod </blink>"
-
-  ~ > ruby samples/d.rb
-
-    "<blink> zaphod </blink>"
-
-
-  <========< samples/e.rb >========>
-
-  ~ > cat samples/e.rb
-
-    # it's important to note that the shared code is injected into the reciever
-    # fresh on each call and, in that way, the effect is rather macro like
-    #
-    
-      require 'shared'
-    
-      share(:instance_tracker) do
-        const_set :Instances, []
-      
-        def self.instances() const_get :Instances end
-    
-        def self.new *a, &b
-          obj = super
-        ensure
-          instances << obj
-        end
-      end
-    
-      class Foo
-        include shared(:instance_tracker)
-      end
-    
-      class Bar 
-        include shared(:instance_tracker)
-      end
-    
-      2.times{ Foo.new }
-      40.times{ Bar.new }
-    
-      p(Foo.instances.size + Bar.instances.size)
-
-  ~ > ruby samples/e.rb
-
-    42
+  p C.classname      #=> 'c'
+  p C.new.objectname #=> 'c(1234)'
 
+  p B.classname      #=> 'b'
+  p B.new.objectname #=> 'b(4567)'

data/Rakefile

@@ -0,0 +1,228 @@
+
+This.rubyforge_project = 'codeforpeople'
+This.author = "Ara T. Howard"
+This.email = "ara.t.howard@gmail.com"
+This.homepage = "http://github.com/ahoward/#{ This.lib }/tree/master"
+
+
+task :default do
+  puts(Rake::Task.tasks.map{|task| task.name} - ['default'])
+end
+
+
+task :gemspec do
+  ignore_extensions = 'git', 'svn', 'tmp', /sw./, 'bak', 'gem'
+  ignore_directories = 'pkg'
+  ignore_files = 'test/log'
+
+  shiteless = 
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+      list.delete_if do |entry|
+        next unless test(?f, entry)
+        filename = File.expand_path(entry)
+        ignore_files.any?{|file| File.expand_path(file) == filename}
+      end
+    end
+
+  lib         = This.lib
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  has_rdoc    = true #File.exist?('doc')
+  test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
+
+  extensions = This.extensions
+  if extensions.nil?
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+
+  template = 
+    if test(?e, 'gemspec.erb')
+      Template{ IO.read('gemspec.erb') }
+    else
+      Template {
+        <<-__
+          ## #{ lib }.gemspec
+          #
+
+          Gem::Specification::new do |spec|
+            spec.name = #{ lib.inspect }
+            spec.version = #{ version.inspect }
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = #{ lib.inspect }
+
+            spec.files = #{ files.inspect }
+            spec.executables = #{ executables.inspect }
+            
+            spec.require_path = "lib"
+
+            spec.has_rdoc = #{ has_rdoc.inspect }
+            spec.test_files = #{ test_files.inspect }
+            #spec.add_dependency 'lib', '>= version'
+            #spec.add_dependency 'fattr'
+
+            spec.extensions.push(*#{ extensions.inspect })
+
+            spec.rubyforge_project = #{ This.rubyforge_project.inspect }
+            spec.author = #{ This.author.inspect }
+            spec.email = #{ This.email.inspect }
+            spec.homepage = #{ This.homepage.inspect }
+          end
+        __
+      }
+    end
+
+  open("#{ lib }.gemspec", "w"){|fd| fd.puts template}
+  This.gemspec = "#{ lib }.gemspec"
+end
+
+task :gem => [:clean, :gemspec] do
+  Fu.mkdir_p This.pkgdir
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  Fu.mv gem, This.pkgdir
+  This.gem = File.basename(gem)
+end
+
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+    cmd = "cat #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    samples << Util.indent(`#{ cmd }`, 4) << "\n"
+
+    cmd = "ruby #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -Ilib #{ sample })'"
+    samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+
+  template = 
+    if test(?e, 'readme.erb')
+      Template{ IO.read('readme.erb') }
+    else
+      Template {
+        <<-__
+          NAME
+            #{ lib }
+
+          DESCRIPTION
+
+          INSTALL
+            gem install #{ lib }
+
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+
+  open("README", "w"){|fd| fd.puts template}
+end
+
+
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| Fu.rm_rf(entry)}
+end
+
+
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.pkgdir }/#{ This.gem }"
+  puts cmd
+  system cmd
+end
+
+
+
+
+
+BEGIN {
+  $VERBOSE = nil
+
+  require 'ostruct'
+  require 'erb'
+  require 'fileutils'
+
+  Fu = FileUtils
+
+  This = OpenStruct.new
+
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+
+  lib = ENV['LIB']
+  unless lib
+    lib = File.basename(Dir.pwd)
+  end
+  This.lib = lib
+
+  version = ENV['VERSION']
+  unless version
+    name = lib.capitalize
+    require "./lib/#{ lib }"
+    version = eval(name).send(:version)
+  end
+  This.version = version
+
+  abort('no lib') unless This.lib
+  abort('no version') unless This.version
+
+  module Util
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+
+    def unindent(s)
+      indent = nil
+      s.each do |line|
+      next if line =~ %r/^\s*$/
+      indent = line[%r/^\s*/] and break
+    end
+    indent ? s.gsub(%r/^#{ indent }/, "") : s
+  end
+    extend self
+  end
+
+  class Template
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+    def expand(b=nil)
+      ERB.new(Util.unindent(@template)).result(b||@block)
+    end
+    alias_method 'to_s', 'expand'
+  end
+  def Template(*args, &block) Template.new(*args, &block) end
+
+  Dir.chdir(This.dir)
+}

data/lib/shared.rb

@@ -1,42 +1,96 @@
+# shared.rb provides a super easy way to share code between classes or modules
+# in a simple way.  shared code can be at the class and/or instance level and
+# users deferred evaluation so this is more powerful that the normal ruby
+# module inclusion facilities on which it is based.
+#
+# basic usage:
+#
+#
+#   require 'shared'
+#   
+#   Shared 'methods' do
+#     class << self
+#       attr :classname
+#     end
+#   
+#     @classname = name.downcase
+#   
+#     def objectname
+#       self.class.classname + "(#{ object_id })"
+#     end
+#   end    
+#   
+#   class C
+#     include Shared('methods')
+#   end
+#   
+#   class B
+#     include Shared('methods')
+#   end
+#   
+#   p C.classname      #=> 'c'
+#   p C.new.objectname #=> 'c(1234)'
+#   
+#   p B.classname      #=> 'b'
+#   p B.new.objectname #=> 'b(4567)'
+#   
+
+
 unless defined?(Shared)
   module Shared
-    Shared::VERSION = '1.0.0' unless defined?(Shared::VERSION)
+    Shared::VERSION = '1.1.0' unless defined?(Shared::VERSION)
     def version() Shared::VERSION end
 
     Code = {}
 
-    def shared name, &block
+    def load key
+      key = key_for(key)
+      unless Code.has_key?(key)
+        ::Kernel.load("shared/#{ key }.rb")
+      end
+    end
+
+    def shared name, options = {}, &block
       key = key_for name
+      via = (options[:via]||options['via']||:eval).to_s.to_sym
 
-      return Code[key] if block.nil?
+      if block.nil?
+        Shared.load(key)
+        return Code[key] 
+      end
 
       m = (Code[key] || Module.new)
 
-      singleton_class(m) do
-        unless m.respond_to?(:blocks)
-          blocks = []
-          define_method(:blocks){ blocks }
+      case via
+        when :eval
+          singleton_class(m) do
+            unless m.respond_to?(:blocks)
+              blocks = []
 
-          define_method(:included) do |other|
-            blocks.each{|b| other.send(:module_eval, &b)}
-          end
+              define_method(:blocks){ blocks }
 
-          define_method(:extend_object) do |other|
-            Shared.singleton_class(other) do
-              m.blocks.each{|b| module_eval &b}
+              define_method(:included) do |other|
+                blocks.each{|b| other.send(:module_eval, &b)}
+              end
+
+              define_method(:extend_object) do |other|
+                Shared.singleton_class(other) do
+                  m.blocks.each{|b| module_eval &b}
+                end
+              end
             end
           end
-        end
-      end
+          m.blocks << block
 
-      m.blocks << block
+        when :module
+          m.send(:module_eval, &block)
+      end
 
       Code[key] ||= m
     end
     
     alias_method 'share', 'shared'
     alias_method 'for', 'shared'
-    alias_method '[]', 'shared'
 
     def key_for name
       name.to_s.strip.downcase
@@ -55,20 +109,20 @@ unless defined?(Shared)
 
   module Kernel
   private
-    def share(*a, &b)
-      Shared.share(*a, &b)
-    end
-
     def Share(*a, &b)
-      Shared.share(*a, &b)
-    end
-
-    def shared(*a, &b)
-      Shared.shared(*a, &b)
+      if a.empty? and b.nil?
+        ::Shared
+      else
+        Shared.share(*a, &b)
+      end
     end
 
     def Shared(*a, &b)
-      Shared.shared(*a, &b)
+      if a.empty? and b.nil?
+        ::Shared
+      else
+        Shared.shared(*a, &b)
+      end
     end
   end
 end

data/readme.erb

@@ -0,0 +1,37 @@
+NAME
+  shared.rb
+
+DESCRIPTION
+  shared.rb provides a super easy way to share code between classes or modules
+  in a simple way.  shared code can be at the class and/or instance level and
+  users deferred evaluation so this is more powerful that the normal ruby
+  module inclusion facilities on which it is based.
+
+SYNOPSIS
+  require 'shared'
+
+  Shared 'methods' do
+    class << self
+      attr :classname
+    end
+
+    @classname = name.downcase
+
+    def objectname
+      self.class.classname + "(#{ object_id })"
+    end
+  end    
+
+  class C
+    include Shared('methods')
+  end
+
+  class B
+    include Shared('methods')
+  end
+
+  p C.classname      #=> 'c'
+  p C.new.objectname #=> 'c(1234)'
+
+  p B.classname      #=> 'b'
+  p B.new.objectname #=> 'b(4567)'

data/shared.gemspec

@@ -0,0 +1,26 @@
+## shared.gemspec
+#
+
+Gem::Specification::new do |spec|
+  spec.name = "shared"
+  spec.version = "1.1.0"
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "shared"
+
+  spec.files = ["lib", "lib/shared.rb", "Rakefile", "README", "readme.erb", "shared.gemspec"]
+  spec.executables = []
+  
+  spec.require_path = "lib"
+
+  spec.has_rdoc = true
+  spec.test_files = nil
+  #spec.add_dependency 'lib', '>= version'
+  #spec.add_dependency 'fattr'
+
+  spec.extensions.push(*[])
+
+  spec.rubyforge_project = "codeforpeople"
+  spec.author = "Ara T. Howard"
+  spec.email = "ara.t.howard@gmail.com"
+  spec.homepage = "http://github.com/ahoward/shared/tree/master"
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: shared
 version: !ruby/object:Gem::Version 
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors: 
 - Ara T. Howard
@@ -9,19 +9,10 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-05 00:00:00 -07:00
+date: 2009-07-28 00:00:00 -06:00
 default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: fattr
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
+dependencies: []
+
 description: 
 email: ara.t.howard@gmail.com
 executables: []
@@ -31,22 +22,14 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- a.rb
-- ann-shared-0.4.2.txt
-- gemspec.rb
-- gen_readme.rb
-- install.rb
 - lib
 - lib/shared.rb
+- Rakefile
 - README
-- samples
-- samples/a.rb
-- samples/b.rb
-- samples/c.rb
-- samples/d.rb
-- samples/e.rb
-has_rdoc: false
-homepage: http://codeforpeople.com/lib/ruby/shared/
+- readme.erb
+- shared.gemspec
+has_rdoc: true
+homepage: http://github.com/ahoward/shared/tree/master
 post_install_message: 
 rdoc_options: []
 

data/a.rb

@@ -1,12 +0,0 @@
-Share :foo do
-  def foo() p :foo end
-end
-include Shared(:foo)
-
-Share :bar do
-  def bar() p :bar end
-end
-include Shared(:bar)
-
-foo
-bar

data/ann-shared-0.4.2.txt

@@ -1,183 +0,0 @@
-NAME
-  shared.rb
-
-DESCRIPTION
-  super simple super power sharing of instance and class level code
-
-INSTALL
-  gem install shared
-
-URIS
-  http://rubyforge.org/projects/codeforpeople
-  http://codeforpeople.com/lib/ruby/
-
-HISTORY
-  0.4.2
-    initial version
-
-SAMPLES
-
-  <========< samples/a.rb >========>
-
-  ~ > cat samples/a.rb
-
-    # shared.rb is a very simple and very powerful method of sharing code between
-    # classes.
-    #
-      require 'shared'
-    
-      shared(:code) do
-        def classname() self.class.name end
-      end
-    
-      class Foo 
-        include shared(:code)
-      end
-    
-      class Bar
-        include shared(:code)
-      end
-    
-      p Foo.new.classname #=> "Foo"
-    
-      p Bar.new.classname #=> "Bar"
-
-  ~ > ruby samples/a.rb
-
-    "Foo"
-    "Bar"
-
-
-  <========< samples/b.rb >========>
-
-  ~ > cat samples/b.rb
-
-    # shared.rb allows natural declaration of both instance and class-level
-    # methods - it's more than simple module inclusion
-    #
-    
-      require 'shared'
-    
-      shared('methods') do
-        def self.class_method() 40 end
-    
-        def instance_method() 2 end
-      end
-    
-      class C
-        include shared('methods')
-      end
-    
-      p(C.class_method + C.new.instance_method) #=> 42
-      
-
-  ~ > ruby samples/b.rb
-
-    42
-
-
-  <========< samples/c.rb >========>
-
-  ~ > cat samples/c.rb
-
-    # shared.rb works equally well with individual objects in addition to the
-    # normal class level usage
-    #
-    
-      require 'shared'
-    
-      shared(:meta_tools) do
-        def singleton_class &block
-          singleton_class =
-            class << self
-              self
-            end
-          block ? singleton_class.module_eval(&block) : singleton_class
-        end
-      end
-    
-      a = %w( a b c )
-    
-      a.extend shared(:meta_tools)
-    
-      a.singleton_class do
-        def to_range() first .. last end
-      end
-    
-      p a.to_range #=> "a".."c"
-
-  ~ > ruby samples/c.rb
-
-    "a".."c"
-
-
-  <========< samples/d.rb >========>
-
-  ~ > cat samples/d.rb
-
-    # an example use-case for shared.rb is sharing code bewteen classes that
-    # require both class level and instance level behaviour to be shared
-    #
-    
-      require 'shared'
-    
-      shared(:acts_as_named) do
-        validates_precence_of :name
-    
-        def to_html() "<blink> #{ name } </blink>" end
-      end
-    
-      class Model
-        def Model.validates_precence_of(*a) end
-    
-        def name() 'zaphod' end
-    
-        include shared(:acts_as_named)
-      end
-    
-      p Model.new.to_html #=> "<blink> zaphod </blink>"
-
-  ~ > ruby samples/d.rb
-
-    "<blink> zaphod </blink>"
-
-
-  <========< samples/e.rb >========>
-
-  ~ > cat samples/e.rb
-
-    # it's important to note that the shared code is injected into the reciever
-    # fresh on each call and, in that way, the effect is rather macro like
-    #
-    
-      require 'shared'
-    
-      share(:instance_tracker) do
-        const_set :Instances, []
-      
-        def self.instances() const_get :Instances end
-    
-        def self.new *a, &b
-          obj = super
-        ensure
-          instances << obj
-        end
-      end
-    
-      class Foo
-        include shared(:instance_tracker)
-      end
-    
-      class Bar 
-        include shared(:instance_tracker)
-      end
-    
-      2.times{ Foo.new }
-      40.times{ Bar.new }
-    
-      p(Foo.instances.size + Bar.instances.size)
-
-  ~ > ruby samples/e.rb
-
-    42
-

data/gemspec.rb

@@ -1,38 +0,0 @@
-#! /usr/bin/env gem build
-
-lib, version = File::basename(File::dirname(File::expand_path(__FILE__))).split %r/-/, 2
-
-require 'rubygems'
-
-Gem::Specification::new do |spec|
-  $VERBOSE = nil
-
-  shiteless = lambda do |list|
-    list.delete_if do |file|
-      file =~ %r/\.svn/ or
-      file =~ %r/\.tmp/
-    end
-  end
-
-  spec.name = lib 
-  spec.version = version 
-  spec.platform = Gem::Platform::RUBY
-  spec.summary = lib 
-
-  spec.files = shiteless[Dir::glob("**/**")]
-  spec.executables = shiteless[Dir::glob("bin/*")].map{|exe| File::basename exe}
-  
-  spec.require_path = "lib" 
-
-  spec.has_rdoc = File::exist? "doc" 
-  spec.test_suite_file = "test/#{ lib }.rb" if File::directory? "test"
-  #spec.add_dependency 'lib', '>= version'
-  spec.add_dependency 'fattr'
-
-  spec.extensions << "extconf.rb" if File::exists? "extconf.rb"
-
-  spec.rubyforge_project = 'codeforpeople'
-  spec.author = "Ara T. Howard"
-  spec.email = "ara.t.howard@gmail.com"
-  spec.homepage = "http://codeforpeople.com/lib/ruby/#{ lib }/"
-end

data/gen_readme.rb

@@ -1,35 +0,0 @@
-#! /usr/bin/env ruby
-
-require 'pathname'
-
-$VERBOSE=nil
-
-def indent s, n = 2
-  ws = ' ' * n
-  s.gsub %r/^/, ws 
-end
-
-template = IO::read 'README.tmpl'
-
-samples = ''
-prompt = '~ > '
-
-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 #{ sample }" 
-  samples << indent(prompt + cmd, 2) << "\n\n" 
-
-  cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -Ilib #{ sample })'" 
-  #cmd = "ruby -Ilib #{ sample }" 
-  samples << indent(`#{ cmd } 2>&1`, 4) << "\n" 
-end
-
-#samples.gsub! %r/^/, '  '
-
-readme  = template.gsub %r/^\s*@samples\s*$/, samples
-print readme 

data/install.rb

@@ -1,214 +0,0 @@
-#!/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 (/\.svn/ =~ File.dirname(f))
-    next if f =~ %r/\.lnk/
-    next if f =~ %r/\.svn/
-    next if f =~ %r/\.swp/
-    next if f =~ %r/\.svn/
-    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
-    -s, --sudo
-    -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 '-s', '--sudo'
-      sudo = 'sudo' 
-    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
-
-system "#{ sudo } #{ $ruby } pre-install.rb" if test(?s, 'pre-install.rb')
-
-unless no_linkify
-  linked = linkify('lib') + linkify('bin')
-end
-
-system "#{ $ruby } extconf.rb && make && #{ sudo } make install" if test(?s, 'extconf.rb')
-
-install_rb(LIBDIR, libdir, LIBDIR_MODE)
-install_rb(BINDIR, bindir, BINDIR_MODE, bin=true)
-
-if linked
-  linked.each{|path| File::rm_f path}
-end
-
-system "#{ sudo } #{ $ruby } post-install.rb" if test(?s, 'post-install.rb')

data/samples/a.rb

@@ -1,20 +0,0 @@
-# shared.rb is a very simple and very powerful method of sharing code between
-# classes.
-#
-  require 'shared'
-
-  shared(:code) do
-    def classname() self.class.name end
-  end
-
-  class Foo 
-    include shared(:code)
-  end
-
-  class Bar
-    include shared(:code)
-  end
-
-  p Foo.new.classname #=> "Foo"
-
-  p Bar.new.classname #=> "Bar"

data/samples/b.rb

@@ -1,18 +0,0 @@
-# shared.rb allows natural declaration of both instance and class-level
-# methods - it's more than simple module inclusion
-#
-
-  require 'shared'
-
-  shared('methods') do
-    def self.class_method() 40 end
-
-    def instance_method() 2 end
-  end
-
-  class C
-    include shared('methods')
-  end
-
-  p(C.class_method + C.new.instance_method) #=> 42
-  

data/samples/c.rb

@@ -1,25 +0,0 @@
-# shared.rb works equally well with individual objects in addition to the
-# normal class level usage
-#
-
-  require 'shared'
-
-  shared(:meta_tools) do
-    def singleton_class &block
-      singleton_class =
-        class << self
-          self
-        end
-      block ? singleton_class.module_eval(&block) : singleton_class
-    end
-  end
-
-  a = %w( a b c )
-
-  a.extend shared(:meta_tools)
-
-  a.singleton_class do
-    def to_range() first .. last end
-  end
-
-  p a.to_range #=> "a".."c"

data/samples/d.rb

@@ -1,21 +0,0 @@
-# an example use-case for shared.rb is sharing code bewteen classes that
-# require both class level and instance level behaviour to be shared
-#
-
-  require 'shared'
-
-  shared(:acts_as_named) do
-    validates_precence_of :name
-
-    def to_html() "<blink> #{ name } </blink>" end
-  end
-
-  class Model
-    def Model.validates_precence_of(*a) end
-
-    def name() 'zaphod' end
-
-    include shared(:acts_as_named)
-  end
-
-  p Model.new.to_html #=> "<blink> zaphod </blink>"

data/samples/e.rb

@@ -1,30 +0,0 @@
-# it's important to note that the shared code is injected into the reciever
-# fresh on each call and, in that way, the effect is rather macro like
-#
-
-  require 'shared'
-
-  share(:instance_tracker) do
-    const_set :Instances, []
-  
-    def self.instances() const_get :Instances end
-
-    def self.new *a, &b
-      obj = super
-    ensure
-      instances << obj
-    end
-  end
-
-  class Foo
-    include shared(:instance_tracker)
-  end
-
-  class Bar 
-    include shared(:instance_tracker)
-  end
-
-  2.times{ Foo.new }
-  40.times{ Bar.new }
-
-  p(Foo.instances.size + Bar.instances.size)