missingno 0.0.0

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2009 Tobias Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,26 @@
+= Missingno - automated method_missing generator
+
+Automated <tt>method_missing</tt> and <tt>respond_to?</tt> generator.
+
+== Features
+
+* Add convenience methods for your classes defined by a regular expression, or by any other construct that responds to <tt>===</tt> or <tt>include?</tt>
+* Create both <tt>method_missing</tt> and <tt>respond_to?</tt> methods without repeating yourself
+* Add convenience methods even when extending classes that already have <tt>method_missing</tt> defined.
+* Add convenience methods to Mixins
+
+== Example
+
+  require 'missingno'
+    
+  class Model
+    def find(field, value)
+      #do stuff
+    end
+    def_when /^find_by_(.+)$/, :find
+    #i.e. find_by_state 'VIC'
+
+    def_when ['update', 'refresh', 'load'] do
+      #do stuff
+    end
+  end

data/Rakefile

@@ -0,0 +1,17 @@
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "missingno"
+    s.summary = "automated method_missing generator"
+    s.email = "me@tobiascohen.com"
+    s.homepage = "http://github.com/tobico/missingno"
+    s.description = "Automated method_missing and respond_to? generator"
+    s.authors = ["Tobias Cohen"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/lib/missingno.rb

@@ -0,0 +1,81 @@
+class Module
+  
+  # Define a method_missing handler that matches given object.
+  #
+  # Specify either a block to call, or a second argument containing
+  # a symbol with the name of method to call.
+  #
+  # If the match object is a regular expression that contains sub-matches,
+  # these matches will be passed to the callback before any passed arguments.
+  #
+  # Blocks passed to this method may not themselves take a block argument
+  # or yield to a block.
+  
+  def def_when object, *args, &method
+    missingno_init
+    @missingno_chain << [object, !method.nil? ? method : args[0]]
+  end
+  
+private
+  
+  # Get the specified method as an UnboundMethod object, or nil if none
+  # exists
+  
+  def missingno_get_old_method method_name
+    if method_defined? method_name
+      instance_method method_name
+    else
+      nil
+    end
+  end
+  
+  # Initialize the missingno chain and override method_missing and respond_to?
+  # methods for class.
+
+  def missingno_init
+    return if defined? @missingno_chain
+    
+    chain = @missingno_chain = []
+    is_a_class = is_a? Class
+
+    old_method_missing = missingno_get_old_method :method_missing
+    define_method :method_missing do |sym, *args, &block|
+      item = chain.find do |item|
+        if item[0].respond_to? :include?
+          item[0].include? sym.to_s
+        else
+          item[0] === sym.to_s
+        end
+      end
+      if item
+        a = if item[0].is_a? Regexp
+          $~.to_a.slice(1..-1) + args
+        else
+          args
+        end
+        if item[1].is_a? Symbol
+          if m = method(item[1])
+            m.call *a, &block
+          end
+        else
+          instance_exec *a, &item[1]
+        end
+      elsif old_method_missing
+        old_method_missing.bind(self).call(sym, *args, &block)
+      elsif is_a_class
+        super
+      end
+    end
+    
+    old_respond_to = missingno_get_old_method :respond_to?
+    define_method :respond_to? do |sym, *args|
+      if chain.any? { |item| item[0] === sym.to_s }
+        true
+      elsif old_respond_to
+        old_respond_to.bind(self).call(sym, *args)
+      elsif is_a_class
+        super
+      end
+    end
+  end
+end

data/spec/missingno_spec.rb

@@ -0,0 +1,119 @@
+require 'missingno'
+require 'spec'
+
+#Single class using missingno
+class SingleClass
+  def_when /^(foo|bar)$/, :test
+  def_when ['one', 'two', 'three'] do
+    @ok = true
+  end
+  attr_accessor :ok
+end
+
+#Subclass of class using missingno
+class SubClass < SingleClass
+  def_when /^zap$/, :sub_test
+end
+
+#Class with method_missing defined
+class MMClass
+  def method_missing *args
+    "mmclass method_missing"
+  end
+  
+  def_when 'foo', :missingno
+end
+
+#Subclass of class with method_missing defined
+class MMSubClass < MMClass
+  def_when /^zap$/, :sub_test
+end
+
+#Mixin module using missingno
+module MixinMM
+  def_when 'zap', :mm_zap
+end
+
+#Class using missingno with mixin
+class MixedChain
+  include MixinMM
+  def_when 'foo', :mm_foo
+end
+
+describe 'missingno' do
+  describe 'with a single class' do
+    subject { SingleClass.new }
+    
+    it 'should respond to symbols matching given regexp' do
+      should respond_to(:foo)
+      should respond_to(:bar)
+      should_not respond_to(:zap)
+    end
+    
+    it 'should call nominated method when I call a matching (missing) method' do
+      subject.should_receive(:test)
+      subject.foo
+    end
+    
+    it 'should receive the submatch as an argument to #test' do
+      subject.should_receive(:test).with('foo')
+      subject.foo
+    end
+    
+    it 'should run specified block when matching array element given' do
+      subject.ok = false
+      subject.one
+      subject.ok.should == true
+      subject.ok = false
+      subject.three
+      subject.ok.should == true
+    end
+  end
+  
+  describe 'with a subclass of a class also using missingno' do
+    subject { SubClass.new }
+    
+    it 'should respond to matches from superclass' do
+      should respond_to(:foo)
+      should respond_to(:bar)
+    end
+    
+    it 'should respond to matches from subclass' do
+      should respond_to(:zap)
+    end
+    
+    it 'should call the correct methods when a match found' do
+      subject.should_receive :test
+      subject.foo
+      subject.should_receive :sub_test
+      subject.zap
+    end
+  end
+  
+  describe 'with a class that already has method_missing' do
+    subject { MMClass.new }
+    
+    it 'should call missingno method when I call a matching method' do
+      subject.should_receive :missingno
+      subject.foo
+    end
+    
+    it 'should call original method_missing when I call a non-matching method' do
+      subject.zap.should == "mmclass method_missing"
+    end
+  end
+  
+  describe 'through a mixin' do
+    subject { MixedChain.new }
+    
+    it 'should call method matched in class' do
+      subject.should_receive :mm_foo
+      subject.foo
+    end
+    
+    it 'should call method matched in mixin' do
+      subject.should_receive :mm_zap
+      subject.zap
+    end
+  end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification 
+name: missingno
+version: !ruby/object:Gem::Version 
+  version: 0.0.0
+platform: ruby
+authors: 
+- Tobias Cohen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-10 00:00:00 +11:00
+default_executable: 
+dependencies: []
+
+description: Automated method_missing and respond_to? generator
+email: me@tobiascohen.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/missingno.rb
+- spec/missingno_spec.rb
+has_rdoc: true
+homepage: http://github.com/tobico/missingno
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: automated method_missing generator
+test_files: 
+- spec/missingno_spec.rb