Class: Dentaku::Calculator
- Inherits:
-
Object
- Object
- Dentaku::Calculator
- Includes:
- StringCasing
- Defined in:
- lib/dentaku/calculator.rb
Instance Attribute Summary collapse
-
#aliases ⇒ Object
readonly
Returns the value of attribute aliases.
-
#ast_cache ⇒ Object
readonly
Returns the value of attribute ast_cache.
-
#case_sensitive ⇒ Object
readonly
Returns the value of attribute case_sensitive.
-
#memory ⇒ Object
readonly
Returns the value of attribute memory.
-
#nested_data_support ⇒ Object
readonly
Returns the value of attribute nested_data_support.
-
#result ⇒ Object
readonly
Returns the value of attribute result.
-
#tokenizer ⇒ Object
readonly
Returns the value of attribute tokenizer.
Class Method Summary collapse
Instance Method Summary collapse
- #add_function(name, type, body) ⇒ Object
- #add_functions(fns) ⇒ Object
- #ast(expression) ⇒ Object
- #cache_ast? ⇒ Boolean
- #clear ⇒ Object
- #clear_cache(pattern = :all) ⇒ Object
- #dependencies(expression, context = {}) ⇒ Object
- #disable_cache ⇒ Object
- #empty? ⇒ Boolean
- #evaluate(expression, data = {}, &block) ⇒ Object
- #evaluate!(expression, data = {}, &block) ⇒ Object
-
#initialize(options = {}) ⇒ Calculator
constructor
A new instance of Calculator.
- #load_cache(ast_cache) ⇒ Object
- #solve(expression_hash, &block) ⇒ Object
- #solve!(expression_hash) ⇒ Object
- #store(key_or_hash, value = nil) ⇒ Object (also: #bind)
- #store_formula(key, formula) ⇒ Object
Methods included from StringCasing
Constructor Details
#initialize(options = {}) ⇒ Calculator
Returns a new instance of Calculator.
15 16 17 18 19 20 21 22 23 24 25 |
# File 'lib/dentaku/calculator.rb', line 15 def initialize( = {}) clear @tokenizer = Tokenizer.new @case_sensitive = .delete(:case_sensitive) @aliases = .delete(:aliases) || Dentaku.aliases @nested_data_support = .fetch(:nested_data_support, true) .delete(:nested_data_support) @ast_cache = @disable_ast_cache = false @function_registry = Dentaku::AST::FunctionRegistry.new end |
Instance Attribute Details
#aliases ⇒ Object (readonly)
Returns the value of attribute aliases.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def aliases @aliases end |
#ast_cache ⇒ Object (readonly)
Returns the value of attribute ast_cache.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def ast_cache @ast_cache end |
#case_sensitive ⇒ Object (readonly)
Returns the value of attribute case_sensitive.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def case_sensitive @case_sensitive end |
#memory ⇒ Object (readonly)
Returns the value of attribute memory.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def memory @memory end |
#nested_data_support ⇒ Object (readonly)
Returns the value of attribute nested_data_support.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def nested_data_support @nested_data_support end |
#result ⇒ Object (readonly)
Returns the value of attribute result.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def result @result end |
#tokenizer ⇒ Object (readonly)
Returns the value of attribute tokenizer.
12 13 14 |
# File 'lib/dentaku/calculator.rb', line 12 def tokenizer @tokenizer end |
Class Method Details
.add_function(name, type, body) ⇒ Object
27 28 29 |
# File 'lib/dentaku/calculator.rb', line 27 def self.add_function(name, type, body) Dentaku::AST::FunctionRegistry.default.register(name, type, body) end |
Instance Method Details
#add_function(name, type, body) ⇒ Object
31 32 33 34 |
# File 'lib/dentaku/calculator.rb', line 31 def add_function(name, type, body) @function_registry.register(name, type, body) self end |
#add_functions(fns) ⇒ Object
36 37 38 39 |
# File 'lib/dentaku/calculator.rb', line 36 def add_functions(fns) fns.each { |(name, type, body)| add_function(name, type, body) } self end |
#ast(expression) ⇒ Object
92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 |
# File 'lib/dentaku/calculator.rb', line 92 def ast(expression) return expression.map { |e| ast(e) } if expression.is_a? Array @ast_cache.fetch(expression) { = { case_sensitive: case_sensitive, function_registry: @function_registry, aliases: aliases } tokens = tokenizer.tokenize(expression, ) Parser.new(tokens, ).parse.tap do |node| @ast_cache[expression] = node if cache_ast? end } end |
#cache_ast? ⇒ Boolean
165 166 167 |
# File 'lib/dentaku/calculator.rb', line 165 def cache_ast? Dentaku.cache_ast? && !@disable_ast_cache end |
#clear ⇒ Object
157 158 159 |
# File 'lib/dentaku/calculator.rb', line 157 def clear @memory = {} end |
#clear_cache(pattern = :all) ⇒ Object
113 114 115 116 117 118 119 120 121 122 123 124 |
# File 'lib/dentaku/calculator.rb', line 113 def clear_cache(pattern = :all) case pattern when :all @ast_cache = {} when String @ast_cache.delete(pattern) when Regexp @ast_cache.delete_if { |k, _| k =~ pattern } else raise ::ArgumentError end end |
#dependencies(expression, context = {}) ⇒ Object
79 80 81 82 83 84 85 86 87 88 89 90 |
# File 'lib/dentaku/calculator.rb', line 79 def dependencies(expression, context = {}) test_context = context.nil? ? {} : store(context) { memory } case expression when Dentaku::AST::Node expression.dependencies(test_context) when Array expression.flat_map { |e| dependencies(e, context) } else ast(expression).dependencies(test_context) end end |
#disable_cache ⇒ Object
41 42 43 44 45 46 |
# File 'lib/dentaku/calculator.rb', line 41 def disable_cache @disable_ast_cache = true yield(self) if block_given? ensure @disable_ast_cache = false end |
#empty? ⇒ Boolean
161 162 163 |
# File 'lib/dentaku/calculator.rb', line 161 def empty? memory.empty? end |
#evaluate(expression, data = {}, &block) ⇒ Object
48 49 50 51 52 |
# File 'lib/dentaku/calculator.rb', line 48 def evaluate(expression, data = {}, &block) evaluate!(expression, data) rescue Dentaku::Error, Dentaku::ArgumentError, Dentaku::ZeroDivisionError => ex block.call(expression, ex) if block_given? end |
#evaluate!(expression, data = {}, &block) ⇒ Object
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 |
# File 'lib/dentaku/calculator.rb', line 54 def evaluate!(expression, data = {}, &block) return expression.map { |e| evaluate(e, data, &block) } if expression.is_a? Array store(data) do node = expression node = ast(node) unless node.is_a?(AST::Node) unbound = node.dependencies(memory) unless unbound.empty? raise UnboundVariableError.new(unbound), "no value provided for variables: #{unbound.uniq.join(', ')}" end node.value(memory) end end |
#load_cache(ast_cache) ⇒ Object
109 110 111 |
# File 'lib/dentaku/calculator.rb', line 109 def load_cache(ast_cache) @ast_cache = ast_cache end |
#solve(expression_hash, &block) ⇒ Object
75 76 77 |
# File 'lib/dentaku/calculator.rb', line 75 def solve(expression_hash, &block) BulkExpressionSolver.new(expression_hash, self).solve(&block) end |
#solve!(expression_hash) ⇒ Object
71 72 73 |
# File 'lib/dentaku/calculator.rb', line 71 def solve!(expression_hash) BulkExpressionSolver.new(expression_hash, self).solve! end |
#store(key_or_hash, value = nil) ⇒ Object Also known as: bind
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 |
# File 'lib/dentaku/calculator.rb', line 126 def store(key_or_hash, value = nil) restore = Hash[memory] if value.nil? key_or_hash = FlatHash.from_hash_with_intermediates(key_or_hash) if nested_data_support key_or_hash.each do |key, val| memory[standardize_case(key.to_s)] = val end else memory[standardize_case(key_or_hash.to_s)] = value end if block_given? begin result = yield @memory = restore return result rescue => e @memory = restore raise e end end self end |
#store_formula(key, formula) ⇒ Object
153 154 155 |
# File 'lib/dentaku/calculator.rb', line 153 def store_formula(key, formula) store(key, ast(formula)) end |