penetrator 0.0.1 → 0.1.0

data/README.md

@@ -3,7 +3,7 @@
 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
 conventional *super* inheritance chaining methods.
-
+Also shameless borrowed code from ActiveSupport::Coerce and I should say thanks that Ruby Hackers, who wrote it.
 
 ## Installation
 
@@ -24,7 +24,7 @@ Or install it yourself as:
 
 *config/application.rb*
 ```ruby
-config.autoload_paths += Dir[Rails.root.join( 'app', '**/*' )].select { |fn| File.directory?(fn) }
+config.autoload_paths += Rails.root.join( 'app', 'traits' )
 ```
 
 *app/controllers/traits/crudable_trait.rb*
@@ -51,7 +51,7 @@ config.autoload_paths += Dir[Rails.root.join( 'app', '**/*' )].select { |fn| Fil
             end
           end
 
-          # ... and so on
+          # ... and so on ...
 
           private
             def take_layout
@@ -68,7 +68,7 @@ config.autoload_paths += Dir[Rails.root.join( 'app', '**/*' )].select { |fn| Fil
 ```ruby
         class AccomodationsController < ApplicationController
           #
-          # CrudableTrait required parameters
+          # CrudableTrait required this mehod
           private
           def resource_class
             Accomodation
@@ -91,6 +91,15 @@ config.autoload_paths += Dir[Rails.root.join( 'app', '**/*' )].select { |fn| Fil
           def default_order
             "accomodations.name desc"
           end
+
+          public
+          # Override traits methods
+          # with respecting call chaining
+          #
+          def kill_all_humans
+            "Yes" or super
+          end
+
         end
 ```
 

data/lib/penetrator/version.rb

@@ -1,4 +1,4 @@
 # -*- encoding : utf-8 -*-
 module Penetrator
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/lib/penetrator.rb

@@ -3,23 +3,48 @@ require "penetrator/inflector"
 require "penetrator/version"
 
 module Penetrator
-  module Behavior
+  module Concern
+    def self.extended(base) #:nodoc:
+      base.instance_variable_set("@_dependencies", [])
+    end
+
+    def append_features(base)
+      if base.instance_variable_defined?("@_dependencies")
+        base.instance_variable_get("@_dependencies") << self
+        return false
+      else
+        return false if base < self
+        @_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")
+      end
+    end
 
+    def included(base = nil, &block)
+      if base.nil?
+        @_included_block = block
+      else
+        super
+      end
+    end
+  end # Concern
+
+  module Behavior
     def self.included(base)
       base.extend ClassMethods
     end
 
     module ClassMethods
-      def behave_like(trait_name, *args)
+      def behaves_like(trait_name, *args)
         full_name = "#{Penetrator::Inflector.camelize(trait_name.to_s)}Trait"
         trait = Penetrator::Inflector.constantize(full_name)
-        trait_args_var = "@@" + trait_name.to_s.downcase.gsub(/[^_a-z]+/, '_')+"_args"
-        self.class_variable_set(trait_args_var.to_sym, (args || nil))
+        trait.instance_variable_set(:@_trait_args, args)
         include trait
       end
-    end
+    end # ClassMethods
+  end # Behavior
 
-  end
 end
 
 Object.send :include, Penetrator::Behavior

data/penetrator.gemspec

@@ -17,5 +17,6 @@ Gem::Specification.new do |gem|
   if RUBY_VERSION < '1.9.0'
     gem.add_development_dependency "minitest"
   end
+  gem.add_development_dependency "rake"
   gem.add_development_dependency "mocha"
 end

data/spec/coerce_spec.rb

@@ -0,0 +1,92 @@
+# -*- encoding : utf-8 -*-
+require 'penetrator'
+require 'minitest/spec'
+require 'minitest/autorun'
+
+describe 'behavior when trait can be parameterized by arguments passed into included module' do
+  module CanHaveArgsTrait
+    extend Penetrator::Concern
+    included do |*args|
+      args.each do |method_name|
+        define_method(method_name) do
+          method_name.to_s
+        end
+      end
+    end # included
+  end # CanHaveArgs
+
+  it 'receive trait arguments' do
+    class Victim
+      behaves_like :CanHaveArgs, 'arg1', 'arg2'
+    end
+    obj = Victim.new
+    obj.must_respond_to :arg1
+    obj.arg1.must_be :==, 'arg1'
+    obj.must_respond_to :arg2
+    obj.arg2.must_be :==, 'arg2'
+
+    class OtherVictim
+      behaves_like :CanHaveArgs
+    end
+    obj = OtherVictim.new
+    obj.wont_respond_to :arg1
+    obj.wont_respond_to :arg2
+  end
+
+end # trait argument
+
+describe 'behavior when trait add ClassMethods and Instance methods' do
+   module RichTrait
+     extend Penetrator::Concern
+     module ClassMethods
+       def class_method
+       end
+     end
+
+     def instance_method
+     end
+   end
+
+   it 'add class and instance methods from traits' do
+     class VictimWithNoArguments
+       behaves_like 'rich'
+     end
+     obj = VictimWithNoArguments.new
+     obj.must_respond_to :instance_method
+     VictimWithNoArguments.must_respond_to :class_method
+   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
+
+   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
+
+     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

data/spec/core_spec.rb

@@ -6,7 +6,7 @@ require 'mocha'
 
 describe 'Class' do
   it 'should be accesable' do
-    Class.must_respond_to :behave_like
+    Class.must_respond_to :behaves_like
   end
 end # Class method
 
@@ -19,7 +19,7 @@ describe 'mixing behavior' do
 
   it 'add trait methods' do
     class Victim
-      behave_like 'first'
+      behaves_like 'first'
     end
 
     Victim.new.must_respond_to :test
@@ -35,7 +35,7 @@ describe 'mixing behavior' do
 
   it 'add traits methods from nested modules' do
     class Victim
-      behave_like 'outer/inner'
+      behaves_like 'outer/inner'
     end
     Victim.new.must_respond_to :inner_test
   end
@@ -53,7 +53,7 @@ describe 'methods chainings' do
 
   it 'have traits methods' do
     class Victim
-      behave_like 'super'
+      behaves_like 'super'
       def test
         'this from class and that ' + super
       end
@@ -72,23 +72,23 @@ describe 'callbacks' do
     class Victim; end
     CallbackTrait.expects(:included).with(Victim)
     class Victim
-      behave_like 'callback'
+      behaves_like 'callback'
     end
   end
 end # callbacks
 
 describe 'visibility' do
   module VisibilityTrait
-    def public_method_from_trait;   end
+    def public_method_from_trait;    end
     protected
-    def protected_method_from_trait;  end
+    def protected_method_from_trait; end
     private
     def private_method_from_trait;   end
   end
 
   it 'allow trait to define methods with different visibility' do
     class Victim
-      behave_like 'visibility'
+      behaves_like 'visibility'
     end
 
     instance = Victim.new
@@ -99,42 +99,3 @@ describe 'visibility' do
   end
 
 end # visibility
-
-describe 'trait arguments' do
-  module HaveArgsTrait; end
-
-  it 'receive trait arguments' do
-    class Victim; end
-    Victim.expects(:behave_like).with('have_args', 'arg1', 'arg2')
-
-    class Victim
-      behave_like 'have_args', 'arg1', 'arg2'
-    end
-
-  end
-
-  it 'base holds arguments' do
-    class Victim
-      behave_like 'have_args', 'arg1', 'arg2'
-    end
-    Victim.class_variable_get(:@@have_args_args).must_equal ['arg1','arg2']
-  end
-
-
-  describe 'arguments defined before trait included' do
-    module HandyTrait
-      def self.included(base)
-        base.send :stub, base.class_variable_get(:@@handy_args)
-      end
-    end
-
-    class Victim; end
-    Victim.expects(:stub).with(['arg'])
-
-    class Victim
-      behave_like :handy, 'arg'
-    end
-  end # 'trait use arguments'
-
-
-end # trait argument

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: penetrator
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,27 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-05 00:00:00.000000000 Z
+date: 2012-10-04 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: mocha
-  requirement: &70150947089080 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +37,12 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70150947089080
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Implement traits behavior to get rid of code repetition
 email:
 - jurbat@gmail.com
@@ -38,6 +59,7 @@ files:
 - lib/penetrator/inflector.rb
 - lib/penetrator/version.rb
 - penetrator.gemspec
+- spec/coerce_spec.rb
 - spec/core_spec.rb
 homepage: https://github.com/svenyurgensson/penetrator
 licenses: []
@@ -59,9 +81,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Implement traits behavior to get rid of code repetition
 test_files:
+- spec/coerce_spec.rb
 - spec/core_spec.rb