statsig 2.4.3 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13aa0d6726504ea7bef05a61a4663426e4b1a9fe3e7c8a5c56ade788665d5e2d
-  data.tar.gz: bd6886c09af0b6403c288c25de15d7c5f40783656dc891518469b7da030f59b2
+  metadata.gz: 9d4842b01ba9c40089bbf689984a0c9a59234d83f0d070c2570856335ad012fc
+  data.tar.gz: 44afa2a46886c397ecc2975f123d9808f08548fadd7e9703130cd6099033d159
 SHA512:
-  metadata.gz: f827849b39d1c4bc2166b8c4b2477644fd24997a2e9b840e9b87db61f051f6a564e04b9e3b1779688baf8d7c128ed3ccf4f5e277a9353ee9cdc44f57afd6b8aa
-  data.tar.gz: 613c1a21bf021fe0b68920a102e834f03ba2e7c9816175f771526daad548ad496089fbbeae0b4abb7ad179e3fe09daaf376d6d347011bfed97a2a0e164e1780c
+  metadata.gz: 13ec911e8fb874d705ace7bc92d857dfa8a71171812b822f2af2826e9f52af01d03af8661bfd42866d7c7560b5a050a9ff2e936084eb61d18a46c67555bf5ea7
+  data.tar.gz: 61c0be14ffc93a7bc0db3fe25932a09e8dab52fdb7eaf50b2e15ffef44cba975ddf5706b328ba8f9e0eef6ef0b744856b691efbfae72c247fb58a0d04465a86e

data/lib/evaluator.rb

@@ -20,6 +20,8 @@ module Statsig
 
     attr_accessor :config_overrides
 
+    attr_accessor :experiment_overrides
+
     attr_accessor :options
 
     attr_accessor :persistent_storage_utils
@@ -31,6 +33,7 @@ module Statsig
       @spec_store = store
       @gate_overrides = {}
       @config_overrides = {}
+      @experiment_overrides = {}
       @options = options
       @persistent_storage_utils = persistent_storage_utils
     end
@@ -58,19 +61,32 @@ module Statsig
 
     def lookup_config_override(config_name)
       config_name_sym = config_name.to_sym
+      if @experiment_overrides.key?(config_name_sym)
+        override = @experiment_overrides[config_name_sym]
+        return ConfigResult.new(
+          name: config_name,
+          json_value: override[:value],
+          group_name: override[:group_name],
+          rule_id: override[:rule_id],
+          evaluation_details: EvaluationDetails.local_override(
+            @spec_store.last_config_sync_time,
+            @spec_store.initial_config_sync_time
+          )
+        )
+      end
       if @config_overrides.key?(config_name_sym)
+        override = @config_overrides[config_name_sym]
         return ConfigResult.new(
           name: config_name,
-          json_value: @config_overrides[config_name_sym],
+          json_value: override,
           rule_id: Const::OVERRIDE,
-          id_type: @spec_store.has_config?(config_name) ? @spec_store.get_config(config_name)[:idType] : Const::EMPTY_STR,
           evaluation_details: EvaluationDetails.local_override(
             @spec_store.last_config_sync_time,
             @spec_store.initial_config_sync_time
           )
         )
       end
-      return nil
+      nil
     end
 
     def check_gate(user, gate_name, end_result, ignore_local_overrides: false, is_nested: false)
@@ -108,6 +124,8 @@ module Statsig
           end_result.id_type = local_override.id_type
           end_result.rule_id = local_override.rule_id
           end_result.json_value = local_override.json_value
+          end_result.group_name = local_override.group_name
+          end_result.is_experiment_group = local_override.is_experiment_group
           unless end_result.disable_evaluation_details
             end_result.evaluation_details = local_override.evaluation_details
           end
@@ -447,6 +465,37 @@ module Statsig
       @config_overrides.clear
     end
 
+    def override_experiment_by_group_name(experiment_name, group_name)
+      return unless @spec_store.has_config?(experiment_name)
+
+      config = @spec_store.get_config(experiment_name)
+      return unless config[:entity] == Const::TYPE_EXPERIMENT
+
+      config[:rules].each do |rule|
+        if rule[:groupName] == group_name
+          @experiment_overrides[experiment_name.to_sym] = {
+            value: rule[:returnValue],
+            group_name: rule[:groupName],
+            rule_id: rule[:id],
+            evaluation_details: EvaluationDetails.local_override(@config_sync_time, @init_time)
+          }
+          return
+        end
+      end
+
+      # If no matching rule is found, create a default override with empty value
+      @experiment_overrides[experiment_name.to_sym] = {
+        value: {},
+        group_name: group_name,
+        rule_id: "#{experiment_name}:override",
+        evaluation_details: EvaluationDetails.local_override(@config_sync_time, @init_time)
+      }
+    end
+
+    def clear_experiment_overrides
+      @experiment_overrides.clear
+    end
+
     def eval_spec(config_name, user, config, end_result, is_nested: false)
       config[:rules].each do |rule|
         end_result.sampling_rate = rule[:samplingRate]

data/lib/memo.rb

@@ -3,7 +3,11 @@ module Statsig
 
     @global_memo = {}
 
-    def self.for(hash, method, key)
+    def self.for(hash, method, key, disable_evaluation_memoization: false)
+      if disable_evaluation_memoization
+        return yield
+      end
+
       if key != nil
         method_hash = hash[method]
         unless method_hash

data/lib/statsig.rb

@@ -328,6 +328,17 @@ module Statsig
     @shared_instance&.override_config(config_name, config_value)
   end
 
+
+  ##
+  # Overrides an experiment to return the value for a specific group name.
+  #
+  # @param experiment_name The name of the experiment to be overridden
+  # @param group_name The name of the group whose value should be returned
+  def self.override_experiment_by_group_name(experiment_name, group_name)
+    ensure_initialized
+    @shared_instance&.override_experiment_by_group_name(experiment_name, group_name)
+  end
+
   def self.remove_config_override(config_name)
     ensure_initialized
     @shared_instance&.remove_config_override(config_name)
@@ -338,6 +349,11 @@ module Statsig
     @shared_instance&.clear_config_overrides
   end
 
+  def self.clear_experiment_overrides
+    ensure_initialized
+    @shared_instance&.clear_experiment_overrides
+  end
+
   ##
   # @param [HashTable] debug information log with exposure events
   def self.set_debug_info(debug_info)
@@ -370,11 +386,15 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.4.3',
+      'sdkVersion' => '2.5.0',
       'languageVersion' => RUBY_VERSION
     }
   end
 
+  def self.get_options
+    @driver&.instance_variable_get(:@options)
+  end
+
   private
 
   def self.ensure_initialized

data/lib/statsig_driver.rb

@@ -65,7 +65,7 @@ class StatsigDriver
 
     user = verify_inputs(user, gate_name, 'gate_name')
 
-    Statsig::Memo.for(user.get_memo, :get_gate_impl, gate_name) do
+    Statsig::Memo.for(user.get_memo, :get_gate_impl, gate_name, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
       res = Statsig::ConfigResult.new(
         name: gate_name,
         disable_exposures: disable_log_exposure,
@@ -171,7 +171,7 @@ class StatsigDriver
     @err_boundary.capture(caller: __method__, recover: -> { Layer.new(layer_name) }) do
       run_with_diagnostics(caller: :get_layer) do
         user = verify_inputs(user, layer_name, "layer_name")
-        Statsig::Memo.for(user.get_memo, :get_layer, layer_name) do
+        Statsig::Memo.for(user.get_memo, :get_layer, layer_name, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
           exposures_disabled = options&.disable_log_exposure == true
           res = Statsig::ConfigResult.new(
             name: layer_name,
@@ -304,6 +304,12 @@ class StatsigDriver
     end
   end
 
+  def clear_experiment_overrides
+    @err_boundary.capture(caller: __method__) do
+      @evaluator.clear_experiment_overrides
+    end
+  end
+
   def set_debug_info(debug_info)
     @err_boundary.capture(caller: __method__) do
       @logger.set_debug_info(debug_info)
@@ -337,6 +343,10 @@ class StatsigDriver
     end
   end
 
+  def override_experiment_by_group_name(experiment_name, group_name)
+    @evaluator.override_experiment_by_group_name(experiment_name, group_name)
+  end
+
   private
 
   def run_with_diagnostics(caller:)
@@ -361,7 +371,7 @@ class StatsigDriver
 
   def verify_inputs(user, config_name, variable_name)
     validate_user(user)
-    user = Statsig::Memo.for(user.get_memo(), :verify_inputs, 0) do
+    user = Statsig::Memo.for(user.get_memo(), :verify_inputs, 0, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
       user = normalize_user(user)
       check_shutdown
       maybe_restart_background_threads
@@ -376,7 +386,7 @@ class StatsigDriver
   end
 
   def get_config_impl(user, config_name, disable_log_exposure, user_persisted_values: nil, disable_evaluation_details: false, ignore_local_overrides: false)
-    Statsig::Memo.for(user.get_memo, :get_config_impl, config_name) do
+    Statsig::Memo.for(user.get_memo, :get_config_impl, config_name, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
       res = Statsig::ConfigResult.new(
         name: config_name,
         disable_exposures: disable_log_exposure,

data/lib/statsig_event.rb

@@ -1,4 +1,3 @@
-
 class StatsigEvent
   attr_accessor :value, :metadata, :statsig_metadata, :secondary_exposures
   attr_reader :user
@@ -15,7 +14,7 @@ class StatsigEvent
 
   def user=(value)
     if value.is_a?(StatsigUser)
-      @user = Statsig::Memo.for(value.get_memo(), :serialize, 0) do
+      @user = Statsig::Memo.for(value.get_memo(), :serialize, 0, disable_evaluation_memoization: Statsig.get_options&.disable_evaluation_memoization) do
         value.serialize(true)
       end
     end

data/lib/statsig_options.rb

@@ -88,6 +88,10 @@ class StatsigOptions
   # Implements Statsig::Interfaces::IUserPersistentStorage.
   attr_accessor :user_persistent_storage
 
+  # Disable memoization of evaluation results. When true, each evaluation will be performed fresh.
+  # default: false
+  attr_accessor :disable_evaluation_memoization
+
   def initialize(
     environment = nil,
     download_config_specs_url: nil,
@@ -110,7 +114,8 @@ class StatsigOptions
     network_timeout: nil,
     post_logs_retry_limit: 3,
     post_logs_retry_backoff: nil,
-    user_persistent_storage: nil
+    user_persistent_storage: nil,
+    disable_evaluation_memoization: false
   )
     @environment = environment.is_a?(Hash) ? environment : nil
 
@@ -140,6 +145,6 @@ class StatsigOptions
     @post_logs_retry_limit = post_logs_retry_limit
     @post_logs_retry_backoff = post_logs_retry_backoff
     @user_persistent_storage = user_persistent_storage
-
+    @disable_evaluation_memoization = disable_evaluation_memoization
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.4.3
+  version: 2.5.0
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-22 00:00:00.000000000 Z
+date: 2025-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler