blockenspiel 0.3.3-java → 0.4.0-java

data/Blockenspiel.rdoc

@@ -186,6 +186,10 @@ or a parameterless block, based on whether or not the block actually takes a
 parameter. You can also disable one or the other, to force the use of either
 a parametered or parameterless block.
 
+You can also let the caller use your DSL by passing you a string or a file
+rather than a block. That is, you can create file-based DSLs such as the
+Rails routes file.
+
 You can control wich methods of the class are available from parameterless
 blocks, and/or make some methods available under different names. Here are
 a few examples:
@@ -303,8 +307,7 @@ multiple threads trying to mix methods into the same object concurrently.
 
 === Requirements
 
-* Ruby 1.8.6 or later (1.8.7 recommended), Ruby 1.9.1 or later, or JRuby 1.2
-  or later (1.5 recommended).
+* Ruby 1.8.7, Ruby 1.9.1 or later, or JRuby 1.5 or later.
 
 === Installation
 
@@ -313,9 +316,14 @@ multiple threads trying to mix methods into the same object concurrently.
 === Known issues and limitations
 
 * Implementing wildcard DSL methods using <tt>method_missing</tt> doesn't
-  work. I haven't yet figured out the right semantics for this case.
+  work. I haven't yet decided on the right semantics for this case, or
+  whether it is even a reasonable feature at all.
 * Including Blockenspiel::DSL in a module (rather than a class) is not yet
-  supported, but this is planned in a future release.
+  supported, but this is planned for a future release.
+* Rubinius support is not yet present, but on the to-do list.
+* Installing on Windows may be a challenge because blockenspiel includes a
+  native extension. I'm considering evaluating Luis Lavena's rake-compiler
+  to simplify this process.
 
 === Development and support
 

data/History.rdoc

@@ -1,3 +1,11 @@
+=== 0.4.0 / 2010-06-21
+
+* Implemented string- and file-based DSLs (in addition to block-based).
+* Correctly handle separate active DSLs in different fibers within the
+  same thread, when fibers are avaialble.
+* Updated ruby runtime dependencies to reflect what I'm actually testing.
+* Organized the source a little better, and fixed some Rakefile quirks.
+
 === 0.3.3 / 2010-05-24
 
 * Some Rakefile fixes to match RDoc and Ruby 1.9 changes.

data/README.rdoc

@@ -55,8 +55,7 @@ For an extended analysis of different ways to implement DSL blocks, see
 
 === Requirements
 
-* Ruby 1.8.6 or later (1.8.7 recommended), Ruby 1.9.1 or later, or JRuby 1.2
-  or later (1.5 recommended).
+* Ruby 1.8.7, Ruby 1.9.1 or later, or JRuby 1.5 or later.
 
 === Installation
 
@@ -65,9 +64,14 @@ For an extended analysis of different ways to implement DSL blocks, see
 === Known issues and limitations
 
 * Implementing wildcard DSL methods using <tt>method_missing</tt> doesn't
-  work. I haven't yet figured out the right semantics for this case.
+  work. I haven't yet decided on the right semantics for this case, or
+  whether it is even a reasonable feature at all.
 * Including Blockenspiel::DSL in a module (rather than a class) is not yet
-  supported, but this is planned in a future release.
+  supported, but this is planned for a future release.
+* Rubinius support is not yet present, but on the to-do list.
+* Installing on Windows may be a challenge because blockenspiel includes a
+  native extension. I'm considering evaluating Luis Lavena's rake-compiler
+  to simplify this process.
 
 === Development and support
 
@@ -85,8 +89,8 @@ Blockenspiel is written by Daniel Azuma (http://www.daniel-azuma.com/).
 
 The mixin implementation is based on a concept by the late Why The Lucky
 Stiff, documented in his 6 October 2008 blog posting entitled "Mixing Our
-Way Out Of Instance Eval?". The original link is gone, but you may find
-copies or mirrors out there.
+Way Out Of Instance Eval?". The original link has disappeared along with
+its author, but you may find copies or mirrors out there.
 
 The unmixer code is based on {Mixology}[http://rubyforge.org/projects/mixology],
 version 0.1 by Patrick Farley, anonymous z, Dan Manges, and Clint Bishop.

data/Rakefile

@@ -3,7 +3,7 @@
 # Blockenspiel Rakefile
 # 
 # -----------------------------------------------------------------------------
-# Copyright 2008-2009 Daniel Azuma
+# Copyright 2008-2010 Daniel Azuma
 # 
 # All rights reserved.
 # 
@@ -32,9 +32,9 @@
 # POSSIBILITY OF SUCH DAMAGE.
 # -----------------------------------------------------------------------------
 
+require 'rubygems'
 require 'rake'
 require 'rake/clean'
-require 'rake/gempackagetask'
 require 'rake/testtask'
 require 'rake/rdoctask'
 require 'rdoc'
@@ -45,18 +45,36 @@ require ::File.expand_path("#{::File.dirname(__FILE__)}/lib/blockenspiel/version
 
 
 # Configuration
-extra_rdoc_files_ = ['README.rdoc', 'Blockenspiel.rdoc', 'History.rdoc', 'ImplementingDSLblocks.rdoc']
+EXTRA_RDOC_FILES = ['README.rdoc', 'Blockenspiel.rdoc', 'History.rdoc', 'ImplementingDSLblocks.rdoc']
+
+
+# Environment configuration
+dlext_ = Config::CONFIG['DLEXT']
+if ::RUBY_PLATFORM =~ /java/
+  platform_suffix_ = 'java'
+elsif ::RUBY_COPYRIGHT =~ /Yukihiro\sMatsumoto/i
+  if ::RUBY_VERSION =~ /^1\.8(\..*)?$/
+    platform_suffix_ = 'mri18'
+  elsif ::RUBY_VERSION =~ /^1\.9(\..*)?$/
+    platform_suffix_ = 'mri19'
+  else
+    raise "Unknown version of Matz Ruby Interpreter (#{::RUBY_VERSION})"
+  end
+else
+  raise "Could not identify the ruby runtime"
+end
 
 
 # Default task
-task :default => [:clean, :compile, :rdoc, :package, :test]
+task :default => [:clean, :rdoc, :package, :test]
 
 
 # Clean task
-CLEAN.include(['ext/blockenspiel/Makefile', '**/unmixer.bundle', 'ext/blockenspiel/unmixer.o', '**/blockenspiel_unmixer.jar', 'ext/blockenspiel/BlockenspielUnmixerService.class', 'idslb_markdown.txt', 'doc', 'pkg'])
+CLEAN.include(['ext/blockenspiel/Makefile*', "**/*.#{dlext_}", 'ext/blockenspiel/unmixer.o', '**/blockenspiel_unmixer.jar', 'ext/blockenspiel/BlockenspielUnmixerService.class', 'idslb_markdown.txt', 'doc', 'pkg'])
 
 
 # Test task
+task :test => :build
 ::Rake::TestTask.new('test') do |task_|
   task_.pattern = 'tests/tc_*.rb'
 end
@@ -65,79 +83,98 @@ end
 # RDoc task
 ::Rake::RDocTask.new do |task_|
   task_.main = 'README.rdoc'
-  task_.rdoc_files.include(*extra_rdoc_files_)
+  task_.rdoc_files.include(*EXTRA_RDOC_FILES)
   task_.rdoc_files.include('lib/blockenspiel/*.rb')
   task_.rdoc_dir = 'doc'
   task_.title = "Blockenspiel #{::Blockenspiel::VERSION_STRING} documentation"
-  task_.options << '-f' << 'darkfish'
+  task_.options << '--format=darkfish'
 end
 
 
-# Gem task
-gemspec_ = ::Gem::Specification.new do |s_|
-  s_.name = 'blockenspiel'
-  s_.summary = 'Blockenspiel is a helper library designed to make it easy to implement DSL blocks.'
-  s_.version = ::Blockenspiel::VERSION_STRING.dup
-  s_.author = 'Daniel Azuma'
-  s_.email = 'dazuma@gmail.com'
-  s_.description = 'Blockenspiel is a helper library designed to make it easy to implement DSL blocks. It is designed to be comprehensive and robust, supporting most common usage patterns, and working correctly in the presence of nested blocks and multithreading.'
-  s_.homepage = 'http://virtuoso.rubyforge.org/blockenspiel'
-  s_.rubyforge_project = 'virtuoso'
-  s_.required_ruby_version = '>= 1.8.6'
-  s_.files = ::FileList['ext/**/*.{c,rb,java}', 'lib/**/*.{rb,jar}', 'tests/**/*.rb', '*.rdoc', 'Rakefile'].to_a
-  s_.extra_rdoc_files = extra_rdoc_files_
-  s_.has_rdoc = true
-  s_.test_files = FileList['tests/tc_*.rb']
-  if ::RUBY_PLATFORM =~ /java/
-    s_.platform = 'java'
-    s_.files += ['lib/blockenspiel_unmixer.jar']
-  else
+# Gem package task
+task :package => [:build_java] do
+  mkdir_p('pkg')
+  
+  # Common gemspec
+  def create_gemspec
+    ::Gem::Specification.new do |s_|
+      s_.name = 'blockenspiel'
+      s_.summary = 'Blockenspiel is a helper library designed to make it easy to implement DSL blocks.'
+      s_.version = ::Blockenspiel::VERSION_STRING.dup
+      s_.author = 'Daniel Azuma'
+      s_.email = 'dazuma@gmail.com'
+      s_.description = 'Blockenspiel is a helper library designed to make it easy to implement DSL blocks. It is designed to be comprehensive and robust, supporting most common usage patterns, and working correctly in the presence of nested blocks and multithreading.'
+      s_.homepage = 'http://virtuoso.rubyforge.org/blockenspiel'
+      s_.rubyforge_project = 'virtuoso'
+      s_.required_ruby_version = '>= 1.8.7'
+      s_.files = ::FileList['ext/**/*.{c,rb,java}', 'lib/**/*.{rb,jar}', 'tests/**/*.rb', '*.rdoc', 'Rakefile'].to_a
+      s_.extra_rdoc_files = EXTRA_RDOC_FILES.dup
+      s_.has_rdoc = true
+      s_.test_files = FileList['tests/tc_*.rb']
+      yield s_
+    end
+  end
+  
+  # Normal platform gemspec
+  gemspec_ = create_gemspec do |s_|
     s_.platform = ::Gem::Platform::RUBY
     s_.extensions = ['ext/blockenspiel/extconf.rb']
   end
-end
-task :package => [:compile]
-::Rake::GemPackageTask.new(gemspec_) do |task_|
-  task_.need_zip = false
-  task_.need_tar = ::RUBY_PLATFORM !~ /java/
+  ::Gem::Builder.new(gemspec_).build
+  mv "blockenspiel-#{::Blockenspiel::VERSION_STRING}.gem", 'pkg'
+  
+  # JRuby gemspec
+  gemspec_ = create_gemspec do |s_|
+    s_.platform = 'java'
+    s_.files += ['lib/blockenspiel_unmixer.jar']
+  end
+  ::Gem::Builder.new(gemspec_).build
+  mv "blockenspiel-#{::Blockenspiel::VERSION_STRING}-java.gem", 'pkg'
 end
 
 
 # General build task
-task :compile => ::RUBY_PLATFORM =~ /java/ ? [:compile_java] : [:compile_c]
+task :build => ::RUBY_PLATFORM =~ /java/ ? [:build_java] : [:build_c]
 
 
 # Build tasks for MRI
-dlext_ = Config::CONFIG['DLEXT']
 
-desc 'Builds the extension'
-task :compile_c => ["lib/blockenspiel/unmixer.#{dlext_}"]
+makefile_name_ = "Makefile_#{platform_suffix_}"
+unmixer_general_name_ = "unmixer.#{dlext_}"
+unmixer_name_ = "unmixer_#{platform_suffix_}.#{dlext_}"
 
-file 'ext/blockenspiel/Makefile' => ['ext/blockenspiel/extconf.rb'] do
-  ::Dir.chdir('ext/blockenspiel') do
-    ruby 'extconf.rb'
-  end  
+desc 'Ensures the C extension appropriate to the current platform is present'
+task :build_c => ["ext/blockenspiel/#{unmixer_name_}"] do
+  cp "ext/blockenspiel/#{unmixer_name_}", "lib/blockenspiel/#{unmixer_general_name_}"
 end
 
-file "ext/blockenspiel/unmixer.#{dlext_}" => ['ext/blockenspiel/Makefile', 'ext/blockenspiel/unmixer.c'] do
+file "ext/blockenspiel/#{unmixer_name_}" => ["ext/blockenspiel/#{makefile_name_}"] do
   ::Dir.chdir('ext/blockenspiel') do
+    cp makefile_name_, 'Makefile'
     sh 'make'
+    rm 'unmixer.o'
+    mv unmixer_general_name_, unmixer_name_
   end
 end
 
-file "lib/blockenspiel/unmixer.#{dlext_}" => ["ext/blockenspiel/unmixer.#{dlext_}"] do
-  cp "ext/blockenspiel/unmixer.#{dlext_}", 'lib/blockenspiel'
+file "ext/blockenspiel/#{makefile_name_}" do
+  ::Dir.chdir('ext/blockenspiel') do
+    ruby 'extconf.rb'
+    mv 'Makefile', makefile_name_
+  end  
 end
 
 
 # Build tasks for JRuby
-desc "Compiles the JRuby extension"
-task :compile_java do
+desc 'Builds the JRuby extension'
+task :build_java => ['lib/blockenspiel_unmixer.jar']
+
+file 'lib/blockenspiel_unmixer.jar' do
   ::Dir.chdir('ext/blockenspiel') do
     sh 'javac -source 1.5 -target 1.5 -classpath $JRUBY_HOME/lib/jruby.jar BlockenspielUnmixerService.java'
     sh 'jar cf blockenspiel_unmixer.jar BlockenspielUnmixerService.class'
-    cp 'blockenspiel_unmixer.jar', '../../lib/blockenspiel_unmixer.jar'
   end
+  mv 'ext/blockenspiel/blockenspiel_unmixer.jar', 'lib'
 end
 
 
@@ -151,63 +188,22 @@ end
 
 
 # Publish gem
-task :release_gem_to_rubyforge => [:package] do |t_|
-  v_ = ::ENV["VERSION"]
-  abort "Must supply VERSION=x.y.z" unless v_
-  if v_ != ::Blockenspiel::VERSION_STRING
-    abort "Versions don't match: #{v_} vs #{::Blockenspiel::VERSION_STRING}"
-  end
-  mri_pkg_ = "pkg/blockenspiel-#{v_}.gem"
-  jruby_pkg_ = "pkg/blockenspiel-#{v_}-java.gem"
-  tgz_pkg_ = "pkg/blockenspiel-#{v_}.tgz"
-  if !::File.file?(mri_pkg_) || !::File.readable?(mri_pkg_)
-    abort "You haven't built #{mri_pkg_} yet. Try rake package"
-  end
-  if !::File.file?(jruby_pkg_) || !::File.readable?(jruby_pkg_)
-    abort "You haven't built #{jruby_pkg_} yet. Try jrake package"
-  end
-  if !::File.file?(tgz_pkg_) || !::File.readable?(tgz_pkg_)
-    abort "You haven't built #{tgz_pkg_} yet. Try rake package"
-  end
-  release_notes_ = ::File.read("README.rdoc").split(/^(==.*)/)[2].strip
-  release_changes_ = ::File.read("History.rdoc").split(/^(===.*)/)[1..2].join.strip
-  
-  require 'rubyforge'
-  rf_ = ::RubyForge.new.configure
-  puts "Logging in to RubyForge"
-  rf_.login
-  config_ = rf_.userconfig
-  config_["release_notes"] = release_notes_
-  config_["release_changes"] = release_changes_
-  config_["preformatted"] = true
-  puts "Releasing blockenspiel #{v_} to RubyForge"
-  rf_.add_release('virtuoso', 'blockenspiel', v_, mri_pkg_, jruby_pkg_, tgz_pkg_)
-end
-
-
-# Publish gem
-task :release_gem_to_gemcutter => [:package] do |t_|
+task :release_gem => [:package] do |t_|
   v_ = ::ENV["VERSION"]
   abort "Must supply VERSION=x.y.z" unless v_
   if v_ != ::Blockenspiel::VERSION_STRING
     abort "Versions don't match: #{v_} vs #{::Blockenspiel::VERSION_STRING}"
   end
-  mri_gem_ = "blockenspiel-#{v_}.gem"
-  jruby_gem_ = "blockenspiel-#{v_}-java.gem"
-  if !::File.file?("pkg/#{mri_gem_}") || !::File.readable?("pkg/#{mri_gem_}")
-    abort "You haven't built #{mri_gem_} yet. Try rake package"
-  end
-  if !::File.file?("pkg/#{jruby_gem_}") || !::File.readable?("pkg/#{jruby_gem_}")
-    abort "You haven't built #{jruby_gem_} yet. Try jrake package"
+  puts "Releasing blockenspiel #{v_}"
+  ::Dir.chdir('pkg') do
+    sh "gem push blockenspiel-#{v_}.gem"
+    sh "gem push blockenspiel-#{v_}-java.gem"
   end
-  puts "Releasing blockenspiel #{v_} to GemCutter"
-  `cd pkg && gem push #{mri_gem_}`
-  `cd pkg && gem push #{jruby_gem_}`
 end
 
 
 # Publish everything
-task :release => [:release_gem_to_gemcutter, :release_gem_to_rubyforge, :publish_rdoc_to_rubyforge]
+task :release => [:release_gem, :publish_rdoc_to_rubyforge]
 
 
 # Custom task that takes the implementing dsl blocks paper

data/lib/blockenspiel/builder.rb

@@ -0,0 +1,201 @@
+# -----------------------------------------------------------------------------
+# 
+# Blockenspiel dynamic target construction
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2008-2010 Daniel Azuma
+# 
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the copyright holder, nor the names of any other
+#   contributors to this software, may be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+;
+
+
+module Blockenspiel
+  
+  
+  # === Dynamically construct a target
+  # 
+  # These methods are available in a block passed to Blockenspiel#invoke and
+  # can be used to dynamically define what methods are available from a block.
+  # See Blockenspiel#invoke for more information.
+  
+  class Builder
+    
+    include ::Blockenspiel::DSL
+    
+    
+    # This is a base class for dynamically constructed targets.
+    # The actual target class is an anonymous subclass of this base class.
+    
+    class Target  # :nodoc:
+      
+      include ::Blockenspiel::DSL
+      
+      
+      # Add a method specification to the subclass.
+      
+      def self._add_methodinfo(name_, block_, yields_)
+        (@_blockenspiel_methodinfo ||= {})[name_] = [block_, yields_]
+        module_eval("def #{name_}(*params_, &block_); self.class._invoke_methodinfo(:#{name_}, params_, block_); end\n")
+      end
+      
+      
+      # Attempt to invoke the given method on the subclass.
+      
+      def self._invoke_methodinfo(name_, params_, block_)
+        info_ = @_blockenspiel_methodinfo[name_]
+        case info_[1]
+        when :first
+          params_.unshift(block_)
+        when :last
+          params_.push(block_)
+        end
+        info_[0].call(*params_, &block_)
+      end
+      
+    end
+    
+    
+    # Sets up the dynamic target class.
+    
+    def initialize  # :nodoc:
+      @target_class = ::Class.new(::Blockenspiel::Builder::Target)
+      @target_class.dsl_methods(false)
+    end
+    
+    
+    # Creates a new instance of the dynamic target class
+    
+    def _create_target  # :nodoc:
+      @target_class.new
+    end
+    
+    
+    # === Declare a DSL method.
+    # 
+    # This call creates a method that can be called from the DSL block.
+    # Provide a name for the method, a block defining the method's
+    # implementation, and an optional hash of options.
+    # 
+    # By default, a method of the same name is also made available to
+    # parameterless blocks. To change the name of the parameterless method,
+    # provide its name as the value of the <tt>:dsl_method</tt> option.
+    # To disable this method for parameterless blocks, set the
+    # <tt>:dsl_method</tt> option to +false+.
+    # 
+    # The <tt>:mixin</tt> option is a deprecated alias for
+    # <tt>:dsl_method</tt>.
+    # 
+    # === Warning about the +return+ keyword
+    # 
+    # Because you are implementing your method using a block, remember the
+    # distinction between <tt>Proc.new</tt> and +lambda+. Invoking +return+
+    # from the former does not return from the block, but returns from the
+    # surrounding method scope. Since normal blocks passed to methods are
+    # of the former type, be very careful about using the +return+ keyword:
+    # 
+    #  add_method(:foo) do |param|
+    #    puts "foo called with parameter "+param.inspect
+    #    return "a return value"   # DOESN'T WORK LIKE YOU EXPECT!
+    #  end
+    # 
+    # To return a value from the method you are creating, set the evaluation
+    # value at the end of the block:
+    # 
+    #  add_method(:foo) do |param|
+    #    puts "foo called with parameter "+param.inspect
+    #    "a return value"    # Returns from method foo
+    #  end
+    # 
+    # If you must use the +return+ keyword, create your block as a lambda
+    # as in this example:
+    # 
+    #  code = lambda do |param|
+    #    puts "foo called with parameter "+param.inspect
+    #    return "a return value"   # Returns from method foo
+    #  end
+    #  add_method(:foo, &code)
+    # 
+    # === Accepting a block argument
+    # 
+    # If you want your method to take a block, you have several options
+    # depending on your Ruby version. If you are running the standard Matz
+    # Ruby interpreter (MRI) version 1.8.7 or later (including 1.9.x), or a
+    # compatible interpreter such as JRuby 1.5 or later, you can use the
+    # standard "&" block argument notation to receive the block.
+    # Note that you must call the passed block using the +call+ method since
+    # Ruby doesn't support invoking such a block with +yield+.
+    # For example, to create a method named "foo" that takes one parameter
+    # and a block, do this:
+    # 
+    #  add_method(:foo) do |param, &block|
+    #    puts "foo called with parameter "+param.inspect
+    #    puts "the block returned "+block.call.inspect
+    #  end
+    # 
+    # In your DSL, you can then call:
+    # 
+    #  foo("hello"){ "a value" }
+    # 
+    # If you are using MRI 1.8.6, or another Ruby interpreter that doesn't
+    # fully support this syntax (such as JRuby versions older than 1.5),
+    # Blockenspiel provides an alternative in the form of the <tt>:block</tt>
+    # option. This option causes blocks provided by the caller to be included
+    # in the normal parameter list to your method, instead of as a block
+    # parameter. It can be set to <tt>:first</tt> or <tt>:last</tt> to
+    # prepend or append, respectively, the block (as a +Proc+ object) to
+    # the parameter list. If the caller does not include a block when
+    # calling your DSL method, nil is prepended/appended. For example:
+    # 
+    #  add_method(:foo, :block => :last) do |param, block|
+    #    puts "foo called with parameter "+param.inspect
+    #    if block
+    #      puts "the block returned "+block.call.inspect
+    #    else
+    #      puts "no block passed"
+    #    end
+    #  end
+    # 
+    # The <tt>:receive_block</tt> option is a deprecated alternative.
+    # Setting <tt>:receive_block => true</tt> is currently equivalent to
+    # setting <tt>:block => :last</tt>.
+    
+    def add_method(name_, opts_={}, &block_)
+      receive_block_ = opts_[:receive_block] ? :last : opts_[:block]
+      receive_block_ = :first if receive_block_ && receive_block_ != :last
+      @target_class._add_methodinfo(name_, block_, receive_block_)
+      dsl_method_name_ = opts_[:dsl_method] || opts_[:mixin]
+      if dsl_method_name_ != false
+        dsl_method_name_ = name_ if dsl_method_name_.nil? || dsl_method_name_ == true
+        @target_class.dsl_method(dsl_method_name_, name_)
+      end
+    end
+    
+  end
+  
+  
+end