array_logic 0.0.2 → 0.0.3

data/README.rdoc

@@ -29,4 +29,23 @@ The *match* and *matches* methods allow arrays to be tested against these rules:
     rule_two.match([a1, a2])            --> false
     rule_two.matches([a1, a2], [a1])    --> [[a1]]
 
-See test/array_logic/rule_test for more examples
+See test/array_logic/rule_test for more examples
+
+=== Combinations that match
+
+Two methods allow you to determine sample combinations that match the current
+rule.  
+
+    rule = ArrayLogic::Rule.new
+    rule.rule = 'a1 and a2'
+    rule.combinations_that_match        -->  [[1,2]]
+    rule.combinations_that_do_not_match -->  [[1],[2]]
+
+To limit the number of samples presented, both only use ids used within
+the rule. For the example about, an array that includes [1,2] would match, 
+and so would [1,2,3]. However, arrays that only contain 1 or 2 would not match 
+(for example [1,3])
+
+Run example.rb to see some more examples
+
+    ruby /lib/example.rb

data/lib/array_logic/rule.rb

@@ -1,7 +1,7 @@
 module ArrayLogic
   class Rule
     attr_accessor :rule
-    attr_reader :things
+    attr_reader :things, :thing_ids
 
     def initialize
 
@@ -14,6 +14,7 @@ module ArrayLogic
     def match(things)
       rule_valid?
       @things = things
+      @thing_ids = things.collect(&:id)
       logic
     end
 
@@ -29,19 +30,43 @@ module ArrayLogic
     def replace_item(pattern, processor)
       @processed_rule = processed_rule.gsub(pattern) {|x| processor.call(x)}
     end
+    
+    def object_ids_used
+      chrs_after_first = 1..-1
+      objects_identifiers_in_rule.collect{|i| i[chrs_after_first].to_i}
+    end
+    
+    def combinations_that_match
+      combinations_of_identifiers_in_rule.delete_if{|ids| ! match_ids(ids)}
+    end
+    
+    def combinations_that_do_not_match
+      combinations_of_identifiers_in_rule.delete_if{|ids| match_ids(ids)}
+    end
 
     private
-    def thing_ids
-      things.collect(&:id)
+    def match_ids(ids)
+      rule_valid?
+      @thing_ids = ids
+      logic
     end
-
+    
+    def combinations_of_identifiers_in_rule
+      ids = object_ids_used
+      combinations = Array.new
+      (1..ids.length).each{|n| ids.combination(n).each{|c| combinations << c}}
+      return combinations
+    end
+    
+    def objects_identifiers_in_rule
+      rule_without_punctuation.split.delete_if{|x| !(thing_id_pattern =~ x)}
+    end
+    
     def expression
       rule_processing_steps
       return final_processed_rule
     end
 
-
-
     def rule_processing_steps
       add_space_around_puctuation_characters
       make_everything_lower_case
@@ -100,6 +125,10 @@ module ArrayLogic
     def reset_processed_rule_ready_for_next_comparison
       @processed_rule = nil
     end
+    
+    def rule_without_punctuation
+      rule.gsub(/[[:punct:]]/, '')
+    end
 
     def check_rule_entered
       raise "You must define a rule before trying to match" unless rule.kind_of? String

data/lib/array_logic/version.rb

@@ -1,3 +1,3 @@
 module ArrayLogic
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/example.rb

@@ -0,0 +1,25 @@
+require_relative 'array_logic'
+
+rule_sets = [
+  "(t1 and t2) or (t3 and t4)",
+  "t1 and not t2",
+  "2 in t1 t2 t3",
+  "(2 in t1 t2 t3) and (1 in t4 t5)"
+]
+
+rule_sets.each do |rule_set|
+  
+  rule = ArrayLogic::Rule.new
+  rule.rule = rule_set
+  
+  puts "----------------------------\n"
+  puts "The rule '#{rule_set}' would match the following:"
+  
+  rule.combinations_that_match.each{|c| puts "\t#{c.inspect}"}
+  
+  puts "\nAnd would not match"
+  
+  rule.combinations_that_do_not_match.each{|c| puts "\t#{c.inspect}"}
+  
+  puts "\n\n"
+end

data/test/array_logic/rule_test.rb

@@ -49,7 +49,7 @@ module ArrayLogic
       assert_no_thing_match([3], @rule)      
     end
     
-    def test_one_or_one_and
+    def test_one_or_one_and_version_two
       @rule.rule = '( t1 or t2 ) and t3'
       assert_no_thing_match([1, 2], @rule)
       assert_thing_match([1, 2, 3], @rule)
@@ -210,5 +210,36 @@ module ArrayLogic
       assert_equal(expected, result)
     end
     
+    def test_match_with_empty_rule
+      @rule.rule = ""
+      things = get_things([1, 2])
+      assert(!@rule.match([things.first]), "Should be no match when rule empty")
+    end
+    
+    def test_matches_with_empty_rule
+      @rule.rule = ""
+      things = get_things([1, 2])
+      assert_equal([], @rule.matches([things.first], [things.last]))
+    end
+    
+    def test_object_ids_used
+      @rule.rule = '(t1 && 1 in t2 t3) || t4'
+      assert_equal([1, 2, 3, 4], @rule.object_ids_used)
+    end
+    
+    def test_combinations_that_match
+      @rule.rule = 't1 or t2'
+      assert_equal([[1], [2], [1,2]], @rule.combinations_that_match)
+      @rule.rule = 't1 and t2'
+      assert_equal([[1,2]], @rule.combinations_that_match)
+    end
+    
+    def test_combinations_that_do_not_match
+      @rule.rule = 't1 or t2'
+      assert_equal([], @rule.combinations_that_do_not_match)
+      @rule.rule = 't1 and t2'
+      assert_equal([[1],[2]], @rule.combinations_that_do_not_match)
+    end
+    
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: array_logic
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-26 00:00:00.000000000 Z
+date: 2012-11-27 00:00:00.000000000 Z
 dependencies: []
 description: Allow a user to define a set of rules, and then test to see if an array
   of object match those rules.
@@ -19,16 +19,17 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/array_logic.rb
-- lib/array_logic/thing.rb
 - lib/array_logic/version.rb
+- lib/array_logic/thing.rb
 - lib/array_logic/rule.rb
+- lib/array_logic.rb
+- lib/example.rb
 - MIT-LICENSE
 - Rakefile
 - README.rdoc
-- test/array_logic/thing_test.rb
-- test/array_logic/rule_test.rb
 - test/array_logic/test_case.rb
+- test/array_logic/rule_test.rb
+- test/array_logic/thing_test.rb
 homepage: https://github.com/reggieb/array_logic
 licenses: []
 post_install_message: 
@@ -54,6 +55,6 @@ signing_key:
 specification_version: 3
 summary: Matches arrays of objects against logical rules.
 test_files:
-- test/array_logic/thing_test.rb
-- test/array_logic/rule_test.rb
 - test/array_logic/test_case.rb
+- test/array_logic/rule_test.rb
+- test/array_logic/thing_test.rb