arrayfu 0.0.4 → 0.0.6

data/arrayfu.gemspec

@@ -15,7 +15,6 @@ Gem::Specification.new do |s|
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 
   # specify any dependencies here; for example:

data/lib/core/dsl.rb

@@ -32,5 +32,12 @@ module ArrayFu
     def readable
       @readable = true
     end
+
+    def configure_using(*configurators)
+      configurators.each do|configurator|
+        method = configurator.respond_to?(:configure) ? :configure : 'call'.to_sym
+        configurator.send(method,self)
+      end
+    end
   end
 end

data/lib/core/module_registry.rb

@@ -8,5 +8,9 @@ module ArrayFu
         ReadableStep.new
       ]
     end
+
+    def self.configure(target,dsl)
+      all_modules.each{|the_module| target.extend(the_module.create_using(dsl))}
+    end
   end
 end

data/lib/core/mutator_step.rb

@@ -1,6 +1,6 @@
 module ArrayFu
   class MutatorStep
-    def run_using(builder)
+    def create_using(builder)
       Module.new do
         builder.mutators.each do|mutator|
           define_method(mutator.name) do|value|

data/lib/core/object_extensions.rb

@@ -21,7 +21,7 @@ class Object
     initialize_arrays(name)
     dsl = ArrayFu::Dsl.new(name)
     yield dsl if block_given?
-    ArrayFu::ModuleRegistry.all_modules.each{|module_factory| self.extend(module_factory.run_using(dsl))}
+    ArrayFu::ModuleRegistry.configure(self,dsl)
   end
 
 end

data/lib/core/readable_step.rb

@@ -1,6 +1,6 @@
 module ArrayFu
   class ReadableStep
-    def run_using(builder)
+    def create_using(builder)
       Module.new do
         if (builder.readable)
           define_method(builder.name) do

data/lib/core/version.rb

@@ -1,3 +1,3 @@
 module ArrayFu
-  VERSION = "0.0.4"
+  VERSION = "0.0.6"
 end

data/lib/core/visitor_detail_step.rb

@@ -1,6 +1,6 @@
 module ArrayFu
   class VisitorDetailStep
-    def run_using(builder)
+    def create_using(builder)
       Module.new do
         builder.visitors.each do|visitor|
           define_method(visitor.name) do

data/lib/core/writeable_step.rb

@@ -1,6 +1,6 @@
 module ArrayFu
   class WriteableStep
-    def run_using(builder)
+    def create_using(builder)
       Module.new do
         if (builder.writable)
           define_method("#{builder.name}=") do|value|

data/spec/examples/instance_usage.rb

@@ -241,3 +241,49 @@ example 'Add an method based processing visitor to the array based on a method t
   items.display_all
   SomeClass.number_of_items_visited.should == 10
 end
+
+example 'Augment configuration using configuration block' do
+  class ArrayConfigs
+    def self.add_another_mutator
+      return lambda{|item| item.mutator :another_push}
+    end
+  end
+
+  class SomeClass
+
+    def initialize
+      array :names do|a|
+        a.mutator :add_item
+        a.configure_using ArrayConfigs.add_another_mutator
+      end
+    end
+  end
+
+  items = SomeClass.new
+  items.add_item("Yo")
+  items.another_push("Yo")
+  items.names.count.should == 2
+end
+
+example 'Augment configuration using configuration instance' do
+  class ArrayConfigs
+    def configure(item)
+      item.mutator :once_more
+    end
+  end
+
+  class SomeClass
+
+    def initialize
+      array :names do|a|
+        a.mutator :add_item
+        a.configure_using ArrayConfigs.new
+      end
+    end
+  end
+
+  items = SomeClass.new
+  items.add_item("Yo")
+  items.once_more("Yo")
+  items.names.count.should == 2
+end

data/spec/spec_helper.rb

@@ -9,6 +9,7 @@ Dir.chdir(File.join(File.dirname(__FILE__),"..,lib".split(','))) do
   require 'arrayfu.rb'
 end
 
+
 def catch_exception
   begin
     yield

data/spec/specs/dsl_spec.rb

@@ -64,221 +64,65 @@ module ArrayFu
       end
     end
 
-    context "using the dsl" do
-      it "should be able to initialize all arrays specified on the instance and provide a method to expose addition" do
-        class Item
+    context "when a set of configurators are provided" do
+      context "and they are explicit configurators" do
+        let(:configurator1){fake}
+        let(:configurator2){fake}
+        subject{Dsl.new('name')}
 
-          def initialize
-            array :kids do|a|
-              a.mutator :register_child 
-            end
-          end
-        end
-
-        item = Item.new
-        item.methods.include?(:register_child).should be_true
-        item.register_child("hello")
-        item.kids.count.should == 1
-      end
-      it "should be able to expose a mutator with custom logic" do
-        class Item
-          attr_accessor :added,:item_added
-
-          def initialize
-            @added = 0
-
-            array :kids do|a|
-              a.mutator :register_child do|the_item|
-                @item_added = the_item
-                @added +=1
-                @kids.push(the_item)
-              end
-            end
-          end
+        before (:each) do
+          def configurator1.respond_to?(name) true end
+          def configurator2.respond_to?(name) true end
         end
 
-        item = Item.new
-        item.register_child("hello")
-        item.kids.count.should == 1
-        item.item_added.should == "hello"
-        item.added.should == 1
-      end
-
-      it "should be able to expose a processing visitor" do
-        class Item
-          attr_accessor :added
-
-          def initialize(visitor)
-            @added = 0
-            array :kids do|a|
-              a.mutator :register_child
-              a.process_using :register_kids,visitor
-            end
-          end
+        before (:each) do
+          subject.configure_using configurator1,configurator2
         end
 
-        class OurVisitor
-          attr_accessor :items
-          def initialize
-            @items = 0
-          end
-          def run_using(item)
-            @items +=1
-          end
+        it "should invoke the configurator with the dsl" do
+          configurator1.should have_received(:configure,subject)
+          configurator2.should have_received(:configure,subject)
         end
-
-        our_visitor = OurVisitor.new
-        item = Item.new(our_visitor)
-        item.register_child("hello")
-        item.kids.count.should == 1
-        item.register_kids
-        our_visitor.items.should == 1
       end
 
-      it "should be able to expose a processing visitor by symbol" do
-        class Item
-          attr_accessor :added
-
-          def initialize
-            @added = 0
-            array :kids do|a|
-              a.mutator :register_child
-              a.process_using :register_kids,:speak
-            end
-          end
+      context "and they are a set of blocks" do
+        let(:configurator1){fake}
+        let(:configurator2){fake}
+        subject{Dsl.new('name')}
+        before (:each) do
+          @first_ran = false
+          @second_ran = false
         end
 
-        class Kid
-          def initialize(array)
-            @array = array
-          end
-          def speak
-            @array.push("spoke")
-          end
+        before (:each) do
+          subject.configure_using lambda{|item| item.should == subject;@first_ran = true},lambda{|item| item.should == subject;@second_ran = true}
         end
 
-        items = []
-        item = Item.new
-        item.register_child(Kid.new(items))
-        item.kids.count.should == 1
-        item.register_kids
-        items.count.should == 1
-      end
-    end
-
-    context "when specifying a mutator" do
-      context "and no block is provided" do
-        it "should expose the specified method to trigger addition" do
-          class Item
-
-            def initialize
-              array :kids do|a|
-                a.mutator :register_child
-              end
-            end
-          end
-
-          item = Item.new
-          item.methods.include?(:register_child).should be_true
-          item.register_child("hello")
-          item.kids.count.should == 1
+        it "should invoke each block with the dsl" do
+          @first_ran.should be_true
+          @second_ran.should be_true
         end
       end
 
-      context "and a block is provided" do
-        it "should provide a method that delegates to the block when invoked" do
-          class Item
-            attr_accessor :added
-
-            def initialize
-              @added = 0
-
-              array :kids do|a|
-                a.mutator :register_child do|item|
-                  @kids.push(item)
-                  @added+=1
-                end
-              end
-            end
-          end
-
-          item = Item.new
-          item.register_child("hello")
-          item.kids.count.should == 1
-          item.added.should == 1
+      context "and they are a mixture of blocks and explicit configurators" do
+        let(:configurator1){fake}
+        subject{Dsl.new('name')}
+        before (:each) do
+          @first_ran = false
+          def configurator1.respond_to?(name) true end
         end
-      end
-
 
-      context "when criterias have been specified on the array" do
-        class BeGreaterThanZero
-          def name
-            return "Be greater than 0"
-          end
-          def is_satisfied_by(item)
-            return item > 0
-          end
+        before (:each) do
+          subject.configure_using lambda{|item| item.should == subject;@first_ran = true},configurator1
         end
-        context "and the criteria is not met" do
-          context "and the failure strategy is set to raise an error" do
-            class RaiseCriteriaFailure
-              def run(name,value)
-                raise "The value #{value} does not meet the criteria #{name}"
-              end
-            end
-            class OneClass
-              def initialize
-                array :items do|a|
-                  a.mutator :add_item,:add_this,:add_that
-                  a.new_item_must BeGreaterThanZero.new, RaiseCriteriaFailure.new
-                end
-              end
-            end
-            let(:target){OneClass.new}
-            before (:each) do
-              @exception = catch_exception do
-                target.add_item(0)
-              end
-            end
-
-            it "should raise an error when a failed add is attempted" do
-              (@exception.message =~ /does not meet/).should be_true
-            end
-            it "should not add the item to the underlying list" do
-              target.items.count.should == 0
-            end
-          end
 
-          context "and the failure strategy is not set to raise an error" do
-            class DisplayCriteriaFailure
-              include Singleton
-              attr_accessor :message
-              def run(name,value)
-                @message = "The value #{value} does not meet the criteria #{name}"
-              end
-            end
-            class AnotherClass
-              def initialize
-                array :items do|a|
-                  a.mutator :add_item,:add_this,:add_that
-                  a.new_item_must BeGreaterThanZero.new, DisplayCriteriaFailure.instance
-                end
-              end
-            end
-            let(:target){AnotherClass.new}
-            before (:each) do
-              target.add_item(0)
-            end
-            it "should have leveraged the failure strategy that does not throw an exception" do
-              DisplayCriteriaFailure.instance.message.should_not be_nil
-            end
-            
-            it "should not add the item to the underlying list" do
-              target.items.count.should == 0
-            end
-          end
+        it "should invoke blocks and configurators" do
+          @first_ran.should be_true
+          configurator1.should have_received(:configure,subject)
         end
       end
+      
     end
+
   end
 end

data/spec/specs/dsl_usage_spec.rb

@@ -0,0 +1,222 @@
+require 'spec_helper'
+
+module ArrayFu
+  describe Dsl do
+    context "using the dsl" do
+      it "should be able to initialize all arrays specified on the instance and provide a method to expose addition" do
+        class Item
+
+          def initialize
+            array :kids do|a|
+              a.mutator :register_child 
+            end
+          end
+        end
+
+        item = Item.new
+        item.methods.include?(:register_child).should be_true
+        item.register_child("hello")
+        item.kids.count.should == 1
+      end
+      it "should be able to expose a mutator with custom logic" do
+        class Item
+          attr_accessor :added,:item_added
+
+          def initialize
+            @added = 0
+
+            array :kids do|a|
+              a.mutator :register_child do|the_item|
+                @item_added = the_item
+                @added +=1
+                @kids.push(the_item)
+              end
+            end
+          end
+        end
+
+        item = Item.new
+        item.register_child("hello")
+        item.kids.count.should == 1
+        item.item_added.should == "hello"
+        item.added.should == 1
+      end
+
+      it "should be able to expose a processing visitor" do
+        class Item
+          attr_accessor :added
+
+          def initialize(visitor)
+            @added = 0
+            array :kids do|a|
+              a.mutator :register_child
+              a.process_using :register_kids,visitor
+            end
+          end
+        end
+
+        class OurVisitor
+          attr_accessor :items
+          def initialize
+            @items = 0
+          end
+          def run_using(item)
+            @items +=1
+          end
+        end
+
+        our_visitor = OurVisitor.new
+        item = Item.new(our_visitor)
+        item.register_child("hello")
+        item.kids.count.should == 1
+        item.register_kids
+        our_visitor.items.should == 1
+      end
+
+      it "should be able to expose a processing visitor by symbol" do
+        class Item
+          attr_accessor :added
+
+          def initialize
+            @added = 0
+            array :kids do|a|
+              a.mutator :register_child
+              a.process_using :register_kids,:speak
+            end
+          end
+        end
+
+        class Kid
+          def initialize(array)
+            @array = array
+          end
+          def speak
+            @array.push("spoke")
+          end
+        end
+
+        items = []
+        item = Item.new
+        item.register_child(Kid.new(items))
+        item.kids.count.should == 1
+        item.register_kids
+        items.count.should == 1
+      end
+    end
+
+    context "when specifying a mutator" do
+      context "and no block is provided" do
+        it "should expose the specified method to trigger addition" do
+          class Item
+
+            def initialize
+              array :kids do|a|
+                a.mutator :register_child
+              end
+            end
+          end
+
+          item = Item.new
+          item.methods.include?(:register_child).should be_true
+          item.register_child("hello")
+          item.kids.count.should == 1
+        end
+      end
+
+      context "and a block is provided" do
+        it "should provide a method that delegates to the block when invoked" do
+          class Item
+            attr_accessor :added
+
+            def initialize
+              @added = 0
+
+              array :kids do|a|
+                a.mutator :register_child do|item|
+                  @kids.push(item)
+                  @added+=1
+                end
+              end
+            end
+          end
+
+          item = Item.new
+          item.register_child("hello")
+          item.kids.count.should == 1
+          item.added.should == 1
+        end
+      end
+
+
+      context "when criterias have been specified on the array" do
+        class BeGreaterThanZero
+          def name
+            return "Be greater than 0"
+          end
+          def is_satisfied_by(item)
+            return item > 0
+          end
+        end
+        context "and the criteria is not met" do
+          context "and the failure strategy is set to raise an error" do
+            class RaiseCriteriaFailure
+              def run(name,value)
+                raise "The value #{value} does not meet the criteria #{name}"
+              end
+            end
+            class OneClass
+              def initialize
+                array :items do|a|
+                  a.mutator :add_item,:add_this,:add_that
+                  a.new_item_must BeGreaterThanZero.new, RaiseCriteriaFailure.new
+                end
+              end
+            end
+            let(:target){OneClass.new}
+            before (:each) do
+              @exception = catch_exception do
+                target.add_item(0)
+              end
+            end
+
+            it "should raise an error when a failed add is attempted" do
+              (@exception.message =~ /does not meet/).should be_true
+            end
+            it "should not add the item to the underlying list" do
+              target.items.count.should == 0
+            end
+          end
+
+          context "and the failure strategy is not set to raise an error" do
+            class DisplayCriteriaFailure
+              include Singleton
+              attr_accessor :message
+              def run(name,value)
+                @message = "The value #{value} does not meet the criteria #{name}"
+              end
+            end
+            class AnotherClass
+              def initialize
+                array :items do|a|
+                  a.mutator :add_item,:add_this,:add_that
+                  a.new_item_must BeGreaterThanZero.new, DisplayCriteriaFailure.instance
+                end
+              end
+            end
+            let(:target){AnotherClass.new}
+            before (:each) do
+              target.add_item(0)
+            end
+            it "should have leveraged the failure strategy that does not throw an exception" do
+              DisplayCriteriaFailure.instance.message.should_not be_nil
+            end
+
+            it "should not add the item to the underlying list" do
+              target.items.count.should == 0
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/specs/mutator_step_spec.rb

@@ -14,7 +14,7 @@ module ArrayFu
           builder.mutator(:add_a_number)
         end
         before (:each) do
-          target.extend(sut.run_using(builder))
+          target.extend(sut.create_using(builder))
         end
         it "should create a member on the target that allows mutation of the original list" do
           target.respond_to?(:add_a_number).should be_true
@@ -29,7 +29,7 @@ module ArrayFu
           end
         end
         before (:each) do
-          target.extend(sut.run_using(builder))
+          target.extend(sut.create_using(builder))
         end
         it "should create a member on the target that intercepts mutation using the provided block" do
           target.respond_to?(:add_a_number).should be_true

data/spec/specs/readable_step_spec.rb

@@ -13,7 +13,7 @@ module ArrayFu
           builder.readable
         end
         before (:each) do
-          target.extend(sut.run_using(builder))
+          target.extend(sut.create_using(builder))
         end
         it "should create a member on the target that allows reading of the array" do
           target.numbers.should be_a(Array)

data/spec/specs/visitor_detail_step_spec.rb

@@ -33,7 +33,7 @@ module ArrayFu
           builder.process_using(:run,:hello)
         end
         before (:each) do
-          target.extend(sut.run_using(builder))
+          target.extend(sut.create_using(builder))
         end
 
         it "should create a method on the target that triggers each item in the list using its provided action" do
@@ -63,7 +63,7 @@ module ArrayFu
           builder.process_using(:run,visitor)
         end
         before (:each) do
-          target.extend(sut.run_using(builder))
+          target.extend(sut.create_using(builder))
         end
 
         it "should create a method on the target that triggers the visitor once for each item in the list" do

data/spec/specs/writeable_step_spec.rb

@@ -12,7 +12,7 @@ module ArrayFu
           builder.writable
         end
         before (:each) do
-          target.extend(sut.run_using(builder))
+          target.extend(sut.create_using(builder))
         end
         it "should create a member on the target that allows assignment to the array" do
           new_array = [1]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: arrayfu
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70170308438040 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70170308438040
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: &70170308437600 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +37,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70170308437600
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &70170308437140 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +53,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70170308437140
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: fakes-rspec
-  requirement: &70170308436700 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,12 +69,16 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70170308436700
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Simple DSL For Declaritive Arrays
 email:
 - open_source@developwithpassion.com
-executables:
-- dwp_expand
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
@@ -69,7 +88,6 @@ files:
 - Guardfile
 - Rakefile
 - arrayfu.gemspec
-- bin/dwp_expand
 - lib/arrayfu.rb
 - lib/core/add_criterion.rb
 - lib/core/dsl.rb
@@ -87,6 +105,7 @@ files:
 - spec/spec_helper.rb
 - spec/specs/add_criterion_spec.rb
 - spec/specs/dsl_spec.rb
+- spec/specs/dsl_usage_spec.rb
 - spec/specs/mutator_step_spec.rb
 - spec/specs/object_extensions_spec.rb
 - spec/specs/readable_step_spec.rb
@@ -113,7 +132,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: arrayfu
-rubygems_version: 1.8.15
+rubygems_version: 1.8.21
 signing_key: 
 specification_version: 3
 summary: Simple DSL For Declaritive Arrays
@@ -123,6 +142,7 @@ test_files:
 - spec/spec_helper.rb
 - spec/specs/add_criterion_spec.rb
 - spec/specs/dsl_spec.rb
+- spec/specs/dsl_usage_spec.rb
 - spec/specs/mutator_step_spec.rb
 - spec/specs/object_extensions_spec.rb
 - spec/specs/readable_step_spec.rb

data/bin/dwp_expand

@@ -1,4 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'developwithpassion_expander'
-DevelopWithPassion::Expander::CLIInterface.new.run(ARGV)