penetrator 0.1.6 → 0.1.8

data/README.md

@@ -1,10 +1,10 @@
 # Penetrator
 
-This gem aimed to help with reuse code in ruby projects.
-Highly inspired from http://github.com/makandra/modularity gem but slightly modified for supporting
+This gem aimed to help improving code reuse in ruby projects.
+Highly inspired by http://github.com/makandra/modularity gem but slightly modified for supporting
 conventional *super* inheritance methods chaining.
-Also much of code was shamelessly borrowed from `ActiveSupport::Concern` and I should say thanks that Ruby Hackers, who wrote it.
-All what left to do for me - it's just take the best from both worlds.
+Also much of code was shamelessly borrowed from `ActiveSupport::Concern` so I should say thanks that Ruby Hackers, who wrote it.
+All that what left to do for me - just to take the best from both worlds.
 
 ## Installation
 
@@ -16,7 +16,7 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
+Or install it yourself:
 
     $ gem install penetrator
 
@@ -70,6 +70,7 @@ File: *app/controllers/traits/crudable_trait.rb*
             @_resources ||= resource_class.order(default_order).all
           end
        end
+
 ```
 
 File: *app/controllers/accomodations_controller.rb*
@@ -136,13 +137,13 @@ File:  *app/models/my_model.rb*
 ```ruby
 
     class Victim
-      behaves_like :CanHaveArgs, 'arg1', 'arg2'
+      behaves_like :CanHaveArgs, 'first', 'second'
     end
 
     obj = Victim.new
 
-    obj.arg1  # => 'arg1-chunked!'
-    obj.arg2  # => 'arg2-chunked!'
+    obj.first   # => first-chunked!
+    obj.second  # => second-chunked!
 
 ```
 
@@ -154,7 +155,7 @@ Also you can freely utilize `ClassMethods` internal module as you usually do wit
       extend Penetrator::Concern
       module ClassMethods
         def class_method
-          ... add what you want ...
+          # ... add what you want ...
         end
       end
 
@@ -164,7 +165,7 @@ Also you can freely utilize `ClassMethods` internal module as you usually do wit
 
 ```
 
-You can ever extend arbitrary instance of any class with your trait:
+You can even extend arbitrary instance of any class with your trait:
 
 ```ruby
 
@@ -172,15 +173,39 @@ You can ever extend arbitrary instance of any class with your trait:
       extend Penetrator::Concern
 
       def cleanup
-        ....
+        # ...
       end
     end
 
-    string_of_dirty_html = "Something <span>dirty</span> and even <marquee>fearing ugly</marquee>
+    string_of_dirty_html = "Something <span>dirty</span> and even <marquee>fearing ugly</marquee>"
     string_of_dirty_html.behave_like 'html_sanitizer'
 
 ```
 
+`behave_like` also accepts block which can be used in `included` section.
+I have no idea whom need that, but decided to make it possible.
+
+```ruby
+
+    module HtmlSanitizerTrait
+      included do |*args, block|
+        args.each do |method_name|
+          define_method(method_name) do
+            method_name.to_s
+          end
+       end
+       block.call if block
+     end # included
+
+    class VictimWithBlock
+      behaves_like :HtmlSanitizerTrait, 'cleanup_processor' do
+        class_variable_set(:@@foo, "I'm set")
+        # ... something useful
+      end
+    end
+
+```
+
 
 ## Contributing
 

data/lib/penetrator.rb

@@ -18,13 +18,23 @@ module Penetrator
         @_dependencies.each { |dep| base.send(:include, dep) }
         super
         base.extend const_get("ClassMethods") if const_defined?("ClassMethods")
-        base.class_exec(*@_trait_args, &@_included_block) if instance_variable_defined?("@_included_block")
+        return unless instance_variable_defined?("@_included_block")
+        if @_trait_block
+          base.class_exec(*@_trait_args, @_trait_block, &@_included_block)
+        else
+          base.class_exec(*@_trait_args, &@_included_block)
+        end
       end
     end
 
     def extend_object(obj)
       super
-      (class << obj; self; end).instance_exec(*@_trait_args, &@_included_block) if instance_variable_defined?("@_included_block")
+      return unless instance_variable_defined?("@_included_block")
+      if @_trait_block
+        (class << obj; self; end).instance_exec(*@_trait_args, @_trait_block, &@_included_block)
+      else
+        (class << obj; self; end).instance_exec(*@_trait_args, &@_included_block)
+      end
     end
 
     def included(base = nil, &block)
@@ -42,18 +52,20 @@ module Penetrator
     end
 
     module ClassMethods
-      def behaves_like(trait_name, *args)
+      def behaves_like(trait_name, *args, &block)
         full_name = "#{Penetrator::Inflector.camelize(trait_name.to_s)}Trait"
         trait = Penetrator::Inflector.constantize(full_name)
         trait.instance_variable_set(:@_trait_args, args)
+        trait.instance_variable_set(:@_trait_block, block)
         include trait
       end
     end # ClassMethods
 
-    def behaves_like(trait_name, *args)
+    def behaves_like(trait_name, *args, &block)
       full_name = "#{Penetrator::Inflector.camelize(trait_name.to_s)}Trait"
       trait = Penetrator::Inflector.constantize(full_name)
       trait.instance_variable_set(:@_trait_args, args)
+      trait.instance_variable_set(:@_trait_block, block)
       extend trait
     end
   end # Behavior

data/lib/penetrator/version.rb

@@ -5,7 +5,7 @@ module Penetrator
   module Version
     MAJOR = 0
     MINOR = 1
-    PATCH = 6
+    PATCH = 8
 
     # Returns a version string by joining <tt>MAJOR</tt>, <tt>MINOR</tt>, and <tt>PATCH</tt> with <tt>'.'</tt>
     #

data/spec/concern_spec.rb

@@ -58,35 +58,65 @@ describe 'behavior when trait add ClassMethods and Instance methods' do
 end
 
 
- describe 'behavior when trait add ClassMethods and Instance methods alongside with existing' do
-   module SuperRichTrait
-     extend Penetrator::Concern
-     module ClassMethods
-       def class_method(arg)
-         "From Trait with chaining"
-       end
-     end
+describe 'behavior when trait add ClassMethods and Instance methods alongside with existing' do
+  module SuperRichTrait
+    extend Penetrator::Concern
+    module ClassMethods
+      def class_method(arg)
+        "From Trait with chaining"
+      end
+    end
 
-     def instance_method(arg)
-       "From Trait with chaining"
-     end
-   end
+    def instance_method(arg)
+      "From Trait with chaining"
+    end
+  end
 
-   it 'add class and instance methods from traits' do
-     class Innocent
-       def self.class_method arg
-         "This is class argument: #{arg} " + super
-       end
-       def instance_method arg
-         "This is instance argument: #{arg} " + super
-       end
+  it 'add class and instance methods from traits' do
+    class Innocent
+      def self.class_method arg
+        "This is class argument: #{arg} " + super
+      end
+      def instance_method arg
+        "This is instance argument: #{arg} " + super
+      end
 
-       behaves_like 'super_rich'
-     end
+      behaves_like 'super_rich'
+    end
 
-     obj = Innocent.new
-     obj.instance_method('iarg').must_be :==, 'This is instance argument: iarg From Trait with chaining'
-     Innocent.class_method('carg').must_be :==, 'This is class argument: carg From Trait with chaining'
-   end
+    obj = Innocent.new
+    obj.instance_method('iarg').must_be :==, 'This is instance argument: iarg From Trait with chaining'
+    Innocent.class_method('carg').must_be :==, 'This is class argument: carg From Trait with chaining'
+  end
+
+end
+
+
+
+describe 'behavior when trait utilize arguments and block' do
+  module WithArgsAndBlockTrait
+    extend Penetrator::Concern
+    included do |*args, block|
+      args.each do |method_name|
+        define_method(method_name) do
+          method_name.to_s
+        end
+      end
+      block.call if block
+    end # included
+
+  end # WithArgsAndBlockTrait
+
+  it 'receive trait block' do
+    class VictimWithBlock
+      behaves_like :WithArgsAndBlock, 'arg1' do
+        class_variable_set(:@@foo, "I'm set")
+      end
+    end
+    obj = VictimWithBlock.new
+    obj.must_respond_to :arg1
+    obj.arg1.must_be :==, 'arg1'
+    VictimWithBlock.class_variable_get(:@@foo).must_be :==, "I'm set"
+  end
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: penetrator
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-06 00:00:00.000000000 Z
+date: 2012-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake