yggdrasil-engine 1.1.0-universal-java-17 → 1.2.0-universal-java-17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68226a9563883914f0dafca48d0dfc67b2a9e93be8b69c660a326ae3da728616
-  data.tar.gz: 0110e43f06bcfbab825d3c042a7b5ee2edd5cd92d71c6fdab7262038a2b7b776
+  metadata.gz: 743de4af671f1321c015f1c9c98b17d755d3addd017329f61840d80bc3e50ba5
+  data.tar.gz: 5fc1d28448949c4478d8e0d8cc9f34f1cf4ef8140e7a8fe7e74972a5dd32c84e
 SHA512:
-  metadata.gz: 886325ce4e88efd712d4bf7ed2a539e0bb8b7ab1c6662d653961056546c5fe6f39481eb0cbab47fbe9c86b59962779123ab18da7bffb0e392cf8a4866711fbb5
-  data.tar.gz: 9e89d843286930d08812680d51febf2e388ea75486de44449264ec1a0d19267e91d122f77c61b9edff327a35cb03ab1076dba8d743b8d0362c57fe51fef14269
+  metadata.gz: e0a2812e76491d84f81560200741c29a85b685b1c35f5d9ae64e9660890b6c908779feb654cbbb75d0f917634ffee8ea7cadc6726e88e3b402f0ecadcb70b45e
+  data.tar.gz: 8d0710fe87d9eab9e5379c84bd69ef053b7bb241e1cd243c133cb37951789eaae2efebaeb2fc8d5ad9cdae27edf919e87cc7dcd46374f54c169195cd06d72ebf

data/lib/yggdrasil_engine.rb

@@ -1,5 +1,6 @@
 require 'ffi'
 require 'json'
+require 'logger'
 require 'custom_strategy'
 
 TOGGLE_MISSING_RESPONSE = 'NotFound'.freeze
@@ -69,6 +70,21 @@ class YggdrasilEngine
 
   attach_function :list_known_toggles, [:pointer], :pointer
 
+  attach_function :define_counter, %i[pointer string string], :pointer
+  attach_function :inc_counter, %i[pointer string int64 string], :pointer
+  attach_function :collect_impact_metrics, [:pointer], :pointer
+  attach_function :restore_impact_metrics, %i[pointer string], :pointer
+  attach_function :define_gauge, %i[pointer string string], :pointer
+  attach_function :set_gauge, %i[pointer string double string], :pointer
+  attach_function :define_histogram, %i[pointer string string string], :pointer
+  attach_function :observe_histogram, %i[pointer string double string], :pointer
+
+  class << self
+    attr_accessor :logger
+  end
+
+  self.logger = Logger.new($stderr, level: Logger::WARN)
+
   def initialize
     @engine = YggdrasilEngine.new_engine
     @custom_strategy_handler = CustomStrategyHandler.new
@@ -83,6 +99,9 @@ class YggdrasilEngine
     @custom_strategy_handler.update_strategies(toggles)
     response_ptr = YggdrasilEngine.take_state(@engine, toggles)
     take_toggles_response = JSON.parse(response_ptr.read_string, symbolize_names: true)
+    if take_toggles_response[:status_code] == ERROR_RESPONSE
+      self.class.logger.error("Error taking state, flags were not updated: #{take_toggles_response[:error_message]}")
+    end
     YggdrasilEngine.free_response(response_ptr)
   end
 
@@ -93,7 +112,7 @@ class YggdrasilEngine
        response = JSON.parse(response_json, symbolize_names: true)
 
        raise "Error: #{response[:error_message]}" if response[:status_code] == ERROR_RESPONSE
-       
+
        response[:value].to_json
      ensure
        YggdrasilEngine.free_response(response_ptr)
@@ -157,4 +176,67 @@ class YggdrasilEngine
   def register_custom_strategies(strategies)
     @custom_strategy_handler.register_custom_strategies(strategies)
   end
+
+  def define_counter(name, help_text)
+    response_ptr = YggdrasilEngine.define_counter(@engine, name, help_text)
+    handle_response(response_ptr)
+  end
+
+  def inc_counter(name, value = 1, labels = nil)
+    labels_json = labels&.to_json
+    response_ptr = YggdrasilEngine.inc_counter(@engine, name, value, labels_json)
+    handle_response(response_ptr)
+  end
+
+  def collect_impact_metrics
+    response_ptr = YggdrasilEngine.collect_impact_metrics(@engine)
+    response_json = response_ptr.read_string
+    YggdrasilEngine.free_response(response_ptr)
+    response = JSON.parse(response_json, symbolize_names: true)
+
+    raise "Error: #{response[:error_message]}" if response[:status_code] == ERROR_RESPONSE
+
+    response[:value] || []
+  end
+
+  def restore_impact_metrics(metrics)
+    metrics_json = metrics.to_json
+    response_ptr = YggdrasilEngine.restore_impact_metrics(@engine, metrics_json)
+    handle_response(response_ptr)
+  end
+
+  def define_gauge(name, help_text)
+    response_ptr = YggdrasilEngine.define_gauge(@engine, name, help_text)
+    handle_response(response_ptr)
+  end
+
+  def set_gauge(name, value, labels = nil)
+    labels_json = labels&.to_json
+    response_ptr = YggdrasilEngine.set_gauge(@engine, name, value, labels_json)
+    handle_response(response_ptr)
+  end
+
+  def define_histogram(name, help_text, buckets = nil)
+    buckets_json = (buckets || []).to_json
+    response_ptr = YggdrasilEngine.define_histogram(@engine, name, help_text, buckets_json)
+    handle_response(response_ptr)
+  end
+
+  def observe_histogram(name, value, labels = nil)
+    labels_json = labels&.to_json
+    response_ptr = YggdrasilEngine.observe_histogram(@engine, name, value, labels_json)
+    handle_response(response_ptr)
+  end
+
+  private
+
+  def handle_response(response_ptr)
+    response_json = response_ptr.read_string
+    YggdrasilEngine.free_response(response_ptr)
+    response = JSON.parse(response_json, symbolize_names: true)
+
+    raise "Error: #{response[:error_message]}" if response[:status_code] == ERROR_RESPONSE
+
+    nil
+  end
 end

data/spec/impact_metrics_spec.rb

@@ -0,0 +1,166 @@
+require 'rspec'
+require 'json'
+require_relative '../lib/yggdrasil_engine'
+
+RSpec.describe YggdrasilEngine do
+  let(:yggdrasil_engine) { YggdrasilEngine.new }
+
+  describe '#inc_counter' do
+    it 'should increment counter value' do
+      yggdrasil_engine.define_counter('test_counter', 'Test counter')
+      yggdrasil_engine.inc_counter('test_counter', 5)
+      yggdrasil_engine.inc_counter('test_counter', 3)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      counter = metrics.find { |m| m[:name] == 'test_counter' }
+
+      expect(counter).not_to be_nil
+      expect(counter[:help]).to eq('Test counter')
+      expect(counter[:samples].length).to eq(1)
+      expect(counter[:samples][0][:value]).to eq(8)
+    end
+
+    it 'should increment counter with labels' do
+      yggdrasil_engine.define_counter('test_counter', 'Test counter')
+      yggdrasil_engine.inc_counter('test_counter', 5, { 'env' => 'test' })
+      yggdrasil_engine.inc_counter('test_counter', 3, { 'env' => 'prod' })
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      counter = metrics.find { |m| m[:name] == 'test_counter' }
+
+      expect(counter).not_to be_nil
+      expect(counter[:samples].length).to eq(2)
+
+      test_sample = counter[:samples].find { |s| s[:labels][:env] == 'test' }
+      prod_sample = counter[:samples].find { |s| s[:labels][:env] == 'prod' }
+
+      expect(test_sample[:value]).to eq(5)
+      expect(prod_sample[:value]).to eq(3)
+    end
+  end
+
+  describe '#set_gauge' do
+    it 'should set gauge value' do
+      yggdrasil_engine.define_gauge('test_gauge', 'Test gauge')
+      yggdrasil_engine.set_gauge('test_gauge', 5.5)
+      yggdrasil_engine.set_gauge('test_gauge', 10.7)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      gauge = metrics.find { |m| m[:name] == 'test_gauge' }
+
+      expect(gauge).not_to be_nil
+      expect(gauge[:help]).to eq('Test gauge')
+      expect(gauge[:samples].length).to eq(1)
+      expect(gauge[:samples][0][:value]).to eq(10.7)
+    end
+
+    it 'should set gauge with labels' do
+      yggdrasil_engine.define_gauge('test_gauge', 'Test gauge')
+      yggdrasil_engine.set_gauge('test_gauge', 5.25, { 'env' => 'test' })
+      yggdrasil_engine.set_gauge('test_gauge', 3.14, { 'env' => 'prod' })
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      gauge = metrics.find { |m| m[:name] == 'test_gauge' }
+
+      expect(gauge).not_to be_nil
+      expect(gauge[:samples].length).to eq(2)
+
+      test_sample = gauge[:samples].find { |s| s[:labels][:env] == 'test' }
+      prod_sample = gauge[:samples].find { |s| s[:labels][:env] == 'prod' }
+
+      expect(test_sample[:value]).to eq(5.25)
+      expect(prod_sample[:value]).to eq(3.14)
+    end
+  end
+
+  describe '#observe_histogram' do
+    it 'should observe histogram values' do
+      yggdrasil_engine.define_histogram('request_duration', 'Request duration', [0.1, 0.5, 1.0, 5.0])
+      yggdrasil_engine.observe_histogram('request_duration', 0.05)
+      yggdrasil_engine.observe_histogram('request_duration', 0.75)
+      yggdrasil_engine.observe_histogram('request_duration', 3.0)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      histogram = metrics.find { |m| m[:name] == 'request_duration' }
+
+      expect(histogram).not_to be_nil
+      expect(histogram[:help]).to eq('Request duration')
+      expect(histogram[:type]).to eq('histogram')
+      expect(histogram[:samples].length).to eq(1)
+    end
+
+    it 'should observe histogram with labels' do
+      yggdrasil_engine.define_histogram('request_duration', 'Request duration', [0.1, 0.5, 1.0, 5.0])
+      yggdrasil_engine.observe_histogram('request_duration', 0.05, { 'env' => 'test' })
+      yggdrasil_engine.observe_histogram('request_duration', 0.75, { 'env' => 'prod' })
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      histogram = metrics.find { |m| m[:name] == 'request_duration' }
+
+      expect(histogram).not_to be_nil
+      expect(histogram[:samples].length).to eq(2)
+
+      test_sample = histogram[:samples].find { |s| s[:labels][:env] == 'test' }
+      prod_sample = histogram[:samples].find { |s| s[:labels][:env] == 'prod' }
+
+      expect(test_sample).not_to be_nil
+      expect(prod_sample).not_to be_nil
+    end
+  end
+
+  describe '#define_histogram' do
+    it 'should define histogram with default buckets' do
+      yggdrasil_engine.define_histogram('request_duration', 'Request duration')
+      yggdrasil_engine.observe_histogram('request_duration', 0.05)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      histogram = metrics.find { |m| m[:name] == 'request_duration' }
+
+      expect(histogram).not_to be_nil
+      expect(histogram[:type]).to eq('histogram')
+      expect(histogram[:samples].length).to eq(1)
+    end
+  end
+
+  describe '#collect_impact_metrics' do
+    it 'should return empty list when no metrics' do
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      expect(metrics).to eq([])
+    end
+  end
+
+  describe '#restore_impact_metrics' do
+    it 'should restore impact metrics' do
+      yggdrasil_engine.define_counter('test_counter', 'Test counter')
+      yggdrasil_engine.inc_counter('test_counter', 10)
+      yggdrasil_engine.define_gauge('test_gauge', 'Test gauge')
+      yggdrasil_engine.set_gauge('test_gauge', 42)
+      yggdrasil_engine.define_histogram('test_histogram', 'Test histogram', [0.1, 0.5, 1.0])
+      yggdrasil_engine.observe_histogram('test_histogram', 0.25)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      expect(metrics.length).to eq(3)
+
+      counter = metrics.find { |m| m[:name] == 'test_counter' }
+      gauge = metrics.find { |m| m[:name] == 'test_gauge' }
+      histogram = metrics.find { |m| m[:name] == 'test_histogram' }
+
+      expect(counter[:samples][0][:value]).to eq(10)
+      expect(gauge[:samples][0][:value]).to eq(42)
+      expect(histogram).not_to be_nil
+
+      yggdrasil_engine.restore_impact_metrics(metrics)
+
+      restored_metrics = yggdrasil_engine.collect_impact_metrics()
+      expect(restored_metrics.length).to eq(3)
+
+      restored_counter = restored_metrics.find { |m| m[:name] == 'test_counter' }
+      restored_gauge = restored_metrics.find { |m| m[:name] == 'test_gauge' }
+      restored_histogram = restored_metrics.find { |m| m[:name] == 'test_histogram' }
+
+      expect(restored_counter[:samples][0][:value]).to eq(10)
+      expect(restored_gauge[:samples][0][:value]).to eq(42)
+      expect(restored_histogram).not_to be_nil
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: yggdrasil-engine
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: universal-java-17
 authors:
 - Unleash
 bindir: bin
 cert_chain: []
-date: 2023-06-28 00:00:00.000000000 Z
+date: 2026-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.16.3
+        version: 1.17.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.16.3
+        version: 1.17.2
 description: "..."
 email: liquidwicked64@gmail.com
 executables: []
@@ -39,14 +39,16 @@ files:
 - lib/libyggdrasilffi_x86_64.so
 - lib/yggdrasil_engine.rb
 - lib/yggdrasilffi_arm64.dll
+- lib/yggdrasilffi_i686.dll
 - lib/yggdrasilffi_x86_64.dll
 - spec/custom_strategy_spec.rb
+- spec/impact_metrics_spec.rb
 - spec/yggdrasil_engine_spec.rb
-homepage: http://github.com/username/my_gem
+homepage: https://github.com/Unleash/yggdrasil-bindings
 licenses:
 - MIT
 metadata:
-  yggdrasil_core_version: 0.18.1
+  yggdrasil_core_version: 0.20.0
 rdoc_options: []
 require_paths:
 - lib