Class: CSVDecision::Matchers Private

Inherits:
Object
  • Object
show all
Defined in:
lib/csv_decision/matchers.rb,
lib/csv_decision.rb,
lib/csv_decision/matchers/guard.rb,
lib/csv_decision/matchers/range.rb,
lib/csv_decision/matchers/symbol.rb,
lib/csv_decision/matchers/numeric.rb,
lib/csv_decision/matchers/pattern.rb,
lib/csv_decision/matchers/constant.rb,
lib/csv_decision/matchers/function.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Methods to assign a matcher to data cells

Defined Under Namespace

Classes: Constant, Function, Guard, Matcher, Numeric, Pattern, Proc, Range, Symbol

Constant Summary collapse

NEGATE =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Negation sign prefixed to ranges and functions.

'!'
EQUALS =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Cell constants and functions specified by prefixing the value with one of these 3 symbols.

'==|:=|='
NUMERIC =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Regular expression used to recognise a numeric string with or without a decimal point.

'[-+]?\d*(?<decimal>\.?)\d*'

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options) ⇒ Matchers

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Matchers.

Parameters:

  • options (Hash{Symbol=>Object}) —

    Options hash controlling how the table is parsed and interpreted.



143
144
145
146
147
 
# File 'lib/csv_decision/matchers.rb', line 143

def initialize(options)
  matchers = options[:matchers].collect { |klass| klass.new(options) }
  @ins = matchers.select(&:ins?)
  @outs = matchers.select(&:outs?)
end

Instance Attribute Details

#ins ⇒ Array<Matchers::Matcher> (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns Matchers for the input columns.

Returns:



137
138
139
 
# File 'lib/csv_decision/matchers.rb', line 137

def ins
  @ins
end

#outs ⇒ Array<Matchers::Matcher> (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns Matchers for the output columns.

Returns:



140
141
142
 
# File 'lib/csv_decision/matchers.rb', line 140

def outs
  @outs
end

Class Method Details

.normalize_operator(operator) ⇒ String

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Normalize the operators which are a variation on equals/assignment.

Parameters:

  • operator (String)

Returns:

  • (String) 


85
86
87
 
# File 'lib/csv_decision/matchers.rb', line 85

def self.normalize_operator(operator)
  EQUALS_RE.match?(operator) ? '==' : operator
end

.numeric(value) ⇒ nil, ...

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Validate a numeric value and convert it to an Integer or BigDecimal if a valid numeric string.

Parameters:

  • value (nil, String, Integer, BigDecimal)

Returns:

  • (nil, Integer, BigDecimal) 


99
100
101
102
103
104
 
# File 'lib/csv_decision/matchers.rb', line 99

def self.numeric(value)
  return value if value.is_a?(Integer) || value.is_a?(BigDecimal)
  return unless value.is_a?(String)

  to_numeric(value)
end

.parse(columns:, matchers:, row:) ⇒ Array<(Array, ScanRow)>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parse the supplied input columns for the row supplied using an array of matchers.

Parameters:

  • columns (Hash{Integer=>Columns::Entry}) —

    Input columns hash.

  • matchers (Array<Matchers::Matcher>)
  • row (Array<String>) —

    Data row being parsed.

Returns:

  • (Array<(Array, ScanRow)>) —

    Used to scan a table row against an input hash for matches.



123
124
125
126
127
128
129
130
131
132
133
134
 
# File 'lib/csv_decision/matchers.rb', line 123

def self.parse(columns:, matchers:, row:)
  # Build an array of column indexes requiring simple constant matches,
  # and a second array of columns requiring special matchers.
  scan_row = ScanRow.new

  # Scan the columns in the data row, and build an object to scan this row against
  # an input hash.
  # Convert values in the data row if not just a simple constant.
  row = scan_row.scan_columns(columns: columns, matchers: matchers, row: row)

  [row, scan_row]
end

.regexp(value) ⇒ Regexp

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

All regular expressions used for matching are anchored inside their own non-capturing group.

Parameters:

  • value (String) —

    String used to form an anchored regular expression.

Returns:

  • (Regexp) —

    Anchored, frozen regular expression.



71
72
73
 
# File 'lib/csv_decision/matchers.rb', line 71

def self.regexp(value)
  Regexp.new("\\A(?:#{value})\\z").freeze
end

.to_numeric(value) ⇒ nil, ...

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Convert a numeric string into an Integer or BigDecimal, otherwise return nil.

Parameters:

  • value (String)

Returns:

  • (nil, Integer, BigDecimal) 


110
111
112
113
114
115
 
# File 'lib/csv_decision/matchers.rb', line 110

def self.to_numeric(value)
  return unless (match = NUMERIC_RE.match(value))

  return value.to_i if match['decimal'] == ''
  BigDecimal(value.chomp('.'))
end

Instance Method Details

#parse_ins(columns:, row:) ⇒ Array<(Array, ScanRow)>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parse the row’s input columns using the input matchers.

Parameters:

  • columns (Hash{Integer=>Columns::Entry}) —

    Input columns hash.

  • row (Array<String>) —

    Data row being parsed.

Returns:

  • (Array<(Array, ScanRow)>) —

    Used to scan a table row against an input hash for matches.



154
155
156
 
# File 'lib/csv_decision/matchers.rb', line 154

def parse_ins(columns:, row:)
  Matchers.parse(columns: columns, matchers: @ins, row: row)
end

#parse_outs(columns:, row:) ⇒ Array<(Array, ScanRow)>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parse the row’s output columns using the output matchers.

Parameters:

  • columns (Hash{Integer=>Columns::Entry}) —

    Input columns hash.

  • row (Array<String>) —

    Data row being parsed.

Returns:

  • (Array<(Array, ScanRow)>) —

    Used to scan a table row against an input hash for matches.



163
164
165
 
# File 'lib/csv_decision/matchers.rb', line 163

def parse_outs(columns:, row:)
  Matchers.parse(columns: columns, matchers: @outs, row: row)
end