amplitude-experiment 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d05f9400e7dd25e87eb6f372c0c1c7fa5c083fe392a75dd25152e0ad0c010a1
-  data.tar.gz: 19df424d3a56c5a44d6495282f3e1f5022e1a50c47b4a5e0fcfc53c0535576ea
+  metadata.gz: c510533f1277e5400d2b4b82e43703668676cef6f0077c0894e8f7e502f112a0
+  data.tar.gz: cfe5c55993a65b66807ad3c67f0856f077fc0b7c70a9ac7a69ee0b6d26e52b72
 SHA512:
-  metadata.gz: 4e2e412e261f918990f23890200e9dc7b2cf0ed5b52e38fe585f10a3bd84f3b2d062c21a60dbf6811fdf27c395635f214f433d5dfb77c5573e3ae7e82a803352
-  data.tar.gz: 3bde003e6e5cb0d8b139218d408c5235949bed823f6973fb3f45f3eb542d7adfc7cdfe74f416bf62f06d6cd910eace6490bb6e4e3e6a0b7ef8f4abe686c854b4
+  metadata.gz: 34857d29d97eadbe26fa887fe26b4ee75f7ca358a9508dc5af3221af184e516e027f467d1726ec67734f842b5dd9e9dded521245aaed9e8c2d1f84a2e99708c2
+  data.tar.gz: 9cde9399703105c0b971a3596e58a817c10046dce2ce52468286608bf3bfc4ef9428710be0bc0a8e706bda692a185e44ce1cd5d2965edd786542ed07454d6972

data/lib/amplitude/processor.rb

@@ -87,7 +87,7 @@ module AmplitudeAnalytics
         @configuration.callback.call(event, code, message) if @configuration.callback.respond_to?(:call)
         event.callback(code, message)
       rescue StandardError => e
-        @configuration.logger.exception("Error callback for event #{event}: #{e.message}")
+        @configuration.logger.error("Error callback for event #{event}: #{e.message}")
       end
     end
 

data/lib/amplitude/timeline.rb

@@ -49,7 +49,7 @@ module AmplitudeAnalytics
         @plugins[PluginType::DESTINATION].each do |destination|
           destination_futures << destination.flush
         rescue StandardError
-          logger.exception('Error for flush events')
+          logger.error('Error for flush events')
         end
       end
       destination_futures

data/lib/experiment/local/client.rb

@@ -14,14 +14,9 @@ module AmplitudeExperiment
     def initialize(api_key, config = nil)
       @api_key = api_key
       @config = config || LocalEvaluationConfig.new
+      @logger = @config.logger
       @flags = nil
       @flags_mutex = Mutex.new
-      @logger = Logger.new($stdout)
-      @logger.level = if @config.debug
-                        Logger::DEBUG
-                      else
-                        Logger::INFO
-                      end
       raise ArgumentError, 'Experiment API key is empty' if @api_key.nil? || @api_key.empty?
 
       @engine = Evaluation::Engine.new

data/lib/experiment/local/config.rb

@@ -1,3 +1,5 @@
+require 'logger'
+
 module AmplitudeExperiment
   module ServerZone
     US = 'US'.freeze
@@ -9,11 +11,17 @@ module AmplitudeExperiment
     # Default server url
     DEFAULT_SERVER_URL = 'https://api.lab.amplitude.com'.freeze
     EU_SERVER_URL = 'https://flag.lab.eu.amplitude.com'.freeze
+    DEFAULT_LOGDEV = $stdout
+    DEFAULT_LOG_LEVEL = Logger::ERROR
 
     # Set to true to log some extra information to the console.
     # @return [Boolean] the value of debug
     attr_accessor :debug
 
+    # Set the client logger to a user defined [Logger]
+    # @return [Logger] the logger instance of the client
+    attr_accessor :logger
+
     # The server endpoint from which to request variants.
     # @return [String] the value of server url
     attr_accessor :server_url
@@ -35,16 +43,26 @@ module AmplitudeExperiment
     attr_accessor :cohort_sync_config
 
     # @param [Boolean] debug Set to true to log some extra information to the console.
+    # @param [Logger] logger instance to be used for all client logging behavior
     # @param [String] server_url The server endpoint from which to request variants.
     # @param [String] server_zone Location of the Amplitude data center to get flags and cohorts from, US or EU
     # @param [Hash] bootstrap The value of bootstrap.
     # @param [long] flag_config_polling_interval_millis The value of flag config polling interval in million seconds.
     # @param [AssignmentConfig] assignment_config Configuration for automatically tracking assignment events after an evaluation.
     # @param [CohortSyncConfig] cohort_sync_config Configuration for downloading cohorts required for flag evaluation
-    def initialize(server_url: DEFAULT_SERVER_URL, server_zone: ServerZone::US, bootstrap: {},
-                   flag_config_polling_interval_millis: 30_000, debug: false, assignment_config: nil,
+    def initialize(server_url: DEFAULT_SERVER_URL,
+                   server_zone: ServerZone::US,
+                   bootstrap: {},
+                   flag_config_polling_interval_millis: 30_000,
+                   debug: false,
+                   logger: nil,
+                   assignment_config: nil,
                    cohort_sync_config: nil)
-      @debug = debug || false
+      @logger = logger
+      if logger.nil?
+        @logger = Logger.new(DEFAULT_LOGDEV)
+        @logger.level = debug ? Logger::DEBUG : DEFAULT_LOG_LEVEL
+      end
       @server_url = server_url
       @server_zone = server_zone
       @cohort_sync_config = cohort_sync_config

data/lib/experiment/remote/client.rb

@@ -13,12 +13,7 @@ module AmplitudeExperiment
     def initialize(api_key, config = nil)
       @api_key = api_key
       @config = config || RemoteEvaluationConfig.new
-      @logger = Logger.new($stdout)
-      @logger.level = if @config.debug
-                        Logger::DEBUG
-                      else
-                        Logger::INFO
-                      end
+      @logger = @config.logger
       endpoint = "#{@config.server_url}/sdk/v2/vardata?v=0"
       @uri = URI(endpoint)
       raise ArgumentError, 'Experiment API key is empty' if @api_key.nil? || @api_key.empty?

data/lib/experiment/remote/config.rb

@@ -1,13 +1,21 @@
+require 'logger'
+
 module AmplitudeExperiment
   # Configuration
   class RemoteEvaluationConfig
     # Default server url
     DEFAULT_SERVER_URL = 'https://api.lab.amplitude.com'.freeze
+    DEFAULT_LOGDEV = $stdout
+    DEFAULT_LOG_LEVEL = Logger::ERROR
 
     # Set to true to log some extra information to the console.
     # @return [Boolean] the value of debug
     attr_accessor :debug
 
+    # Set the client logger to a user defined [Logger]
+    # @return [Logger] the logger instance of the client
+    attr_accessor :logger
+
     # The server endpoint from which to request variants.
     # @return [Boolean] the value of server url
     attr_accessor :server_url
@@ -43,6 +51,7 @@ module AmplitudeExperiment
     attr_accessor :fetch_retry_timeout_millis
 
     # @param [Boolean] debug Set to true to log some extra information to the console.
+    # @param [Logger] logger instance to be used for all client logging behavior
     # @param [String] server_url The server endpoint from which to request variants.
     # @param [Integer] connect_timeout_millis The request connection open timeout, in milliseconds, used when
     #  fetching variants triggered by calling start() or setUser().
@@ -55,10 +64,21 @@ module AmplitudeExperiment
     #  greater than the max, the max is used for all subsequent retries.
     # @param [Float] fetch_retry_backoff_scalar Scales the minimum backoff exponentially.
     # @param [Integer] fetch_retry_timeout_millis The request timeout for retrying fetch requests.
-    def initialize(debug: false, server_url: DEFAULT_SERVER_URL, connect_timeout_millis: 60_000, fetch_timeout_millis: 10_000, fetch_retries: 0,
-                   fetch_retry_backoff_min_millis: 500, fetch_retry_backoff_max_millis: 10_000,
-                   fetch_retry_backoff_scalar: 1.5, fetch_retry_timeout_millis: 10_000)
-      @debug = debug
+    def initialize(debug: false,
+                   logger: nil,
+                   server_url: DEFAULT_SERVER_URL,
+                   connect_timeout_millis: 60_000,
+                   fetch_timeout_millis: 10_000,
+                   fetch_retries: 0,
+                   fetch_retry_backoff_min_millis: 500,
+                   fetch_retry_backoff_max_millis: 10_000,
+                   fetch_retry_backoff_scalar: 1.5,
+                   fetch_retry_timeout_millis: 10_000)
+      @logger = logger
+      if logger.nil?
+        @logger = Logger.new(DEFAULT_LOGDEV)
+        @logger.level = debug ? Logger::DEBUG : DEFAULT_LOG_LEVEL
+      end
       @server_url = server_url
       @connect_timeout_millis = connect_timeout_millis
       @fetch_timeout_millis = fetch_timeout_millis

data/lib/experiment/version.rb

@@ -1,3 +1,3 @@
 module AmplitudeExperiment
-  VERSION = '1.6.0'.freeze
+  VERSION = '1.7.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amplitude-experiment
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Amplitude
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-10 00:00:00.000000000 Z
+date: 2025-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby