csv_decision 0.3.1 → 0.3.2

data/doc/method_list.html

@@ -246,7 +246,7 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Result.html#final-instance_method" title="CSVDecision::Result#final (method)">#final</a></span>
+      <span class='object_link'><a href="CSVDecision/Result.html#final_result-instance_method" title="CSVDecision::Result#final_result (method)">#final_result</a></span>
       <small>CSVDecision::Result</small>
     </div>
   </li>
@@ -318,7 +318,7 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Decision.html#index-instance_method" title="CSVDecision::Decision#index (method)">#index</a></span>
+      <span class='object_link'><a href="CSVDecision/Decision.html#index_scan-instance_method" title="CSVDecision::Decision#index_scan (method)">#index_scan</a></span>
       <small>CSVDecision::Decision</small>
     </div>
   </li>
@@ -334,16 +334,16 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Result.html#initialize-instance_method" title="CSVDecision::Result#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Result</small>
+      <span class='object_link'><a href="CSVDecision/Columns.html#initialize-instance_method" title="CSVDecision::Columns#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Columns</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Table.html#initialize-instance_method" title="CSVDecision::Table#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Table</small>
+      <span class='object_link'><a href="CSVDecision/ScanRow.html#initialize-instance_method" title="CSVDecision::ScanRow#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::ScanRow</small>
     </div>
   </li>
   
@@ -358,80 +358,80 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Columns/Dictionary.html#initialize-instance_method" title="CSVDecision::Columns::Dictionary#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Columns::Dictionary</small>
+      <span class='object_link'><a href="CSVDecision/Decision.html#initialize-instance_method" title="CSVDecision::Decision#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Decision</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers.html#initialize-instance_method" title="CSVDecision::Matchers#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Matchers</small>
+      <span class='object_link'><a href="CSVDecision/Columns/Dictionary.html#initialize-instance_method" title="CSVDecision::Columns::Dictionary#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Columns::Dictionary</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Pattern.html#initialize-instance_method" title="CSVDecision::Matchers::Pattern#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Matchers::Pattern</small>
+      <span class='object_link'><a href="CSVDecision/Matchers.html#initialize-instance_method" title="CSVDecision::Matchers#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Matchers</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Columns.html#initialize-instance_method" title="CSVDecision::Columns#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Columns</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Pattern.html#initialize-instance_method" title="CSVDecision::Matchers::Pattern#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Matchers::Pattern</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Index.html#initialize-instance_method" title="CSVDecision::Index#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Index</small>
+      <span class='object_link'><a href="CSVDecision/Result.html#initialize-instance_method" title="CSVDecision::Result#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Result</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Decision.html#initialize-instance_method" title="CSVDecision::Decision#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Decision</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Matcher.html#initialize-instance_method" title="CSVDecision::Matchers::Matcher#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Matchers::Matcher</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Matcher.html#initialize-instance_method" title="CSVDecision::Matchers::Matcher#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Matchers::Matcher</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Proc.html#initialize-instance_method" title="CSVDecision::Matchers::Proc#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Matchers::Proc</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Proc.html#initialize-instance_method" title="CSVDecision::Matchers::Proc#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Matchers::Proc</small>
+      <span class='object_link'><a href="CSVDecision/Table.html#initialize-instance_method" title="CSVDecision::Table#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Table</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Function.html#initialize-instance_method" title="CSVDecision::Matchers::Function#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::Matchers::Function</small>
+      <span class='object_link'><a href="CSVDecision/Index.html#initialize-instance_method" title="CSVDecision::Index#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Index</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/ScanRow.html#initialize-instance_method" title="CSVDecision::ScanRow#initialize (method)">#initialize</a></span>
-      <small>CSVDecision::ScanRow</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Function.html#initialize-instance_method" title="CSVDecision::Matchers::Function#initialize (method)">#initialize</a></span>
+      <small>CSVDecision::Matchers::Function</small>
     </div>
   </li>
   
@@ -534,16 +534,16 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Guard.html#matches%3F-class_method" title="CSVDecision::Matchers::Guard.matches? (method)">matches?</a></span>
-      <small>CSVDecision::Matchers::Guard</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Constant.html#matches%3F-class_method" title="CSVDecision::Matchers::Constant.matches? (method)">matches?</a></span>
+      <small>CSVDecision::Matchers::Constant</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Constant.html#matches%3F-instance_method" title="CSVDecision::Matchers::Constant#matches? (method)">#matches?</a></span>
-      <small>CSVDecision::Matchers::Constant</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Guard.html#matches%3F-class_method" title="CSVDecision::Matchers::Guard.matches? (method)">matches?</a></span>
+      <small>CSVDecision::Matchers::Guard</small>
     </div>
   </li>
   
@@ -574,47 +574,47 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Matcher.html#matches%3F-instance_method" title="CSVDecision::Matchers::Matcher#matches? (method)">#matches?</a></span>
-      <small>CSVDecision::Matchers::Matcher</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Symbol.html#matches%3F-class_method" title="CSVDecision::Matchers::Symbol.matches? (method)">matches?</a></span>
+      <small>CSVDecision::Matchers::Symbol</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Function.html#matches%3F-class_method" title="CSVDecision::Matchers::Function.matches? (method)">matches?</a></span>
-      <small>CSVDecision::Matchers::Function</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Symbol.html#matches%3F-instance_method" title="CSVDecision::Matchers::Symbol#matches? (method)">#matches?</a></span>
+      <small>CSVDecision::Matchers::Symbol</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Constant.html#matches%3F-class_method" title="CSVDecision::Matchers::Constant.matches? (method)">matches?</a></span>
-      <small>CSVDecision::Matchers::Constant</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Numeric.html#matches%3F-class_method" title="CSVDecision::Matchers::Numeric.matches? (method)">matches?</a></span>
+      <small>CSVDecision::Matchers::Numeric</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Pattern.html#matches%3F-instance_method" title="CSVDecision::Matchers::Pattern#matches? (method)">#matches?</a></span>
-      <small>CSVDecision::Matchers::Pattern</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Numeric.html#matches%3F-instance_method" title="CSVDecision::Matchers::Numeric#matches? (method)">#matches?</a></span>
+      <small>CSVDecision::Matchers::Numeric</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Symbol.html#matches%3F-class_method" title="CSVDecision::Matchers::Symbol.matches? (method)">matches?</a></span>
-      <small>CSVDecision::Matchers::Symbol</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Pattern.html#matches%3F-class_method" title="CSVDecision::Matchers::Pattern.matches? (method)">matches?</a></span>
+      <small>CSVDecision::Matchers::Pattern</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Pattern.html#matches%3F-class_method" title="CSVDecision::Matchers::Pattern.matches? (method)">matches?</a></span>
+      <span class='object_link'><a href="CSVDecision/Matchers/Pattern.html#matches%3F-instance_method" title="CSVDecision::Matchers::Pattern#matches? (method)">#matches?</a></span>
       <small>CSVDecision::Matchers::Pattern</small>
     </div>
   </li>
@@ -622,32 +622,32 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Symbol.html#matches%3F-instance_method" title="CSVDecision::Matchers::Symbol#matches? (method)">#matches?</a></span>
-      <small>CSVDecision::Matchers::Symbol</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Constant.html#matches%3F-instance_method" title="CSVDecision::Matchers::Constant#matches? (method)">#matches?</a></span>
+      <small>CSVDecision::Matchers::Constant</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Numeric.html#matches%3F-class_method" title="CSVDecision::Matchers::Numeric.matches? (method)">matches?</a></span>
-      <small>CSVDecision::Matchers::Numeric</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Function.html#matches%3F-class_method" title="CSVDecision::Matchers::Function.matches? (method)">matches?</a></span>
+      <small>CSVDecision::Matchers::Function</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Numeric.html#matches%3F-instance_method" title="CSVDecision::Matchers::Numeric#matches? (method)">#matches?</a></span>
-      <small>CSVDecision::Matchers::Numeric</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Function.html#matches%3F-instance_method" title="CSVDecision::Matchers::Function#matches? (method)">#matches?</a></span>
+      <small>CSVDecision::Matchers::Function</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="CSVDecision/Matchers/Function.html#matches%3F-instance_method" title="CSVDecision::Matchers::Function#matches? (method)">#matches?</a></span>
-      <small>CSVDecision::Matchers::Function</small>
+      <span class='object_link'><a href="CSVDecision/Matchers/Matcher.html#matches%3F-instance_method" title="CSVDecision::Matchers::Matcher#matches? (method)">#matches?</a></span>
+      <small>CSVDecision::Matchers::Matcher</small>
     </div>
   </li>
   
@@ -909,14 +909,6 @@
   
 
   <li class="odd ">
-    <div class="item">
-      <span class='object_link'><a href="CSVDecision/Decision.html#scan-instance_method" title="CSVDecision::Decision#scan (method)">#scan</a></span>
-      <small>CSVDecision::Decision</small>
-    </div>
-  </li>
-  
-
-  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/ScanRow.html#scan_columns-instance_method" title="CSVDecision::ScanRow#scan_columns (method)">#scan_columns</a></span>
       <small>CSVDecision::ScanRow</small>
@@ -924,7 +916,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Table.html#scan_rows-instance_method" title="CSVDecision::Table#scan_rows (method)">#scan_rows</a></span>
       <small>CSVDecision::Table</small>
@@ -932,7 +924,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Dictionary/Entry.html#set_if-instance_method" title="CSVDecision::Dictionary::Entry#set_if (method)">#set_if</a></span>
       <small>CSVDecision::Dictionary::Entry</small>
@@ -940,7 +932,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Data.html#strip_columns-class_method" title="CSVDecision::Data.strip_columns (method)">strip_columns</a></span>
       <small>CSVDecision::Data</small>
@@ -948,7 +940,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Header.html#strip_empty_columns-class_method" title="CSVDecision::Header.strip_empty_columns (method)">strip_empty_columns</a></span>
       <small>CSVDecision::Header</small>
@@ -956,7 +948,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Matchers/Proc.html#symbols-instance_method" title="CSVDecision::Matchers::Proc#symbols (method)">#symbols</a></span>
       <small>CSVDecision::Matchers::Proc</small>
@@ -964,7 +956,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Parse.html#table-class_method" title="CSVDecision::Parse.table (method)">table</a></span>
       <small>CSVDecision::Parse</small>
@@ -972,6 +964,14 @@
   </li>
   
 
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="CSVDecision/Decision.html#table_scan-instance_method" title="CSVDecision::Decision#table_scan (method)">#table_scan</a></span>
+      <small>CSVDecision::Decision</small>
+    </div>
+  </li>
+  
+
   <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="CSVDecision/Data.html#to_array-class_method" title="CSVDecision::Data.to_array (method)">to_array</a></span>

data/doc/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sun Jan 21 08:56:46 2018 by
+  Generated on Sun Jan 28 11:58:37 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.12 (ruby-2.4.0).
 </div>

data/lib/csv_decision/decision.rb

@@ -12,21 +12,19 @@ module CSVDecision
     #
     # @param table [CSVDecision::Table] Decision table.
     # @param input [Hash] Input hash (keys may or may not be symbolized)
-    # @param symbolize_keys [true, false] Set to false if keys are symbolized and it's
+    # @param symbolize_keys [Boolean] Set to false if keys are symbolized and it's
     #   OK to mutate the input hash. Otherwise a copy of the input hash is symbolized.
-    # @return [Hash] Decision result.
+    # @return [Hash{Symbol=>Object}] Decision result.
     def self.make(table:, input:, symbolize_keys:)
       # Parse and transform the hash supplied as input
       input = Input.parse(table: table, input: input, symbolize_keys: symbolize_keys)
 
       # The decision object collects the results of the search and
       # calculates the final result
-      decision = Decision.new(table: table, input: input[:hash])
+      decision = Decision.new(table: table, input: input)
 
       # Use the table's index if present
-      return decision.index(table: table, input: input) if table.index
-
-      decision.scan(table: table, hash: input[:hash], scan_cols: input[:scan_cols])
+      table.index ? decision.index_scan : decision.table_scan
     end
 
     # @param table [CSVDecision::Table] Decision table being processed.
@@ -34,63 +32,65 @@ module CSVDecision
     def initialize(table:, input:)
       # The result object is a hash of values, and each value will be an array if this is
       # a multi-row result for the +first_match: false+ option.
-      @result = Result.new(table: table, input: input)
+      @result = Result.new(table: table, input: input[:hash])
 
       # All rows picked by the matching process. An array if +first_match: false+,
       # otherwise a single row.
       @rows_picked = []
 
       @first_match = table.options[:first_match]
+
+      @table = table
+      @input = input
     end
 
     # Scan the decision table up against the input hash.
     #
-    # @param table (see #initialize)
-    # @param hash [Hash] Input hash.
-    # @param scan_cols [Hash{Index=>Object}] Input column values to scan.
     # @return [Hash{Symbol=>Object}] Decision result.
-    def scan(table:, hash:, scan_cols:)
-      return scan_first_match(table: table, hash: hash, scan_cols: scan_cols) if @first_match
-      scan_accumulate(table: table, hash: hash, scan_cols: scan_cols)
+    def table_scan
+      hash = @input[:hash]
+      scan_cols = @input[:scan_cols]
+
+      if @first_match
+        scan_first_match(hash: hash, scan_cols: scan_cols)
+      else
+        scan_accumulate(hash: hash, scan_cols: scan_cols)
+      end
     end
 
     # Use an index to scan the decision table up against the input hash.
     #
-    # @param (see #initialize)
-    # @param input [Hash] Hash of parsed input data.
-    # @return [{Symbol=>Object}] Decision result.
-    def index(table:, input:)
-      # If the index lookup fails, there's no match
-      return {} unless (index_rows = table.index.hash[input[:key]])
+    # @return [Hash{Symbol=>Object}] Decision result.
+    def index_scan
+      # If the index lookup fails, there's no match.
+      return {} unless (index_rows = Array(@table.index.hash[@input[:key]]))
+
+      hash = @input[:hash]
+      scan_cols = @input[:scan_cols]
 
       if @first_match
-        index_scan_first_match(table: table,
-                               scan_cols: input[:scan_cols],
-                               hash: input[:hash],
-                               index_rows: Array(index_rows))
+        index_scan_first_match(scan_cols: scan_cols, hash: hash, index_rows: index_rows)
       else
-        index_scan_accumulate(table: table,
-                              scan_cols: input[:scan_cols],
-                              hash: input[:hash],
-                              index_rows: Array(index_rows))
+        index_scan_accumulate(scan_cols: scan_cols, hash: hash, index_rows: index_rows)
       end
     end
 
     private
 
-    def scan_first_match(table:, hash:, scan_cols:)
-      table.each do |row, index|
-        next unless table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
+    def scan_first_match(hash:, scan_cols:)
+      @table.each do |row, index|
+        next unless @table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
 
-        return @result.attributes if first_match(row)
+        return @result.attributes if first_match_found(row)
       end
 
       {}
     end
 
-    def scan_accumulate(table:, hash:, scan_cols:)
-      table.each do |row, index|
-        next unless table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
+    def scan_accumulate(hash:, scan_cols:)
+      @table.each do |row, index|
+        next unless @table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
+
         # Accumulate output rows
         @rows_picked << row
         @result.accumulate_outs(row)
@@ -99,22 +99,24 @@ module CSVDecision
       @rows_picked.empty? ? {} : accumulated_result
     end
 
-    def index_scan_first_match(table:, scan_cols:, hash:, index_rows:)
+    def index_scan_first_match(scan_cols:, hash:, index_rows:)
       index_rows.each do |start_row, end_row|
-        table.each(start_row, end_row || start_row) do |row, index|
-          next unless table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
-          return @result.attributes if first_match(row)
+        @table.each(start_row, end_row || start_row) do |row, index|
+          next unless @table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
+
+          return @result.attributes if first_match_found(row)
         end
       end
 
       {}
     end
 
-    def index_scan_accumulate(table:, scan_cols:, hash:, index_rows:)
+    def index_scan_accumulate(scan_cols:, hash:, index_rows:)
       index_rows.each do |start_row, end_row|
-        table.each(start_row, end_row || start_row) do |row, index|
-          next unless table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
-          # Accumulate output rows
+        @table.each(start_row, end_row || start_row) do |row, index|
+          next unless @table.scan_rows[index].match?(row: row, hash: hash, scan_cols: scan_cols)
+
+          # Accumulate output rows.
           @rows_picked << row
           @result.accumulate_outs(row)
         end
@@ -124,7 +126,7 @@ module CSVDecision
     end
 
     def accumulated_result
-      return @result.final unless @result.outs_functions
+      return @result.final_result unless @result.outs_functions
       return @result.eval_outs(@rows_picked.first) unless @result.multi_result
 
       multi_row_result
@@ -134,7 +136,7 @@ module CSVDecision
       # Scan each output column that contains functions
       @result.outs.each_pair { |col, column| eval_procs(col: col, column: column) if column.eval }
 
-      @result.final
+      @result.final_result
     end
 
     def eval_procs(col:, column:)
@@ -147,7 +149,7 @@ module CSVDecision
       end
     end
 
-    def first_match(row)
+    def first_match_found(row)
       # This decision row may contain procs, which if present will need to be evaluated.
       # If this row contains if: columns then this row may be filtered out, in which case
       # this method call will return false.

data/lib/csv_decision/load.rb

@@ -7,10 +7,11 @@
 module CSVDecision
   # Load all the CSV files located in the designated folder path.
   #
-  # @param path [Pathname] Directory containing CSV files.
-  # @param options [Hash] Options hash used for table creation.
-  # @return [Hash<CSVDecision::Table>]
-  # @raise [ArgumentError] Invalid folder.
+  # @param path [Pathname] Directory containing CSV decision table files.
+  # @param options (see CSVDecision.parse)
+  # @return [Hash{Symbol=><CSVDecision::Table>}] Hash of decision tables keyed by the CSV
+  #   file's symbolized base name.
+  # @raise [ArgumentError] Invalid path name or folder.
   def self.load(path, options = {})
     Load.path(path: path, options: options)
   end

data/lib/csv_decision/parse.rb

@@ -28,7 +28,7 @@ module CSVDecision
   #
   # @param data [Pathname, File, Array<Array<String>>, String] input data given as
   #   a CSV file, array of arrays or CSV string.
-  # @param options [Hash] Options hash supplied by the user.
+  # @param options [Hash{Symbol=>Object}] Options hash controlling how the table is parsed and interpreted.
   #
   # @option options [Boolean] :first_match Stop scanning after finding the first row match.
   # @option options [Boolean] :regexp_implicit Make regular expressions implicit rather than

data/lib/csv_decision/result.rb

@@ -54,8 +54,8 @@ module CSVDecision
     end
 
     # Derive the final result.
-    # @return [{Symbol=>Object}]
-    def final
+    # @return [Hash{Symbol=>Object}]
+    def final_result
       # If there are no if: columns, then nothing needs to be filtered out of this result hash.
       return @attributes if @if_columns.empty?
 
@@ -74,7 +74,7 @@ module CSVDecision
       # Then evaluate the procs, left to right
       eval_outs_procs(row: row)
 
-      final
+      final_result
     end
 
     # Evaluate the cell proc using the partial result calculated so far.

data/lib/csv_decision/scan_row.rb

@@ -109,9 +109,8 @@ module CSVDecision
       # Check any table row cell constants first, and maybe fail fast...
       return false if @constants.any? { |col| row[col] != scan_cols[col] }
 
-      return true if @procs.empty?
-
-      # These table row cells are Proc objects which need evaluating
+      # These table row cells are Proc objects which need evaluating and
+      # must all return a truthy value.
       @procs.all? { |col| row[col].call(value: scan_cols[col], hash: hash) }
     end
 
@@ -121,14 +120,14 @@ module CSVDecision
       # Scan the cell against all the matchers
       proc = ScanRow.scan(column: column, matchers: matchers, cell: cell)
 
-      return set(proc, col, column) if proc
+      return set(proc: proc, col: col, column: column) if proc
 
       # Just a plain constant
       @constants << col
       cell
     end
 
-    def set(proc, col, column)
+    def set(proc:, col:, column:)
       # Unbox a constant
       if proc.type == :constant
         @constants << col

data/lib/csv_decision/table.rb

@@ -77,6 +77,10 @@ module CSVDecision
 
     # @api private
     def initialize
+      @file = nil
+      @index = nil
+      @options = nil
+      @outs_functions = nil
       @outs_rows = []
       @if_rows = []
       @rows = []

data/spec/csv_decision/table_spec.rb

@@ -496,6 +496,7 @@ describe CSVDecision::Table do
         { example: 'evaluates single-column index CSV string',
           options: { first_match: false },
           data: <<~DATA
+            text_only
             in:topic, in:region, out:team_member
             sports,   Europe,    Alice
             sports,   ,          Bob

data/spec/data/valid/index_example.csv

@@ -1,3 +1,4 @@
+text_only
 in:topic,in:region,out:team_member
 sports,Europe,Alice
 sports,,Bob