Class: Dentaku::TokenScanner

Inherits:
Object
  • Object
show all
Extended by:
StringCasing
Defined in:
lib/dentaku/token_scanner.rb

Constant Summary collapse

DATE_TIME_REGEXP =
/\d{2}\d{2}?-\d{1,2}-\d{1,2}([ |T]\d{1,2}:\d{1,2}:\d{1,2}(\.\d*)?)? ?(Z|((\+|\-)\d{2}\:?\d{2}))?(?!\d)/.freeze

Class Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from StringCasing

standardize_case

Constructor Details

#initialize(category, regexp, converter = nil, condition = nil) ⇒ TokenScanner

Returns a new instance of TokenScanner.



13
14
15
16
17
18
# File 'lib/dentaku/token_scanner.rb', line 13

def initialize(category, regexp, converter = nil, condition = nil)
  @category  = category
  @regexp    = %r{\A(#{ regexp })}i
  @converter = converter
  @condition = condition || ->(*) { true }
end

Class Attribute Details

.case_sensitiveObject (readonly)

Returns the value of attribute case_sensitive.



34
35
36
# File 'lib/dentaku/token_scanner.rb', line 34

def case_sensitive
  @case_sensitive
end

Class Method Details

.accessObject



144
145
146
147
# File 'lib/dentaku/token_scanner.rb', line 144

def access
  names = { lbracket: '[', rbracket: ']' }.invert
  new(:access, '\[|\]', lambda { |raw| names[raw] })
end

.arrayObject



139
140
141
142
# File 'lib/dentaku/token_scanner.rb', line 139

def array
  names = { array_start: '{', array_end: '}', }.invert
  new(:array, '\{|\}|,', lambda { |raw| names[raw] })
end

.available_scannersObject



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# File 'lib/dentaku/token_scanner.rb', line 36

def available_scanners
  [
    :null,
    :whitespace,
    :datetime, # before numeric so it can pick up timestamps
    :numeric,
    :hexadecimal,
    :double_quoted_string,
    :single_quoted_string,
    :negate,
    :combinator,
    :operator,
    :grouping,
    :array,
    :access,
    :case_statement,
    :comparator,
    :boolean,
    :function,
    :identifier,
    :quoted_identifier
  ]
end

.booleanObject



168
169
170
# File 'lib/dentaku/token_scanner.rb', line 168

def boolean
  new(:logical, '(true|false)\b', lambda { |raw| raw.strip.downcase == 'true' })
end

.case_statementObject



149
150
151
152
# File 'lib/dentaku/token_scanner.rb', line 149

def case_statement
  names = { open: 'case', close: 'end', then: 'then', when: 'when', else: 'else' }.invert
  new(:case, '(case|end|then|when|else)\b', lambda { |raw| names[raw.downcase] })
end

.combinatorObject



160
161
162
163
164
165
166
# File 'lib/dentaku/token_scanner.rb', line 160

def combinator
  names = { and: '&&', or: '||' }.invert
  new(:combinator, '(and|or|&&|\|\|)\s', lambda { |raw|
    norm = raw.strip.downcase
    names.fetch(norm) { norm.to_sym }
  })
end

.comparatorObject



154
155
156
157
158
# File 'lib/dentaku/token_scanner.rb', line 154

def comparator
  names = { le: '<=', ge: '>=', ne: '!=', lt: '<', gt: '>', eq: '=' }.invert
  alternate = { ne: '<>', eq: '==' }.invert
  new(:comparator, '<=|>=|!=|<>|<|>|==|=', lambda { |raw| names[raw] || alternate[raw] })
end

.datetimeObject

NOTE: Convert to DateTime as Array(Time) returns the parts of the time for some reason



94
95
96
# File 'lib/dentaku/token_scanner.rb', line 94

def datetime
  new(:datetime, DATE_TIME_REGEXP, lambda { |raw| Time.parse(raw).to_datetime })
end

.double_quoted_stringObject



106
107
108
# File 'lib/dentaku/token_scanner.rb', line 106

def double_quoted_string
  new(:string, '"[^"]*"', lambda { |raw| raw.gsub(/^"|"$/, '') })
end

.functionObject



172
173
174
175
176
177
178
179
180
# File 'lib/dentaku/token_scanner.rb', line 172

def function
  new(:function, '\w+!?\s*\(', lambda do |raw|
    function_name = raw.gsub('(', '')
    [
      Token.new(:function, function_name.strip.downcase.to_sym, function_name),
      Token.new(:grouping, :open, '(')
    ]
  end)
end

.groupingObject



134
135
136
137
# File 'lib/dentaku/token_scanner.rb', line 134

def grouping
  names = { open: '(', close: ')', comma: ',' }.invert
  new(:grouping, '\(|\)|,', lambda { |raw| names[raw] })
end

.hexadecimalObject



102
103
104
# File 'lib/dentaku/token_scanner.rb', line 102

def hexadecimal
  new(:numeric, NumericParser::HEXADECIMAL_PATTERN, lambda { |raw| NumericParser.parse_hexadecimal_string(raw) })
end

.identifierObject



182
183
184
# File 'lib/dentaku/token_scanner.rb', line 182

def identifier
  new(:identifier, '[[[:word:]]\.]+\b', lambda { |raw| standardize_case(raw.strip) })
end

.negateObject



114
115
116
117
118
119
120
121
122
123
124
125
# File 'lib/dentaku/token_scanner.rb', line 114

def negate
  new(:operator, '-', lambda { |raw| :negate }, lambda { |last_token|
    last_token.nil?               ||
    last_token.is?(:operator)     ||
    last_token.is?(:comparator)   ||
    last_token.is?(:combinator)   ||
    last_token.value == :open     ||
    last_token.value == :comma    ||
    last_token.value == :lbracket ||
    last_token.value == :array_start
  })
end

.nullObject



89
90
91
# File 'lib/dentaku/token_scanner.rb', line 89

def null
  new(:null, 'null\b')
end

.numericObject



98
99
100
# File 'lib/dentaku/token_scanner.rb', line 98

def numeric
  new(:numeric, NumericParser::NUMERIC_PATTERN, lambda { |raw| NumericParser.parse_numeric_string(raw) })
end

.operatorObject



127
128
129
130
131
132
# File 'lib/dentaku/token_scanner.rb', line 127

def operator
  names = {
    pow: '^', add: '+', subtract: '-', multiply: '*', divide: '/', mod: '%', bitor: '|', bitand: '&', bitshiftleft: '<<', bitshiftright: '>>'
  }.invert
  new(:operator, '\^|\+|-|\*|\/|%|\||&|<<|>>', lambda { |raw| names[raw] })
end

.quoted_identifierObject



186
187
188
# File 'lib/dentaku/token_scanner.rb', line 186

def quoted_identifier
  new(:identifier, '`[^`]*`', lambda { |raw| raw.gsub(/^`|`$/, '') })
end

.register_default_scannersObject



60
61
62
# File 'lib/dentaku/token_scanner.rb', line 60

def register_default_scanners
  register_scanners(available_scanners)
end

.register_scanner(id, scanner) ⇒ Object



70
71
72
# File 'lib/dentaku/token_scanner.rb', line 70

def register_scanner(id, scanner)
  @scanners[id] = scanner
end

.register_scanners(scanner_ids) ⇒ Object



64
65
66
67
68
# File 'lib/dentaku/token_scanner.rb', line 64

def register_scanners(scanner_ids)
  @scanners = scanner_ids.each_with_object({}) do |id, scanners|
    scanners[id] = self.send(id)
  end
end

.scanners(options = {}) ⇒ Object



78
79
80
81
82
83
# File 'lib/dentaku/token_scanner.rb', line 78

def scanners(options = {})
  @case_sensitive = options.fetch(:case_sensitive, false)
  raw_date_literals = options.fetch(:raw_date_literals, true)

  @scanners.select { |k, _| raw_date_literals || k != :datetime }.values
end

.scanners=(scanner_ids) ⇒ Object



74
75
76
# File 'lib/dentaku/token_scanner.rb', line 74

def scanners=(scanner_ids)
  @scanners.select! { |k, v| scanner_ids.include?(k) }
end

.single_quoted_stringObject



110
111
112
# File 'lib/dentaku/token_scanner.rb', line 110

def single_quoted_string
  new(:string, "'[^']*'", lambda { |raw| raw.gsub(/^'|'$/, '') })
end

.whitespaceObject



85
86
87
# File 'lib/dentaku/token_scanner.rb', line 85

def whitespace
  new(:whitespace, '\s+')
end

Instance Method Details

#scan(string, last_token = nil) ⇒ Object



20
21
22
23
24
25
26
27
28
29
30
31
# File 'lib/dentaku/token_scanner.rb', line 20

def scan(string, last_token = nil)
  if (m = @regexp.match(string)) && @condition.call(last_token)
    value = raw = m.to_s
    value = @converter.call(raw) if @converter

    return Array(value).map do |v|
      Token === v ? v : Token.new(@category, v, raw)
    end
  end

  false
end