inheritance_module_eval 0.0.1 → 1.0.0

data/.travis.yml

@@ -0,0 +1,7 @@
+rvm:
+  - 1.8.7 # (current default)
+  - 1.9.2
+  - 1.9.3
+  - jruby
+  - ruby-head
+  - ree

data/README.md

@@ -7,6 +7,71 @@ Installation
 ------------
     gem inheritance_module_eval
 
+Usage
+-----
+There are 2 methods:
+
+* instance_module_eval
+* class_module_eval
+
+instance_module_eval method used to eval instance methods (ie: methods of an object)
+
+class_module_eval method used to eval class methods (ie: methods of an class)
+
+
+Below is some simple example of inheritance_module_eval usage:
+
+    require 'inheritance_module_eval'
+
+    # Some dummy class that uses #instance_module_eval
+    class Content
+      self.field(name)
+        instance_module_eval %{
+          def #{name}
+            instance_valiable_get(@#{name})
+          end
+
+          def #{name}=(new_value)
+            instance_valiable_set(@#{name}, new_value)
+          end
+        }
+        end
+      end
+    end
+
+
+    class Article < Content
+      field :title
+      field :content
+      field :etc
+
+      # you can use inheritance!
+      # you dont need to call alias_method anymore!
+      # make it simple
+      def title
+        super.to_s.titelize
+      end
+    end
+
+Requirements
+------------
+none
+
+rspec2 for testing
+
+Compatibility
+-------------
+tested with Ruby
+
+* 1.8.7 # (current default)
+* 1.9.2
+* 1.9.3
+* jruby
+* ruby-head
+* ree
+
+see [build history](http://travis-ci.org/#!/AlexParamonov/inheritance_module_eval/builds)
+
 Copyright
 ---------
 Copyright © 2011 Alexander N Paramonov. See LICENSE for details.

data/Rakefile

@@ -1,2 +1,5 @@
 require "bundler/gem_tasks"
+require 'rspec'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
 task :default => [:spec]

data/inheritance_module_eval.gemspec

@@ -21,5 +21,6 @@ Allows to redefine dynamic method in the same class or in any child class, and c
 
   # specify any dependencies here; for example:
   s.add_development_dependency "rspec", ">= 2.6"
+  s.add_development_dependency "rake"
   # s.add_runtime_dependency "rest-client"
 end

data/lib/inheritance_module_eval/version.rb

@@ -1,3 +1,3 @@
 module InheritanceModuleEval
-  VERSION = "0.0.1"
+  VERSION = "1.0.0"
 end

data/lib/inheritance_module_eval.rb

@@ -1,5 +1,36 @@
 require "inheritance_module_eval/version"
 
+class Module
+  # acts same as module_eval, but saves method hierarchy
+  # should be called only for instance methods evaluation
+  # @params (see Module#module_eval)
+  def instance_module_eval(code = nil, &block)
+    InheritanceModuleEval.instance_eval_on self, code, &block
+  end
+
+  # acts same as module_eval, but saves method hierarchy
+  # should be called only for class methods evaluation
+  # @params (see Module#module_eval)
+  def class_module_eval(code = nil, &block)
+    InheritanceModuleEval.class_eval_on self, code, &block
+  end
+end
+
 module InheritanceModuleEval
-  # Your code goes here...
+  def self.instance_eval_on(sender, code, &block)
+    sender.send :include, (get_module_for code, &block)
+  end
+
+  def self.class_eval_on(sender, code, &block)
+    sender.send :extend, (get_module_for code, &block)
+  end
+
+  private
+  def self.get_module_for(code, &block)
+    raise ArgumentError, "Empty code given" if (code.nil? or code.empty?) and not block_given?
+    include_module = Module.new
+    if code.nil? then include_module.module_eval &block else include_module.module_eval code end
+
+    include_module
+  end
 end

data/spec/inheritance_spec.rb

@@ -0,0 +1,199 @@
+require "inheritance_module_eval"
+
+class Parent
+
+end
+
+class Child < Parent
+
+end
+describe InheritanceModuleEval do
+  describe "integration" do
+    specify "class should respond to instance_module_eval" do
+      Class.new.should respond_to(:instance_module_eval)
+    end
+
+    specify "module should respond to instance_module_eval" do
+      Module.new.should respond_to(:instance_module_eval)
+    end
+
+    specify "class should respond to class_module_eval" do
+      Class.new.should respond_to(:class_module_eval)
+    end
+
+    specify "module should respond to class_module_eval" do
+      Module.new.should respond_to(:class_module_eval)
+    end
+  end
+
+  describe "add dynamic methods" do
+    before(:each) do
+      @test_object = Class.new
+    end
+
+    pending "should delegate to module_eval" do
+      Module.should_receive(:module_eval).twice
+      @test_object.instance_module_eval %{
+        def say_hi
+          puts hi
+        end
+      }
+      @test_object.class_module_eval %{
+        def say_hi
+          puts hi
+        end
+      }
+    end
+
+    describe "instance methods" do
+      it "should eval a string" do
+        @test_object.instance_module_eval %{
+          def say_hi
+            puts 'hi'
+          end
+                                              }
+          @test_object.new.should respond_to :say_hi
+
+      end
+      it "should eval a block" do
+        @test_object.instance_module_eval do
+          def say_hi
+            puts 'hi'
+          end
+        end
+        @test_object.new.should respond_to :say_hi
+      end
+    end
+
+    describe "class_methods" do
+      it "should eval a string" do
+        @test_object.class_module_eval %{
+          def say_hi
+            puts 'hi'
+          end
+                                              }
+          @test_object.should respond_to :say_hi
+
+      end
+      it "should eval a block" do
+        @test_object.class_module_eval do
+          def say_hi
+            puts 'hi'
+          end
+        end
+        @test_object.should respond_to :say_hi
+      end
+    end
+
+
+    describe "collisions" do
+      describe "define already defined method in a class" do
+        describe "redefine it after class declaration" do
+          it "should has lower priority then method, declared in a class" do
+            klass = Class.new
+            klass.class_eval do
+              def say_hi
+                "hi from method" << " " << super
+              end
+              instance_module_eval %{
+                def say_hi
+                  "hi from eval"
+                end
+              }
+            end
+            klass.new.say_hi.should == "hi from method hi from eval"
+          end
+        end
+
+        describe "redefine it before class declaration" do
+          it "should push dynamic method up in the inheritance tree" do
+            klass = Class.new
+            klass.class_eval do
+              instance_module_eval %{
+                def say_hi
+                  "tiny hi"
+                end
+              }
+              def say_hi
+                super.upcase
+              end
+            end
+            klass.new.say_hi.should == "TINY HI"
+          end
+        end
+
+        describe "redefine as much as you want" do
+          it "should push dynamic method up in the inheritance tree" do
+            klass = Class.new
+            klass.class_eval do
+              instance_module_eval %{
+                def say_hi
+                  [5]
+                end
+              }
+              instance_module_eval %{
+                def say_hi
+                  [4] + super
+                end
+              }
+              instance_module_eval %{
+                def say_hi
+                  [3] + super
+                end
+              }
+              instance_module_eval %{
+                def say_hi
+                  [2] + super
+                end
+              }
+              def say_hi
+                [1] + super
+              end
+            end
+            klass.new.say_hi.should == [1, 2, 3, 4, 5]
+          end
+        end
+
+        describe "redefine it inside a module" do
+          it "should push dynamic method before module and after class declaration" do
+            test_module = Module.new
+            test_module.module_eval do
+              def say_hi
+                ["hi from module"]
+              end
+            end
+
+            klass = Class.new
+            klass.class_eval do
+              include test_module
+              instance_module_eval do
+                def say_hi
+                  ["hi from eval"] + super
+                end
+              end
+
+              def say_hi
+                ["hi from method"] + super
+              end
+            end
+            klass.new.say_hi.should == ["hi from method", "hi from eval", "hi from module"]
+          end
+        end
+      end
+    end
+
+
+    describe "#get_module_for" do
+      it "should return Module" do
+        InheritanceModuleEval.send :get_module_for, "puts('hi')"
+      end
+
+      it "should raise ArgumentError if no code given" do
+        ["", nil, []].each do |empty|
+          expect{InheritanceModuleEval.send :get_module_for, empty}.to raise_error ArgumentError
+        end
+      end
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inheritance_module_eval
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2011-11-12 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &22648120 !ruby/object:Gem::Requirement
+  requirement: &10342840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,18 @@ dependencies:
         version: '2.6'
   type: :development
   prerelease: false
-  version_requirements: *22648120
+  version_requirements: *10342840
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &10342420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *10342420
 description: ! 'saves inheritance structure of dynamically created methods.
 
   Allows to redefine dynamic method in the same class or in any child class, and call
@@ -34,6 +45,7 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - .rspec
+- .travis.yml
 - Gemfile
 - HISTORY.md
 - LICENSE
@@ -42,6 +54,7 @@ files:
 - inheritance_module_eval.gemspec
 - lib/inheritance_module_eval.rb
 - lib/inheritance_module_eval/version.rb
+- spec/inheritance_spec.rb
 homepage: http://github.com/AlexParamonov/inheritance_module_eval
 licenses: []
 post_install_message: 
@@ -67,3 +80,4 @@ signing_key:
 specification_version: 3
 summary: inheritance safe module_eval.
 test_files: []
+has_rdoc: