csv_decision 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 28ed8e5952334ed339cc3bd82c84e554009a9438
-  data.tar.gz: 88b29b7ec01956f7aa57e91121e1c269084c6199
+  metadata.gz: 076055f3dd0219da9a4d8aa3d0032fd26e320741
+  data.tar.gz: 7ed7716a9f1285b7ed86e3134321e08c829ae7e5
 SHA512:
-  metadata.gz: 1baefe11dfe98db1c4c21a937e280378376a48691d8bb801015ad771edc83a9e191cfff20fe76689390bd61da723a9c50414350bca050b8d805e4bae49843e49
-  data.tar.gz: 36053a5784980eb95c763556d843bc975247ea3fd28e658360d594e181a5a5f511d349215c35570a4ba1fe5eb90838b2a5eed24ca8e0e102a086021026b50c7a
+  metadata.gz: b87561c15e01daca109a562f68628b15b6f5d33a725ee527a10ad74d79733e5ffe7a8495735d8a41f18a930a4d906312f566a3c5d22fad182b9d94621a7c141d
+  data.tar.gz: be6922a755c26fea0b3d416ee75729bf76eec40a66d386d664aa4e3944be8f311f95d0bdfb004a314da049e2ebe5f0b39987752ccfbe446f01529f7fd62281ba

data/CHANGELOG.md

@@ -1,9 +1,17 @@
+## v0.0.6, 26 December 2017.
+*Additions*
+- Update YARD documentation.
+
+## v0.0.5, 26 December 2017.
+*Additions*
+- Update YARD documentation.
+
 ## v0.0.4, 26 December 2017.
 *Additions*
 - Adds symbol expressions for input columns.
 - Adds non-string constants for output columns.
 - Support Ruby 2.5.0
-- Include yard documentation.
+- Include YARD documentation.
 
 *Changes*
 - Move `benchmark.rb` to `benchmarks` folder and rename to `rufus_decision.rb`

data/README.md

@@ -7,7 +7,7 @@ CSV Decision
 [![Maintainability](https://api.codeclimate.com/v1/badges/466a6c52e8f6a3840967/maintainability)](https://codeclimate.com/github/bpvickers/csv_decision/maintainability)
 [![License](http://img.shields.io/badge/license-MIT-yellowgreen.svg)](#license)
 
-### CSV based Ruby decision tables (a lightweight Hash transformation gem)
+### CSV based Ruby decision tables
 
 `csv_decision` is a RubyGem for CSV (comma separated values) based 
 [decision tables](https://en.wikipedia.org/wiki/Decision_table). 
@@ -16,47 +16,24 @@ It accepts decision tables implemented as a
 which can then be used to execute complex conditional logic against an input hash, 
 producing a decision as an output hash.
 
-### CSV Decision features
- * Fast decision-time performance (see `benchmark.rb`).
- * In addition to simple string matching, can match common Ruby constants, 
- regular expressions, numeric comparisons and Ruby-style ranges.
- * Can use column symbols in comparisons for guard conditions -- e.g., > :column.
- * Accepts data as a file, CSV string or an array of arrays. (For safety all input data is 
- force encoded to UTF-8, and non-ascii strings are converted to empty strings.)
- * All CSV cells are parsed for correctness, and helpful error messages generated for bad 
- inputs.
- * Either returns the first matching row as a hash, or accumulates all matches as an 
- array of hashes.
- 
-### Planned features
- `csv_decision` is still a work in progress, and will be enhanced to support
- the following features:
- * Input columns may be indexed for faster lookup performance.
- * May use functions in the output columns to formulate the final decision.
- * Input hash values may be conditionally defaulted using a constant or a function call
- * Use of column symbol references or built-in guard functions in the input
- columns for matching.
- * Output columns may use interpolated strings referencing column symbols.
- * May be extended with user-defined Ruby functions for tailored logic.
- * Can use post-match guard conditions to filter the results of multi-row 
- decision output.
- 
- ### Why use `csv_decision`?
- 
- Typical "business logic" is notoriously illogical -- full of corner cases and one-off 
- exceptions. 
- A decision table can capture data-based decisions in a way that comes more naturally 
- to subject matter experts, who typically prefer spreadsheet models. 
- Business logic may then be encapsulated, avoiding the need to write tortuous 
- conditional expressions in Ruby that draw the ire of `rubocop` and its ilk.
- 
- This gem takes its inspiration from 
- [rufus/decision](https://github.com/jmettraux/rufus-decision).
- (That gem is no longer maintained and has issues with execution performance.)
+### Why use `csv_decision`?
+ 
+Typical "business logic" is notoriously illogical -- full of corner cases and one-off 
+exceptions. 
+A decision table can capture data-based decisions in a way that comes more naturally 
+to subject matter experts, who typically prefer spreadsheet models. 
+Business logic may then be encapsulated, avoiding the need to write tortuous 
+conditional expressions in Ruby that draw the ire of `rubocop` and its ilk.
+
+This gem and the examples below take inspiration from 
+[rufus/decision](https://github.com/jmettraux/rufus-decision).
+(However, that gem is no longer maintained and CSV Decision has better 
+decision-time performance for the trade-off of slower table parse times and more memory -- 
+see `benchmarks/rufus_decision.rb`)
  
- ### Installation
+### Installation
  
- To get started, just add `csv_decision` to your `Gemfile`, and then run `bundle`:
+To get started, just add `csv_decision` to your `Gemfile`, and then run `bundle`:
  
  ```ruby
  gem 'csv_decision', '~> 0.0.1'
@@ -67,16 +44,11 @@ producing a decision as an output hash.
  gem install csv_decision
  ```
  
- ### Simple example
- 
- A decision table may be as simple or as complex as you like (although very complex 
- tables defeat the whole purpose). 
- Basic usage will be illustrated by an example taken from:
- https://jmettraux.wordpress.com/2009/04/25/rufus-decision-11-ruby-decision-tables/.
- 
- This example considers two input conditions: `topic` and `region`.
- These are labeled `in`. Certain combinations yield an output value for `team_member`, 
- labeled `out`.
+### Simple example
+  
+This table considers two input conditions: `topic` and `region`.
+These are labeled `in`. Certain combinations yield an output value for `team_member`, 
+labeled `out`.
  
 ```
 in :topic | in :region  | out :team_member
@@ -92,18 +64,18 @@ politics  |             | Henry
           |             | Zach
 ```
  
- When the topic is `finance` and the region is `Europe` the team member `Donald`
- is selected.
- 
- This is a "first match" decision table in that as soon as a match is made execution
- stops and a single output value (hash) is returned. 
- 
- The ordering of rows matters. `Ernest`, who is in charge of `finance` for the rest of 
- the world, except for `America` and `Europe`, *must* come after his colleagues 
- `Charlie` and `Donald`. `Zach` has been placed last, catching all the input combos
- not matching any other row.
- 
- Now for some code.
+When the topic is `finance` and the region is `Europe` the team member `Donald`
+is selected.
+
+This is a "first match" decision table in that as soon as a match is made execution
+stops and a single output value (hash) is returned. 
+
+The ordering of rows matters. `Ernest`, who is in charge of `finance` for the rest of 
+the world, except for `America` and `Europe`, *must* come after his colleagues 
+`Charlie` and `Donald`. `Zach` has been placed last, catching all the input combos
+not matching any other row.
+
+Here it is as code:
  
  ```ruby
   # Valid CSV string
@@ -127,36 +99,48 @@ politics  |             | Henry
   table.decide(topic: 'culture', region: 'America') # team_member: 'Zach'
 ```
  
- An empty `in` cell means "matches any value".
- 
- If you have cloned this gem's git repo, then this example can also be run by loading
- the table from a CSV file:
+An empty `in` cell means "matches any value", even nils.
+
+If you have cloned this gem's git repo, then the example can also be run by loading
+the table from a CSV file:
  
  ```ruby
 table = CSVDecision.parse(Pathname('spec/data/valid/simple_example.csv'))
 ```
  
- We can also load this same table using the option: `first_match: false`.
+ We can also load this same table using the option: `first_match: false`, which means that 
+ all matching rows will be accumulated into an array of hashes.
  
  ```ruby
 table = CSVDecision.parse(data, first_match: false)
 table.decide(topic: 'finance', region: 'Europe') # returns team_member: %w[Donald Ernest Zach] 
 ```
 
+For more examples see `spec/csv_decision/table_spec.rb`. 
+Complete documentation of all table parameters is in the code - see 
+`lib/csv_decision/parse.rb` and `lib/csv_decision/table.rb`.
 
- For more examples see `spec/csv_decision/table_spec.rb`. 
- Complete documentation of all table parameters is in the code - see 
- `lib/csv_decision/parse.rb` and `lib/csv_decision/table.rb`.
- 
- ### Constants other than strings
- Although `csv_decision` is string oriented, it does recognise other types of constant
- present in the input hash. Specifically, the following classes are recognized: 
- `Integer`, `BigDecimal`, `NilClass`, `TrueClass` and `FalseClass`. 
- 
- This is accomplished by prefixing the value with one of the operators `=`, `==` or `:=`. 
- (The syntax is intentionally lax.)
- 
- For example:
+### CSV Decision features
+ * Fast decision-time performance (see `benchmarks` folder).
+ * In addition to simple string matching, can match common Ruby constants, 
+ regular expressions, numeric comparisons and Ruby-style ranges.
+ * Can use column symbols in comparisons for guard conditions -- e.g., > :column.
+ * Accepts data as a file, CSV string or an array of arrays. (For safety all input data is 
+ force encoded to UTF-8, and non-ascii strings are converted to empty strings.)
+ * All CSV cells are parsed for correctness, and helpful error messages generated for bad 
+ inputs.
+ * Either returns the first matching row as a hash, or accumulates all matches as an 
+ array of hashes.
+  
+### Constants other than strings
+Although `csv_decision` is string oriented, it does recognise other types of constant
+present in the input hash. Specifically, the following classes are recognized: 
+`Integer`, `BigDecimal`, `NilClass`, `TrueClass` and `FalseClass`. 
+
+This is accomplished by prefixing the value with one of the operators `=`, `==` or `:=`. 
+(The syntax is intentionally lax.)
+
+For example:
  ```ruby
     data = <<~DATA
       in :constant, out :value
@@ -173,11 +157,11 @@ table.decide(topic: 'finance', region: 'Europe') # returns team_member: %w[Donal
   table.decide(constant: BigDecimal('100.0')) # returns value: BigDecimal('100.0')       
 ```
  
- ### Column header symbols
- All input and output column names are symbolized, and can be used to form simple
- expressions that refer to values in the input hash.
- 
- For example:
+### Column header symbols
+All input and output column names are symbolized, and can be used to form simple
+expressions that refer to values in the input hash.
+
+For example:
  ```ruby
     data = <<~DATA
       in :node, in :parent, out :top?
@@ -190,10 +174,10 @@ table.decide(topic: 'finance', region: 'Europe') # returns team_member: %w[Donal
     table.decide(node: 1, parent: 0) # returns top?: 'no'
  ```
  
- Note that there is no need to include an input column for `:node` in the decision 
- table - it just needs to be present in the input hash. Also, `== :node` can be 
- shortened to just `:node`, so the above decision table may be simplified to:
- 
+Note that there is no need to include an input column for `:node` in the decision 
+table - it just needs to be present in the input hash. Also, `== :node` can be 
+shortened to just `:node`, so the above decision table may be simplified to:
+
  ```ruby
     data = <<~DATA
       in :parent, out :top?
@@ -201,10 +185,32 @@ table.decide(topic: 'finance', region: 'Europe') # returns team_member: %w[Donal
       ,           no
     DATA
  ```
- These comparison operators are also supported: `!=`, `>`, `>=`, `<`, `<=`.
- For more simple examples see `spec/csv_decision/examples_spec.rb`.
- 
- ### Testing
+These comparison operators are also supported: `!=`, `>`, `>=`, `<`, `<=`.
+For more simple examples see `spec/csv_decision/examples_spec.rb`.
+
+### Column guard conditions
+Sometimes it's more convenient to write guard conditions in a single column specialized for that purpose. 
+For example:
+
+```ruby
+data = <<~DATA
+  in :country, guard:,          out :ID, out :ID_type, out :len
+  US,          :CUSIP.present?, :CUSIP,  CUSIP,        :ID.length
+  GB,          :SEDOL.present?, :SEDOL,  SEDOL,        :ID.length
+  ,            :ISIN.present?,  :ISIN,   ISIN,         :ID.length
+  ,            :SEDOL.present?, :SEDOL,  SEDOL,        :ID.length
+  ,            :CUSIP.present?, :CUSIP,  CUSIP,        :ID.length
+  ,            ,                := nil,  := nil,       := nil
+DATA
+
+table = CSVDecision.parse(data)
+table.decide(country: 'US',  CUSIP: '123456789') #=> { ID: '123456789', ID_type: 'CUSIP', len: 9 }
+table.decide(country: 'EU',  CUSIP: '123456789', ISIN:'123456789012') 
+  #=> { ID: '123456789012', ID_type: 'ISIN', len: 12 }
+```
+Guard columns may be anonymous, and must contain non-constant expressions.  
+  
+### Testing
  
  `csv_decision` includes thorough [RSpec](http://rspec.info) tests:
  
@@ -213,3 +219,16 @@ table.decide(topic: 'finance', region: 'Europe') # returns team_member: %w[Donal
  bundle install
  rspec
  ```
+
+### Planned features
+ `csv_decision` is still a work in progress, and will be enhanced to support
+ the following features:
+ * Use of column symbol expressions or built-in guard functions in the input
+ columns for matching.
+ * Input columns may be indexed for faster lookup performance.
+ * May use functions in the output columns to formulate the final decision.
+ * Input hash values may be conditionally defaulted using a constant or a function call
+ * Output columns may use interpolated strings referencing column symbols.
+ * May be extended with a user-supplied library of Ruby functions for tailored logic.
+ * Can use post-match guard conditions to filter the results of multi-row 
+ decision output.

data/benchmarks/rufus_decision.rb

@@ -21,6 +21,14 @@ benchmarks = [
     # Expected results for first_match and accumulate
     first_match: { 'team_member' => 'Zach' },
     accumulate: { 'team_member' => 'Zach' }
+  },
+  {
+    name: 'Regular expressions',
+    data: 'benchmark_regexp.csv',
+    input: { 'age' => '40', 'trait' => 'cheerful' },
+    # Expected results for first_match and accumulate
+    first_match: { 'salesperson' => 'Swanson' },
+    accumulate: { 'salesperson' => %w[Swanson Korolev] }
   }
 ].deep_freeze
 
@@ -37,7 +45,7 @@ puts ""
   puts '-' * tag_width
 
   csv_options = CSV_OPTIONS.merge(first_match: first_match)
-  rufus_options = RUFUS_OPTIONS.merge(first_match: first_match)
+  rufus_options = RUFUS_OPTIONS.merge(first_match: first_match, accumulate: !first_match)
 
   benchmarks.each do |test|
     name = test[:name]

data/csv_decision.gemspec

@@ -5,14 +5,14 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'csv_decision'
-  spec.version       = '0.0.6'
+  spec.version       = '0.0.7'
   spec.authors       = ['Brett Vickers']
   spec.email         = ['brett@phillips-vickers.com']
   spec.description   = 'CSV based Ruby decision tables.'
   spec.summary       = <<-DESC
-    CSV Decision implements CSV file based Ruby decision tables.  It accepts decision tables implemented as a 
-    which can then be used to execute complex conditional logic against an input hash, 
-    producing a decision as an output hash.
+    CSV Decision implements CSV based Ruby decision tables. It parses and loads 
+    decision table files which can then be used to execute complex conditional 
+    logic against an input hash, producing a decision as an output hash.
     DESC
   spec.homepage      = 'https://github.com/bpvickers/csv_decision.git'
   spec.license       = 'MIT'
@@ -25,8 +25,8 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.3.0'
 
   spec.add_dependency 'activesupport', '~> 5.1'
-  spec.add_dependency 'ice_nine', '~> 0.11'
-  spec.add_dependency 'values', '~> 1.8'
+  spec.add_dependency 'ice_nine',      '~> 0.11'
+  spec.add_dependency 'values',        '~> 1.8'
 
   spec.add_development_dependency 'benchmark-ips',         '~> 2.7'
   spec.add_development_dependency 'benchmark-memory',      '~> 0.1'

data/doc/CSVDecision.html

@@ -79,7 +79,7 @@
   <dl>
     <dt>Defined in:</dt>
     <dd>lib/csv_decision.rb<span class="defines">,<br />
-  lib/csv_decision/data.rb,<br /> lib/csv_decision/load.rb,<br /> lib/csv_decision/input.rb,<br /> lib/csv_decision/parse.rb,<br /> lib/csv_decision/table.rb,<br /> lib/csv_decision/decide.rb,<br /> lib/csv_decision/header.rb,<br /> lib/csv_decision/symbol.rb,<br /> lib/csv_decision/columns.rb,<br /> lib/csv_decision/numeric.rb,<br /> lib/csv_decision/options.rb,<br /> lib/csv_decision/constant.rb,<br /> lib/csv_decision/decision.rb,<br /> lib/csv_decision/function.rb,<br /> lib/csv_decision/matchers.rb,<br /> lib/csv_decision/scan_row.rb,<br /> lib/csv_decision/matchers/range.rb,<br /> lib/csv_decision/matchers/symbol.rb,<br /> lib/csv_decision/matchers/numeric.rb,<br /> lib/csv_decision/matchers/pattern.rb,<br /> lib/csv_decision/matchers/constant.rb,<br /> lib/csv_decision/matchers/function.rb</span>
+  lib/csv_decision/data.rb,<br /> lib/csv_decision/load.rb,<br /> lib/csv_decision/input.rb,<br /> lib/csv_decision/parse.rb,<br /> lib/csv_decision/table.rb,<br /> lib/csv_decision/decide.rb,<br /> lib/csv_decision/header.rb,<br /> lib/csv_decision/columns.rb,<br /> lib/csv_decision/options.rb,<br /> lib/csv_decision/decision.rb,<br /> lib/csv_decision/matchers.rb,<br /> lib/csv_decision/scan_row.rb,<br /> lib/csv_decision/matchers/guard.rb,<br /> lib/csv_decision/matchers/range.rb,<br /> lib/csv_decision/matchers/symbol.rb,<br /> lib/csv_decision/matchers/numeric.rb,<br /> lib/csv_decision/matchers/pattern.rb,<br /> lib/csv_decision/matchers/constant.rb,<br /> lib/csv_decision/matchers/function.rb</span>
 </dd>
   </dl>
   
@@ -88,20 +88,36 @@
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
     
-<p>CSV Decision: CSV based Ruby decision tables. Created December 2017 by
-Brett Vickers See LICENSE and README.md for details.</p>
+<p>CSV Decision: CSV based Ruby decision tables. Created December 2017. See
+LICENSE and README.md for details.</p>
 
 
   </div>
 </div>
 <div class="tags">
   
+<p class="tag_title">Author:</p>
+<ul class="author">
+  
+    <li>
+      
+      
+      
+      
+        
+        <div class='inline'>
+<p>Brett Vickers &lt;brett@phillips-vickers.com&gt;</p>
+</div>
+      
+    </li>
+  
+</ul>
 
 </div><h2>Defined Under Namespace</h2>
 <p class="children">
   
     
-      <strong class="modules">Modules:</strong> <span class='object_link'><a href="CSVDecision/Constant.html" title="CSVDecision::Constant (module)">Constant</a></span>, <span class='object_link'><a href="CSVDecision/Data.html" title="CSVDecision::Data (module)">Data</a></span>, <span class='object_link'><a href="CSVDecision/Decide.html" title="CSVDecision::Decide (module)">Decide</a></span>, <span class='object_link'><a href="CSVDecision/Function.html" title="CSVDecision::Function (module)">Function</a></span>, <span class='object_link'><a href="CSVDecision/Header.html" title="CSVDecision::Header (module)">Header</a></span>, <span class='object_link'><a href="CSVDecision/Input.html" title="CSVDecision::Input (module)">Input</a></span>, <span class='object_link'><a href="CSVDecision/Load.html" title="CSVDecision::Load (module)">Load</a></span>, <span class='object_link'><a href="CSVDecision/Numeric.html" title="CSVDecision::Numeric (module)">Numeric</a></span>, <span class='object_link'><a href="CSVDecision/Options.html" title="CSVDecision::Options (module)">Options</a></span>, <span class='object_link'><a href="CSVDecision/Parse.html" title="CSVDecision::Parse (module)">Parse</a></span>, <span class='object_link'><a href="CSVDecision/Symbol.html" title="CSVDecision::Symbol (module)">Symbol</a></span>
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="CSVDecision/Data.html" title="CSVDecision::Data (module)">Data</a></span>, <span class='object_link'><a href="CSVDecision/Decide.html" title="CSVDecision::Decide (module)">Decide</a></span>, <span class='object_link'><a href="CSVDecision/Header.html" title="CSVDecision::Header (module)">Header</a></span>, <span class='object_link'><a href="CSVDecision/Input.html" title="CSVDecision::Input (module)">Input</a></span>, <span class='object_link'><a href="CSVDecision/Load.html" title="CSVDecision::Load (module)">Load</a></span>, <span class='object_link'><a href="CSVDecision/Options.html" title="CSVDecision::Options (module)">Options</a></span>, <span class='object_link'><a href="CSVDecision/Parse.html" title="CSVDecision::Parse (module)">Parse</a></span>
     
   
     
@@ -110,75 +126,6 @@ Brett Vickers See LICENSE and README.md for details.</p>
   
 </p>
 
-  <h2>Constant Summary</h2>
-  <dl class="constants">
-    
-      <dt id="COMMENT_CHARACTER-constant" class="">COMMENT_CHARACTER =
-        
-      </dt>
-      <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>#</span><span class='tstring_end'>&#39;</span></span></pre></dd>
-    
-      <dt id="DEFAULT_MATCHERS-constant" class="">DEFAULT_MATCHERS =
-        <div class="docstring">
-  <div class="discussion">
-    
-<p>Specialized cell value matchers beyond simple string compares. By default
-all these matchers are tried in the specified order.</p>
-
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-      </dt>
-      <dd><pre class="code"><span class='lbracket'>[</span>
-  <span class='const'><span class='object_link'><a href="CSVDecision/Matchers.html" title="CSVDecision::Matchers (class)">Matchers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="CSVDecision/Matchers/Range.html" title="CSVDecision::Matchers::Range (class)">Range</a></span></span><span class='comma'>,</span>
-  <span class='const'><span class='object_link'><a href="CSVDecision/Matchers.html" title="CSVDecision::Matchers (class)">Matchers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="CSVDecision/Matchers/Numeric.html" title="CSVDecision::Matchers::Numeric (class)">Numeric</a></span></span><span class='comma'>,</span>
-  <span class='const'><span class='object_link'><a href="CSVDecision/Matchers.html" title="CSVDecision::Matchers (class)">Matchers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="CSVDecision/Matchers/Pattern.html" title="CSVDecision::Matchers::Pattern (class)">Pattern</a></span></span><span class='comma'>,</span>
-  <span class='const'><span class='object_link'><a href="CSVDecision/Matchers.html" title="CSVDecision::Matchers (class)">Matchers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="CSVDecision/Matchers/Constant.html" title="CSVDecision::Matchers::Constant (class)">Constant</a></span></span><span class='comma'>,</span>
-  <span class='const'><span class='object_link'><a href="CSVDecision/Matchers.html" title="CSVDecision::Matchers (class)">Matchers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="CSVDecision/Matchers/Symbol.html" title="CSVDecision::Matchers::Symbol (class)">Symbol</a></span></span>
-  <span class='comment'># Matchers::Function
-</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
-    
-      <dt id="OUTS_MATCHERS-constant" class="">OUTS_MATCHERS =
-        <div class="docstring">
-  <div class="discussion">
-    
-<p>Subset of matchers that apply to output cells</p>
-
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-      </dt>
-      <dd><pre class="code"><span class='lbracket'>[</span>
-  <span class='const'><span class='object_link'><a href="CSVDecision/Matchers.html" title="CSVDecision::Matchers (class)">Matchers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="CSVDecision/Matchers/Constant.html" title="CSVDecision::Matchers::Constant (class)">Constant</a></span></span>
-<span class='comment'># Matchers::Function
-</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
-    
-      <dt id="Proc-constant" class="">Proc =
-        <div class="docstring">
-  <div class="discussion">
-    
-<p>Value object for a cell proc.</p>
-
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-      </dt>
-      <dd><pre class="code"><span class='const'>Value</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='symbol'>:type</span><span class='comma'>,</span> <span class='symbol'>:function</span><span class='rparen'>)</span></pre></dd>
-    
-  </dl>
-
 
 
 
@@ -306,9 +253,8 @@ CSV string or an array of arrays.</p>
       
       
         &mdash;
-        <div class='inline'><ul><li>
-<p>directiory containing CSV files</p>
-</li></ul>
+        <div class='inline'>
+<p>Directory containing CSV files.</p>
 </div>
       
     </li>
@@ -325,9 +271,8 @@ CSV string or an array of arrays.</p>
       
       
         &mdash;
-        <div class='inline'><ul><li>
-<p>supplied options hash for table creation</p>
-</li></ul>
+        <div class='inline'>
+<p>Options hash used for table creation.</p>
 </div>
       
     </li>
@@ -344,6 +289,24 @@ CSV string or an array of arrays.</p>
       
       
       
+    </li>
+  
+</ul>
+<p class="tag_title">Raises:</p>
+<ul class="raise">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>ArgumentError</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>Invalid folder.</p>
+</div>
+      
     </li>
   
 </ul>
@@ -354,12 +317,12 @@ CSV string or an array of arrays.</p>
       <pre class="lines">
 
 
-12
-13
-14</pre>
+14
+15
+16</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/csv_decision/load.rb', line 12</span>
+      <pre class="code"><span class="info file"># File 'lib/csv_decision/load.rb', line 14</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_load'>load</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="CSVDecision/Load.html" title="CSVDecision::Load (module)">Load</a></span></span><span class='period'>.</span><span class='id identifier rubyid_path'><span class='object_link'><a href="CSVDecision/Load.html#path-class_method" title="CSVDecision::Load.path (method)">path</a></span></span><span class='lparen'>(</span><span class='label'>path:</span> <span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>options:</span> <span class='id identifier rubyid_options'>options</span><span class='rparen'>)</span>
@@ -398,7 +361,8 @@ CSV string or an array of arrays.</p>
 </div></p>
       
       <pre class="example code"><code>If you have cloned the gem&#39;s git repo, then you can run:
-table = CSVDecision.parse(Pathname(&#39;spec/data/valid/simple_example.csv&#39;)) #=&gt; CSVDecision::Table
+table = CSVDecision.parse(Pathname(&#39;spec/data/valid/simple_example.csv&#39;))
+  #=&gt; CSVDecision::Table
 table.decide(topic: &#39;finance&#39;, region: &#39;Europe&#39;) #=&gt; team_member: &#39;Donald&#39;</code></pre>
     
   </div>
@@ -457,7 +421,7 @@ table.decide(topic: &#39;finance&#39;, region: &#39;Europe&#39;) #=&gt; team_mem
           </span>
           
             &mdash; <div class='inline'>
-<p>Stop scanning after find the first row match.</p>
+<p>Stop scanning after finding the first row match.</p>
 </div>
           
         </li>
@@ -563,12 +527,12 @@ table.decide(topic: &#39;finance&#39;, region: &#39;Europe&#39;) #=&gt; team_mem
       <pre class="lines">
 
 
-41
-42
-43</pre>
+46
+47
+48</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/csv_decision/parse.rb', line 41</span>
+      <pre class="code"><span class="info file"># File 'lib/csv_decision/parse.rb', line 46</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="CSVDecision/Parse.html" title="CSVDecision::Parse (module)">Parse</a></span></span><span class='period'>.</span><span class='id identifier rubyid_table'><span class='object_link'><a href="CSVDecision/Parse.html#table-class_method" title="CSVDecision::Parse.table (method)">table</a></span></span><span class='lparen'>(</span><span class='label'>data:</span> <span class='id identifier rubyid_data'>data</span><span class='comma'>,</span> <span class='label'>options:</span> <span class='const'><span class='object_link'><a href="CSVDecision/Options.html" title="CSVDecision::Options (module)">Options</a></span></span><span class='period'>.</span><span class='id identifier rubyid_normalize'><span class='object_link'><a href="CSVDecision/Options.html#normalize-class_method" title="CSVDecision::Options.normalize (method)">normalize</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_options'>options</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -642,7 +606,7 @@ table.decide(topic: &#39;finance&#39;, region: &#39;Europe&#39;) #=&gt; team_mem
 </div>
 
       <div id="footer">
-  Generated on Tue Dec 26 21:20:19 2017 by
+  Generated on Sat Dec 30 13:04:04 2017 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.12 (ruby-2.3.0).
 </div>