arrayfu 0.0.8 → 0.1.0

data/spec/specs/dsl_usage_spec.rb

@@ -1,15 +1,19 @@
 require 'spec_helper'
 
 module ArrayFu
-  describe Dsl do
+  describe ArrayDefinition 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
+          include ArrayFu
+
+          array :kids do|a|
+            a.readable
+            a.mutator :register_child 
+          end
 
           def initialize
-            array :kids do|a|
-              a.mutator :register_child 
-            end
+            initialize_arrayfu
           end
         end
 
@@ -20,18 +24,21 @@ module ArrayFu
       end
       it "should be able to expose a mutator with custom logic" do
         class Item
+          include ArrayFu
           attr_accessor :added,:item_added
 
+          array :kids do|a|
+            a.readable
+            a.mutator :register_child do|the_item|
+              @item_added = the_item
+              @added +=1
+              @kids.push(the_item)
+            end
+          end
+
           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
+            initialize_arrayfu
           end
         end
 
@@ -43,20 +50,11 @@ module ArrayFu
       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
+          include Singleton
+
           attr_accessor :items
+
           def initialize
             @items = 0
           end
@@ -65,24 +63,42 @@ module ArrayFu
           end
         end
 
-        our_visitor = OurVisitor.new
-        item = Item.new(our_visitor)
+        class Item
+          include ArrayFu
+          attr_accessor :added
+
+          array :kids do|a|
+            a.mutator :register_child
+            a.process_using :register_kids, OurVisitor.instance
+          end
+
+          def initialize
+            @added = 0
+            initialize_arrayfu
+          end
+        end
+
+
+        item = Item.new
         item.register_child("hello")
         item.kids.count.should == 1
         item.register_kids
-        our_visitor.items.should == 1
+        OurVisitor.instance.items.should == 1
       end
 
       it "should be able to expose a processing visitor by symbol" do
         class Item
+          include ArrayFu
           attr_accessor :added
 
+          array :kids do|a|
+            a.mutator :register_child
+            a.process_using :register_kids,:speak
+          end
+
           def initialize
             @added = 0
-            array :kids do|a|
-              a.mutator :register_child
-              a.process_using :register_kids,:speak
-            end
+            initialize_arrayfu
           end
         end
 
@@ -108,11 +124,15 @@ module ArrayFu
       context "and no block is provided" do
         it "should expose the specified method to trigger addition" do
           class Item
+            include ArrayFu
+
+            array :kids do|a|
+              a.readable
+              a.mutator :register_child
+            end
 
             def initialize
-              array :kids do|a|
-                a.mutator :register_child
-              end
+              initialize_arrayfu
             end
           end
 
@@ -126,17 +146,19 @@ module ArrayFu
       context "and a block is provided" do
         it "should provide a method that delegates to the block when invoked" do
           class Item
+            include ArrayFu
             attr_accessor :added
 
+            array :kids do|a|
+              a.mutator :register_child do|item|
+                @kids.push(item)
+                @added+=1
+              end
+            end
+
             def initialize
               @added = 0
-
-              array :kids do|a|
-                a.mutator :register_child do|item|
-                  @kids.push(item)
-                  @added+=1
-                end
-              end
+              initialize_arrayfu
             end
           end
 
@@ -149,27 +171,34 @@ module ArrayFu
 
 
       context "when criterias have been specified on the array" do
-        class BeGreaterThanZero
+        module BeGreaterThanZero
+          extend self
           def name
             return "Be greater than 0"
           end
-          def is_satisfied_by(item)
+          def matches?(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
+            module RaiseCriteriaFailure
+              extend self
               def run(name,value)
                 raise "The value #{value} does not meet the criteria #{name}"
               end
             end
             class OneClass
+              include ArrayFu
+
+              array :items do|a|
+                a.readable
+                a.mutator :add_item,:add_this,:add_that
+                a.new_item_must BeGreaterThanZero, RaiseCriteriaFailure
+              end
+
               def initialize
-                array :items do|a|
-                  a.mutator :add_item,:add_this,:add_that
-                  a.new_item_must BeGreaterThanZero.new, RaiseCriteriaFailure.new
-                end
+                initialize_arrayfu
               end
             end
             let(:target){OneClass.new}
@@ -196,11 +225,16 @@ module ArrayFu
               end
             end
             class AnotherClass
+              include ArrayFu
+
+              array :items do|a|
+                a.readable
+                a.mutator :add_item,:add_this,:add_that
+                a.new_item_must BeGreaterThanZero, DisplayCriteriaFailure.instance
+              end
+
               def initialize
-                array :items do|a|
-                  a.mutator :add_item,:add_this,:add_that
-                  a.new_item_must BeGreaterThanZero.new, DisplayCriteriaFailure.instance
-                end
+                initialize_arrayfu
               end
             end
             let(:target){AnotherClass.new}

data/spec/specs/{mutator_step_spec.rb → generate_mutators_spec.rb}

@@ -1,13 +1,13 @@
 require 'spec_helper'
 
 module ArrayFu
-  describe MutatorStep do
+  describe GenerateMutators do
     context "when run" do
       let(:numbers){[]}
       let(:target){Sample.new(numbers)}
       let(:mutators){[]}
-      let(:sut){MutatorStep.new}
-      let(:builder){Dsl.new(:numbers)}
+      let(:sut){GenerateMutators}
+      let(:builder){ArrayDefinition.new(:numbers)}
 
       context "using a dsl fragment that contains no block usage" do
         before (:each) do
@@ -24,7 +24,7 @@ module ArrayFu
       end
       context "using a dsl fragment that contains block usage" do
         before (:each) do
-          builder.mutator(:add_a_number) do|value|
+          builder.mutator :add_a_number do|value|
             @value_attempted_to_be_added = value
           end
         end
@@ -35,7 +35,7 @@ module ArrayFu
           target.respond_to?(:add_a_number).should be_true
           target.add_a_number(2)
           numbers.count.should == 0
-          @value_attempted_to_be_added.should == 2
+          target.value_attempted_to_be_added.should == 2
         end
       end
 

data/spec/specs/{readable_step_spec.rb → generate_readers_spec.rb}

@@ -1,12 +1,12 @@
 require 'spec_helper'
 
 module ArrayFu
-  describe ReadableStep do
+  describe GenerateReaders do
     context "when run" do
       let(:target){Sample.new}
       let(:mutators){[]}
-      let(:sut){ReadableStep.new}
-      let(:builder){Dsl.new(:numbers)}
+      let(:sut){GenerateReaders}
+      let(:builder){ArrayDefinition.new(:numbers)}
 
       context "using a dsl fragment that contains no block usage" do
         before (:each) do

data/spec/specs/{visitor_detail_step_spec.rb → generate_visitors_spec.rb}

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 module ArrayFu
-  describe VisitorDetailStep do
+  describe GenerateVisitors do
     class OurSet
       attr_accessor :items
 
@@ -26,8 +26,8 @@ module ArrayFu
         let(:target){OurSet.new}
         let(:mutators){[]}
         let(:invocations){[]}
-        let(:sut){VisitorDetailStep.new}
-        let(:builder){Dsl.new(:items)}
+        let(:sut){GenerateVisitors}
+        let(:builder){ArrayDefinition.new(:items)}
         before (:each) do
           (1..10).each{|item| target.add(Speak.new(invocations))}
           builder.process_using(:run,:hello)
@@ -55,8 +55,8 @@ module ArrayFu
         let(:visitor){TheVisitor.new}
         let(:mutators){[]}
         let(:invocations){[]}
-        let(:sut){VisitorDetailStep.new}
-        let(:builder){Dsl.new(:items)}
+        let(:sut){GenerateVisitors}
+        let(:builder){ArrayDefinition.new(:items)}
 
         before (:each) do
           (1..10).each{|item| target.add(item)}

data/spec/specs/{writeable_step_spec.rb → generate_writers_step_spec.rb}

@@ -1,13 +1,13 @@
 require 'spec_helper'
 
 module ArrayFu
-  describe WriteableStep do
+  describe GenerateWriters do
     context "when run" do
       context "using a dsl fragment that contains no block usage" do
         let(:target){Sample.new}
         let(:mutators){[]}
-        let(:sut){WriteableStep.new}
-        let(:builder){Dsl.new(:numbers)}
+        let(:sut){GenerateWriters}
+        let(:builder){ArrayDefinition.new(:numbers)}
         before (:each) do
           builder.writable
         end

data/spec/specs/{object_extensions_spec.rb → initializer_spec.rb}

@@ -1,9 +1,10 @@
 require 'spec_helper'
 
-describe Object do
+describe ArrayFu::Initializer do
   context "when initializing fields with defaults" do
     it "should initialize based on the factory provided" do
       class Item
+        include ArrayFu::Initializer
         attr_accessor :kids,:cars,:name
 
         def initialize
@@ -21,6 +22,7 @@ describe Object do
   context "when initializing simple arrays" do
     it "should initialize all arrays specified on the instance" do
       class Item
+        include ArrayFu::Initializer
         attr_accessor :kids,:cars,:bikes
 
         def initialize
@@ -38,6 +40,7 @@ describe Object do
   context "when initializing hashes" do
     it "should initialize all hashes specified" do
       class Item
+        include ArrayFu::Initializer
         attr_accessor :kids,:cars,:bikes
 
         def initialize

data/spec/specs/{add_criterion_spec.rb → item_constraint_spec.rb}

@@ -1,31 +1,31 @@
 require 'spec_helper'
 
 module ArrayFu
-  describe AddCriterion do
+  describe ItemConstraint do
     context "when applied to a value" do
       let(:failure_strategy){fake}
-      let(:criteria){fake}
+      let(:constraint){fake}
       let(:value){42}
-      let(:name){"Name of criteria"}
-      let(:sut){AddCriterion.new(criteria,failure_strategy)}
+      let(:name){"Name of constraint"}
+      let(:sut){ItemConstraint.new(constraint, failure_strategy)}
 
-      context "and the value does not match the criteria" do
+      context "and the value does not match the constraint" do
         before (:each) do
-          criteria.stub(:is_satisfied_by).with(value).and_return(false)
-          criteria.stub(:name).and_return(name)
+          constraint.stub(:matches?).with(value).and_return(false)
+          constraint.stub(:name).and_return(name)
         end
         before (:each) do
           sut.apply_to(value)
         end
         it "should run the failure strategy with the correct information" do
-          failure_strategy.should have_received(:run,name,value)
+          failure_strategy.should have_received(:run, name, value)
         end
       end
 
-      context "and the value matches the criteria" do
+      context "and the value matches the constraint" do
         before (:each) do
-          criteria.stub(:is_satisfied_by).with(value).and_return(true)
-          criteria.stub(:name).and_return(name)
+          constraint.stub(:matches?).with(value).and_return(true)
+          constraint.stub(:name).and_return(name)
         end
         before (:each) do
           @result = sut.apply_to(value)

data/spec/specs/sample.rb

@@ -1,4 +1,6 @@
 class Sample
+  attr_reader :value_attempted_to_be_added
+
   def initialize(numbers = [])
     @numbers = numbers
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: arrayfu
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.1.0
 platform: ruby
 authors:
 - Develop With Passion®
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-24 00:00:00.000000000 Z
+date: 2013-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -79,29 +79,29 @@ files:
 - Rakefile
 - arrayfu.gemspec
 - lib/arrayfu.rb
-- lib/arrayfu/add_criterion.rb
-- lib/arrayfu/dsl.rb
+- lib/arrayfu/array_definition.rb
+- lib/arrayfu/arrayfu.rb
+- lib/arrayfu/generate_mutators.rb
+- lib/arrayfu/generate_readers.rb
+- lib/arrayfu/generate_visitors.rb
+- lib/arrayfu/generate_writers.rb
+- lib/arrayfu/initializer.rb
+- lib/arrayfu/item_constraint.rb
 - lib/arrayfu/module_registry.rb
-- lib/arrayfu/mutator_detail.rb
-- lib/arrayfu/mutator_step.rb
-- lib/arrayfu/object_extensions.rb
-- lib/arrayfu/readable_step.rb
+- lib/arrayfu/mutator_definition.rb
 - lib/arrayfu/version.rb
-- lib/arrayfu/visitor_detail.rb
-- lib/arrayfu/visitor_detail_step.rb
-- lib/arrayfu/writeable_step.rb
-- spec/examples/class_usage.rb
-- spec/examples/instance_usage.rb
+- lib/arrayfu/visitor_definition.rb
+- spec/examples/usage.rb
 - spec/spec_helper.rb
-- spec/specs/add_criterion_spec.rb
-- spec/specs/dsl_spec.rb
+- spec/specs/array_definition_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
+- spec/specs/generate_mutators_spec.rb
+- spec/specs/generate_readers_spec.rb
+- spec/specs/generate_visitors_spec.rb
+- spec/specs/generate_writers_step_spec.rb
+- spec/specs/initializer_spec.rb
+- spec/specs/item_constraint_spec.rb
 - spec/specs/sample.rb
-- spec/specs/visitor_detail_step_spec.rb
-- spec/specs/writeable_step_spec.rb
 homepage: http://www.developwithpassion.com
 licenses: []
 metadata: {}
@@ -126,15 +126,14 @@ signing_key:
 specification_version: 4
 summary: Simple DSL For Declaritive Arrays
 test_files:
-- spec/examples/class_usage.rb
-- spec/examples/instance_usage.rb
+- spec/examples/usage.rb
 - spec/spec_helper.rb
-- spec/specs/add_criterion_spec.rb
-- spec/specs/dsl_spec.rb
+- spec/specs/array_definition_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
+- spec/specs/generate_mutators_spec.rb
+- spec/specs/generate_readers_spec.rb
+- spec/specs/generate_visitors_spec.rb
+- spec/specs/generate_writers_step_spec.rb
+- spec/specs/initializer_spec.rb
+- spec/specs/item_constraint_spec.rb
 - spec/specs/sample.rb
-- spec/specs/visitor_detail_step_spec.rb
-- spec/specs/writeable_step_spec.rb

data/lib/arrayfu/add_criterion.rb

@@ -1,16 +0,0 @@
-module ArrayFu
-  class AddCriterion
-    attr_accessor :criteria,:failure_strategy
-
-    def initialize(criteria,failure_strategy)
-      @criteria = criteria
-      @failure_strategy = failure_strategy
-    end
-
-    def apply_to(value)
-      result = @criteria.is_satisfied_by(value)
-      @failure_strategy.run(@criteria.name,value) unless result
-      return result
-    end
-  end
-end

data/lib/arrayfu/dsl.rb

@@ -1,43 +0,0 @@
-module ArrayFu
-  class Dsl
-    attr_accessor :mutators,:visitors,:criteria,:name,:writable,:readable
-
-    def initialize(name)
-      @name = name
-      initialize_arrays :mutators,:visitors,:criteria
-      initialize_false :writable,:readable
-    end
-
-    def mutator(*names,&block)
-      names.each{|name| @mutators.push(MutatorDetail.new(name,block))}
-    end
-
-    def new_item_must(criteria,fail_option)
-      @criteria.push(AddCriterion.new(criteria,fail_option))
-    end
-
-    def process_using(name,visitor)
-      @visitors.push(VisitorDetail.new(name,visitor))
-    end
-
-    def read_and_write
-      writable
-      readable
-    end
-
-    def writable
-      @writable = true
-    end
-
-    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/arrayfu/mutator_detail.rb

@@ -1,10 +0,0 @@
-module ArrayFu
-  class MutatorDetail
-    attr_accessor :name,:block
-
-    def initialize(name,block)
-      @name = name
-      @block = block
-    end
-  end
-end

data/lib/arrayfu/mutator_step.rb

@@ -1,18 +0,0 @@
-module ArrayFu
-  class MutatorStep
-    def create_using(builder)
-      Module.new do
-        builder.mutators.each do|mutator|
-          define_method(mutator.name) do|value|
-            array_var = instance_variable_get("@#{builder.name}")
-            continue_add = true
-            builder.criteria.each{|criteria| continue_add &= criteria.apply_to(value)}
-            return unless continue_add
-            array_var.push(value) unless mutator.block
-            mutator.block.call(value) if mutator.block
-          end
-        end
-      end
-      end
-    end
-  end

data/lib/arrayfu/object_extensions.rb

@@ -1,27 +0,0 @@
-class Object
-  def initialize_defaults(factory,*items)
-    items.each do|item|
-      instance_variable_set("@#{item}",factory.call)
-    end
-  end
-
-  def initialize_arrays(*items)
-    initialize_defaults(lambda{[]},*items)
-  end
-
-  def initialize_hashes(*items)
-    initialize_defaults(lambda{{}},*items)
-  end
-
-  def initialize_false(*items)
-    initialize_defaults(lambda{false},*items)
-  end
-
-  def array(name,&block)
-    initialize_arrays(name)
-    dsl = ArrayFu::Dsl.new(name)
-    yield dsl if block_given?
-    ArrayFu::ModuleRegistry.configure(self,dsl)
-  end
-
-end

data/lib/arrayfu/visitor_detail.rb

@@ -1,10 +0,0 @@
-module ArrayFu
-  class VisitorDetail
-    attr_accessor :name,:visitor
-
-    def initialize(name,visitor)
-      @name = name
-      @visitor = visitor
-    end
-  end
-end

data/lib/arrayfu/visitor_detail_step.rb

@@ -1,14 +0,0 @@
-module ArrayFu
-  class VisitorDetailStep
-    def create_using(builder)
-      Module.new do
-        builder.visitors.each do|visitor|
-          define_method(visitor.name) do
-            array_var = instance_variable_get("@#{builder.name}")
-            array_var.each{|item| visitor.visitor.respond_to?(:run_using) ? visitor.visitor.run_using(item) : item.send(visitor.visitor)}
-          end
-        end
-      end
-      end
-    end
-  end