trifle-stats 2.4.1 → 2.6.0

data/lib/trifle/stats/transponder/expression_engine.rb

@@ -0,0 +1,356 @@
+# frozen_string_literal: true
+
+require 'bigdecimal'
+
+module Trifle
+  module Stats
+    class Transponder
+      class ExpressionEngine
+        LETTERS = ('a'..'z').to_a.freeze
+        TOKEN_OPERATORS = %w[+ - * / ( ) ,].freeze
+        NUMBER_PATTERN = /\A\d+(?:\.\d+)?/.freeze
+        IDENT_PATTERN = /\A[A-Za-z_][A-Za-z0-9_]*/.freeze
+
+        class << self
+          def max_vars
+            LETTERS.length
+          end
+
+          def allowed_vars(count)
+            LETTERS.take(count)
+          end
+
+          def validate(paths:, expression:)
+            normalized_paths = normalize_paths(paths)
+            parse(expression: expression, paths: normalized_paths)
+            true
+          end
+
+          def parse(expression:, paths:)
+            normalized_paths = normalize_paths(paths)
+            ensure_within_var_limit(normalized_paths)
+            tokens = tokenize(expression.to_s)
+            parser = Parser.new(tokens, allowed_vars(normalized_paths.length))
+            ast = parser.parse
+            raise ArgumentError, 'Unexpected token sequence.' unless parser.done?
+
+            ast
+          end
+
+          def evaluate(ast:, env:)
+            Evaluator.new(env).evaluate(ast)
+          end
+
+          private
+
+          def normalize_paths(paths)
+            raise ArgumentError, 'Paths must be an array.' unless paths.is_a?(Array)
+
+            cleaned = paths.map { |path| path.to_s.strip }.reject(&:empty?)
+            raise ArgumentError, 'At least one path is required.' if cleaned.empty?
+
+            cleaned
+          end
+
+          def ensure_within_var_limit(paths)
+            return if paths.length <= max_vars
+
+            raise ArgumentError, "Too many paths. Maximum supported is #{max_vars}."
+          end
+
+          def tokenize(expression)
+            trimmed = normalize_expression_text(expression)
+            tokens = []
+            index = 0
+
+            while index < trimmed.length
+              token, consumed = read_token(trimmed, index)
+              tokens << token unless token.nil?
+              index += consumed
+            end
+
+            tokens
+          end
+
+          def normalize_expression_text(expression)
+            trimmed = expression.to_s.strip
+            raise ArgumentError, 'Expression must be text.' if trimmed.empty?
+
+            trimmed
+          end
+
+          def read_token(source, index)
+            char = source[index]
+
+            return [nil, 1] if whitespace?(char)
+            return [char, 1] if operator?(char)
+            return number_token(source, index) if digit?(char)
+            return ident_token(source, index) if identifier_start?(char)
+
+            raise_invalid_token(index)
+          end
+
+          def whitespace?(char)
+            char.match?(/\s/)
+          end
+
+          def operator?(char)
+            TOKEN_OPERATORS.include?(char)
+          end
+
+          def digit?(char)
+            char.match?(/\d/)
+          end
+
+          def identifier_start?(char)
+            char.match?(/[A-Za-z_]/)
+          end
+
+          def number_token(source, index)
+            match = source[index..].match(NUMBER_PATTERN)
+            raise_invalid_token(index) unless match
+
+            [[:number, BigDecimal(match[0])], match[0].length]
+          end
+
+          def ident_token(source, index)
+            match = source[index..].match(IDENT_PATTERN)
+            raise_invalid_token(index) unless match
+
+            [[:ident, match[0]], match[0].length]
+          end
+
+          def raise_invalid_token(index)
+            raise ArgumentError, "Invalid token at position #{index}."
+          end
+        end
+
+        class Parser
+          def initialize(tokens, vars)
+            @tokens = tokens
+            @vars = vars
+            @index = 0
+          end
+
+          def parse
+            parse_expression
+          end
+
+          def done?
+            current.nil?
+          end
+
+          private
+
+          def parse_expression
+            node = parse_term
+
+            while %w[+ -].include?(current)
+              op = consume
+              node = [op.to_sym, node, parse_term]
+            end
+
+            node
+          end
+
+          def parse_term
+            node = parse_factor
+
+            while %w[* /].include?(current)
+              op = consume
+              node = [op.to_sym, node, parse_factor]
+            end
+
+            node
+          end
+
+          def parse_factor
+            return parse_unary_factor if %w[+ -].include?(current)
+            return parse_grouped_expression if current == '('
+
+            parse_primary
+          end
+
+          def parse_primary
+            token = current
+            raise ArgumentError, 'Unexpected end of expression.' if token.nil?
+
+            return parse_number(token) if number_token?(token)
+            return parse_identifier(token) if ident_token?(token)
+
+            raise ArgumentError, "Unexpected token #{token.inspect}."
+          end
+
+          def parse_args
+            return [] if current == ')'
+
+            args = [parse_expression]
+
+            while current == ','
+              consume
+              args << parse_expression
+            end
+
+            args
+          end
+
+          def current
+            @tokens[@index]
+          end
+
+          def consume
+            token = current
+            @index += 1
+            token
+          end
+
+          def parse_unary_factor
+            operator = consume
+            node = parse_factor
+            operator == '-' ? [:neg, node] : node
+          end
+
+          def parse_grouped_expression
+            consume
+            node = parse_expression
+            expect_token!(')', 'Missing closing parenthesis.')
+            consume
+            node
+          end
+
+          def parse_number(token)
+            consume
+            [:number, token[1]]
+          end
+
+          def parse_identifier(token)
+            consume
+            ident = token[1]
+            return parse_function_call(ident) if current == '('
+
+            validate_variable!(ident)
+            [:var, ident]
+          end
+
+          def parse_function_call(ident)
+            consume
+            args = parse_args
+            expect_token!(')', 'Missing closing parenthesis.')
+            consume
+            [:func, ident, args]
+          end
+
+          def validate_variable!(ident)
+            raise ArgumentError, "Unknown variable #{ident}." unless @vars.include?(ident)
+          end
+
+          def number_token?(token)
+            token.is_a?(Array) && token[0] == :number
+          end
+
+          def ident_token?(token)
+            token.is_a?(Array) && token[0] == :ident
+          end
+
+          def expect_token!(expected, message)
+            raise ArgumentError, message unless current == expected
+          end
+        end
+
+        class Evaluator
+          ZERO = BigDecimal('0')
+          AVERAGE = lambda do |args|
+            args.reduce(ZERO, :+) / BigDecimal(args.length.to_s)
+          end
+          BINARY_OPERATIONS = {
+            :+ => ->(left, right) { left + right },
+            :- => ->(left, right) { left - right },
+            :* => ->(left, right) { left * right },
+            :/ => ->(left, right) { right.zero? ? nil : left / right }
+          }.freeze
+          FUNCTIONS = {
+            'sum' => ->(args) { args.reduce(ZERO, :+) },
+            'mean' => AVERAGE,
+            'avg' => AVERAGE,
+            'min' => :min.to_proc,
+            'max' => :max.to_proc
+          }.freeze
+
+          def initialize(env)
+            @env = env || {}
+          end
+
+          def evaluate(node)
+            type, *rest = node
+            return rest[0] if type == :number
+            return evaluate_variable(rest[0]) if type == :var
+            return evaluate_negation(rest[0]) if type == :neg
+            return evaluate_binary(type, rest[0], rest[1]) if BINARY_OPERATIONS.key?(type)
+            return evaluate_function(rest[0], rest[1]) if type == :func
+
+            raise ArgumentError, "Unknown AST node #{type.inspect}."
+          end
+
+          private
+
+          def normalize_value(value)
+            return nil if value.nil?
+            return value if value.is_a?(BigDecimal)
+            return BigDecimal(value.to_s) if value.is_a?(Numeric)
+
+            nil
+          rescue ArgumentError
+            nil
+          end
+
+          def evaluate_variable(name)
+            normalize_value(@env[name])
+          end
+
+          def evaluate_negation(node)
+            value = evaluate(node)
+            value.nil? ? nil : -value
+          end
+
+          def evaluate_binary(operator, left_node, right_node)
+            left = evaluate(left_node)
+            right = evaluate(right_node)
+            apply_binary(operator, left, right)
+          end
+
+          def evaluate_function(name, arg_nodes)
+            args = arg_nodes.map { |arg| evaluate(arg) }
+            apply_function(name, args)
+          end
+
+          def apply_binary(operator, left, right)
+            return nil if left.nil? || right.nil?
+
+            operation = BINARY_OPERATIONS[operator]
+            raise ArgumentError, "Unknown binary operator #{operator.inspect}." unless operation
+
+            operation.call(left, right)
+          end
+
+          def apply_function(name, args)
+            return nil if args.empty? || args.any?(&:nil?)
+
+            return apply_sqrt(args) if name == 'sqrt'
+
+            function = FUNCTIONS[name]
+            raise ArgumentError, "Unknown function #{name}." unless function
+
+            function.call(args)
+          end
+
+          def apply_sqrt(args)
+            raise ArgumentError, 'Function sqrt expects 1 argument.' unless args.length == 1
+            return nil if args[0].negative?
+
+            BigDecimal(Math.sqrt(args[0].to_f).to_s)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/trifle/stats/version.rb

@@ -2,6 +2,6 @@
 
 module Trifle
   module Stats
-    VERSION = '2.4.1'
+    VERSION = '2.6.0'
   end
 end

data/lib/trifle/stats.rb

@@ -28,16 +28,8 @@ require 'trifle/stats/operations/timeseries/set'
 require 'trifle/stats/operations/timeseries/values'
 require 'trifle/stats/operations/status/beam'
 require 'trifle/stats/operations/status/scan'
-require 'trifle/stats/transponder/add'
-require 'trifle/stats/transponder/divide'
-require 'trifle/stats/transponder/max'
-require 'trifle/stats/transponder/mean'
-require 'trifle/stats/transponder/min'
-require 'trifle/stats/transponder/multiply'
-require 'trifle/stats/transponder/ratio'
-require 'trifle/stats/transponder/standard_deviation'
-require 'trifle/stats/transponder/subtract'
-require 'trifle/stats/transponder/sum'
+require 'trifle/stats/transponder/expression_engine'
+require 'trifle/stats/transponder/expression'
 require 'trifle/stats/version'
 
 module Trifle
@@ -107,3 +99,5 @@ module Trifle
     end
   end
 end
+
+require 'trifle/stats/driver/api'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trifle-stats
 version: !ruby/object:Gem::Version
-  version: 2.4.1
+  version: 2.6.0
 platform: ruby
 authors:
 - Jozef Vaclavik
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-25 00:00:00.000000000 Z
+date: 2026-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -225,6 +225,7 @@ files:
 - lib/trifle/stats/designator/geometric.rb
 - lib/trifle/stats/designator/linear.rb
 - lib/trifle/stats/driver/README.md
+- lib/trifle/stats/driver/api.rb
 - lib/trifle/stats/driver/mongo.rb
 - lib/trifle/stats/driver/mysql.rb
 - lib/trifle/stats/driver/postgres.rb
@@ -238,23 +239,14 @@ files:
 - lib/trifle/stats/nocturnal.rb
 - lib/trifle/stats/nocturnal/key.rb
 - lib/trifle/stats/nocturnal/parser.rb
-- lib/trifle/stats/nocturnal_legacy.rb
 - lib/trifle/stats/operations/status/beam.rb
 - lib/trifle/stats/operations/status/scan.rb
 - lib/trifle/stats/operations/timeseries/increment.rb
 - lib/trifle/stats/operations/timeseries/set.rb
 - lib/trifle/stats/operations/timeseries/values.rb
 - lib/trifle/stats/series.rb
-- lib/trifle/stats/transponder/add.rb
-- lib/trifle/stats/transponder/divide.rb
-- lib/trifle/stats/transponder/max.rb
-- lib/trifle/stats/transponder/mean.rb
-- lib/trifle/stats/transponder/min.rb
-- lib/trifle/stats/transponder/multiply.rb
-- lib/trifle/stats/transponder/ratio.rb
-- lib/trifle/stats/transponder/standard_deviation.rb
-- lib/trifle/stats/transponder/subtract.rb
-- lib/trifle/stats/transponder/sum.rb
+- lib/trifle/stats/transponder/expression.rb
+- lib/trifle/stats/transponder/expression_engine.rb
 - lib/trifle/stats/version.rb
 - trifle-stats.gemspec
 homepage: https://trifle.io

data/lib/trifle/stats/nocturnal_legacy.rb

@@ -1,161 +0,0 @@
-# frozen_string_literal: true
-
-module Trifle
-  module Stats
-    class Nocturnal # rubocop:disable Metrics/ClassLength
-      UNIT_MAP = {
-        's' => :second,
-        'm' => :minute,
-        'h' => :hour,
-        'd' => :day,
-        'w' => :week,
-        'mo' => :month,
-        'q' => :quarter,
-        'y' => :year
-      }.freeze
-
-      DAYS_INTO_WEEK = {
-        sunday: 0, monday: 1, tuesday: 2, wednesday: 3,
-        thursday: 4, friday: 5, saturday: 6
-      }.freeze
-
-      def self.timeline(from:, to:, granularity:, config: nil)
-        list = []
-        from = new(from, config: config).send(granularity)
-        to = new(to, config: config).send(granularity)
-        item = from.dup
-        while item <= to
-          list << item
-          item = Nocturnal.new(item, config: config).send("next_#{granularity}")
-        end
-        list
-      end
-
-      def initialize(at, config: nil)
-        @at = at
-        @config = config
-      end
-
-      def config
-        @config || Trifle::Stats.default
-      end
-
-      def change(**fractions)
-        Time.new(
-          fractions.fetch(:year, @at.year),
-          fractions.fetch(:month, @at.month),
-          fractions.fetch(:day, @at.day),
-          fractions.fetch(:hour, @at.hour),
-          fractions.fetch(:minute, @at.min),
-          fractions.fetch(:second, 0),
-          config.tz.utc_offset
-        )
-      end
-
-      def second
-        change(second: @at.sec)
-      end
-
-      def next_second
-        Nocturnal.new(
-          second + 1,
-          config: config
-        ).second
-      end
-
-      def minute
-        change(second: 0)
-      end
-
-      def next_minute
-        Nocturnal.new(
-          minute + 60,
-          config: config
-        ).minute
-      end
-
-      def hour
-        change(minute: 0)
-      end
-
-      def next_hour
-        Nocturnal.new(
-          hour + 60 * 60,
-          config: config
-        ).hour
-      end
-
-      def day
-        change(hour: 0, minute: 0)
-      end
-
-      def next_day
-        Nocturnal.new(
-          day + 60 * 60 * 24,
-          config: config
-        ).day
-      end
-
-      def week
-        today = day
-
-        (today.to_date - days_to_week_start).to_time
-      end
-
-      def next_week
-        Nocturnal.new(
-          week + 60 * 60 * 24 * 7,
-          config: config
-        ).week
-      end
-
-      def days_to_week_start
-        start_day_number = DAYS_INTO_WEEK.fetch(
-          config.beginning_of_week
-        )
-
-        (@at.wday - start_day_number) % 7
-      end
-
-      def month
-        change(day: 1, hour: 0, minute: 0)
-      end
-
-      def next_month
-        Nocturnal.new(
-          month + 60 * 60 * 24 * 31,
-          config: config
-        ).month
-      end
-
-      def quarter
-        first_quarter_month = @at.month - (2 + @at.month) % 3
-
-        change(
-          month: first_quarter_month,
-          day: 1,
-          hour: 0,
-          minute: 0
-        )
-      end
-
-      def next_quarter
-        Nocturnal.new(
-          quarter + 60 * 60 * 24 * 31 * 3,
-          config: config
-        ).quarter
-      end
-
-      def year
-        change(month: 1, day: 1, hour: 0, minute: 0)
-      end
-
-      def next_year
-        Nocturnal.new(
-          year + 60 * 60 * 24 * 31 * 12,
-          config: config
-        ).year
-      end
-    end
-  end
-end

data/lib/trifle/stats/transponder/add.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Trifle
-  module Stats
-    class Transponder
-      class Add
-        include Trifle::Stats::Mixins::Packer
-        Trifle::Stats::Series.register_transponder(:add, self)
-
-        def transpond(series:, left:, right:, response: 'add') # rubocop:disable Metrics/MethodLength
-          left_keys = left.to_s.split('.')
-          right_keys = right.to_s.split('.')
-
-          series[:values] = series[:values].map do |data|
-            dleft = data.dig(*left_keys)
-            dright = data.dig(*right_keys)
-            next data unless dleft && dright
-
-            dres = dleft + dright
-            signal = {
-              response => dres
-            }
-            self.class.deep_merge(data, self.class.unpack(hash: signal))
-          end
-          series
-        end
-      end
-    end
-  end
-end

data/lib/trifle/stats/transponder/divide.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Trifle
-  module Stats
-    class Transponder
-      class Divide
-        include Trifle::Stats::Mixins::Packer
-        Trifle::Stats::Series.register_transponder(:divide, self)
-
-        def transpond(series:, left:, right:, response: 'divide') # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-          left_keys = left.to_s.split('.')
-          right_keys = right.to_s.split('.')
-
-          series[:values] = series[:values].map do |data|
-            dleft = data.dig(*left_keys)
-            dright = data.dig(*right_keys)
-            next data unless dleft && dright
-
-            dres = (dleft / dright)
-            signal = {
-              response => dres.nan? ? BigDecimal(0) : dres
-            }
-            self.class.deep_merge(data, self.class.unpack(hash: signal))
-          end
-          series
-        end
-      end
-    end
-  end
-end

data/lib/trifle/stats/transponder/max.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module Trifle
-  module Stats
-    class Transponder
-      class Max
-        include Trifle::Stats::Mixins::Packer
-        Trifle::Stats::Series.register_transponder(:max, self)
-
-        def transpond(series:, paths:, response: 'max') # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity
-          path_keys = paths.map { |path| path.to_s.split('.') }
-
-          series[:values] = series[:values].map do |data|
-            dvalues = path_keys.map { |path_key| data.dig(*path_key) }
-            next data if dvalues.any?(&:nil?)
-
-            numeric_values = dvalues.select { |v| v.is_a?(Numeric) }
-            next data if numeric_values.empty?
-
-            dres = numeric_values.max
-            signal = {
-              response => dres
-            }
-            self.class.deep_merge(data, self.class.unpack(hash: signal))
-          end
-          series
-        end
-      end
-    end
-  end
-end