eppo-server-sdk 0.1.0 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d2f2b75ea023c388c50b7db7ad56e017b217c21811310116938f35409153520
-  data.tar.gz: 1fb5b4873b50f1197fcec8ea91ab071d8a5a75c7790e8cd956f011c621a88425
+  metadata.gz: d9c570d34608a7d3037d80c5aa161c383e2d7b618eef75383f53d002e772204a
+  data.tar.gz: 6fd21d3000781bada11f2f43b49fce0871fc74b1929387bddf277a1cb3c5db7f
 SHA512:
-  metadata.gz: debd90881651fa4d3f85d6af2ce71673c59378b3238f7443a2b851f16a762f667198e61f8494d28957da2ecb28dc896c5a99564a54e6fb5ec14ddde0c1a4c06a
-  data.tar.gz: 2559d1d149a37e6dd8f6779511e72532a7a4046feda48e9657939de1db34ba30d2c5d52b5df6d413279f67ff4d9cfcd03a5b905bc723e0d13c236be5295e3a66
+  metadata.gz: 27fbeb76e52adcce05cffa3a41e92b09790db53e76dafa4ded3d5d7df4d6b4cce37cb7c79056153d6965ec01d579a42a3140b88626c26c0eebe3874cde49dee4
+  data.tar.gz: 3a1f20881a19c385e4c37c141045d8e870d85fc81f650d07a736b4c8f39b8ebba0a24380231da334c40a51c8b49b3431a2096746d3e9d4f2fdaaa8d382e568c4

data/lib/{assignment_logger.rb → eppo_client/assignment_logger.rb}

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'custom_errors'
+require_relative 'custom_errors'
 
 module EppoClient
   # The base assignment logger class to override

data/lib/eppo_client/client.rb

@@ -0,0 +1,238 @@
+# frozen_string_literal: true
+
+require 'singleton'
+require 'time'
+
+require_relative 'constants'
+require_relative 'custom_errors'
+require_relative 'rules'
+require_relative 'shard'
+require_relative 'validation'
+require_relative 'variation_type'
+
+module EppoClient
+  # The main client singleton
+  # rubocop:disable Metrics/ClassLength
+  class Client
+    extend Gem::Deprecate
+    include Singleton
+    attr_accessor :config_requestor, :assignment_logger, :poller
+
+    def instance
+      Client.instance
+    end
+
+    def get_string_assignment(
+      subject_key,
+      flag_key,
+      subject_attributes = {},
+      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
+    )
+      logger = Logger.new($stdout)
+      logger.level = log_level
+      assigned_variation = get_assignment_variation(
+        subject_key, flag_key, subject_attributes,
+        EppoClient::VariationType::STRING_TYPE, logger
+      )
+      assigned_variation&.typed_value
+    end
+
+    def get_numeric_assignment(
+      subject_key,
+      flag_key,
+      subject_attributes = {},
+      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
+    )
+      logger = Logger.new($stdout)
+      logger.level = log_level
+      assigned_variation = get_assignment_variation(
+        subject_key, flag_key, subject_attributes,
+        EppoClient::VariationType::NUMERIC_TYPE, logger
+      )
+      assigned_variation&.typed_value
+    end
+
+    def get_boolean_assignment(
+      subject_key,
+      flag_key,
+      subject_attributes = {},
+      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
+    )
+      logger = Logger.new($stdout)
+      logger.level = log_level
+      assigned_variation = get_assignment_variation(
+        subject_key, flag_key, subject_attributes,
+        EppoClient::VariationType::BOOLEAN_TYPE, logger
+      )
+      assigned_variation&.typed_value
+    end
+
+    def get_parsed_json_assignment(
+      subject_key,
+      flag_key,
+      subject_attributes = {},
+      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
+    )
+      logger = Logger.new($stdout)
+      logger.level = log_level
+      assigned_variation = get_assignment_variation(
+        subject_key, flag_key, subject_attributes,
+        EppoClient::VariationType::JSON_TYPE, logger
+      )
+      assigned_variation&.typed_value
+    end
+
+    def get_json_string_assignment(
+      subject_key,
+      flag_key,
+      subject_attributes = {},
+      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
+    )
+      logger = Logger.new($stdout)
+      logger.level = log_level
+      assigned_variation = get_assignment_variation(
+        subject_key, flag_key, subject_attributes,
+        EppoClient::VariationType::JSON_TYPE, logger
+      )
+      assigned_variation&.value
+    end
+
+    def get_assignment(
+      subject_key,
+      flag_key,
+      subject_attributes = {},
+      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
+    )
+      logger = Logger.new($stdout)
+      logger.level = log_level
+      assigned_variation = get_assignment_variation(subject_key, flag_key,
+                                                    subject_attributes, nil,
+                                                    logger)
+      assigned_variation&.value
+    end
+    deprecate :get_assignment, 'the get_<typed>_assignment methods', 2024, 1
+
+    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+    def get_assignment_variation(
+      subject_key,
+      flag_key,
+      subject_attributes,
+      expected_variation_type,
+      logger
+    )
+      EppoClient.validate_not_blank('subject_key', subject_key)
+      EppoClient.validate_not_blank('flag_key', flag_key)
+      experiment_config = @config_requestor.get_configuration(flag_key)
+      override = get_subject_variation_override(experiment_config, subject_key)
+      unless override.nil?
+        unless expected_variation_type.nil?
+          variation_is_expected_type =
+            EppoClient::VariationType.expected_type?(
+              override, expected_variation_type
+            )
+          return nil unless variation_is_expected_type
+        end
+        return override
+      end
+
+      if experiment_config.nil? || experiment_config.enabled == false
+        logger.debug(
+          '[Eppo SDK] No assigned variation. No active experiment or flag for '\
+          "key: #{flag_key}"
+        )
+        return nil
+      end
+
+      matched_rule = EppoClient.find_matching_rule(subject_attributes, experiment_config.rules)
+      if matched_rule.nil?
+        logger.debug(
+          '[Eppo SDK] No assigned variation. Subject attributes do not match '\
+          "targeting rules: #{subject_attributes}"
+        )
+        return nil
+      end
+
+      allocation = experiment_config.allocations[matched_rule.allocation_key]
+      unless in_experiment_sample?(
+        subject_key,
+        flag_key,
+        experiment_config.subject_shards,
+        allocation.percent_exposure
+      )
+        logger.debug(
+          '[Eppo SDK] No assigned variation. Subject is not part of experiment'\
+          ' sample population'
+        )
+        return nil
+      end
+
+      shard = EppoClient.get_shard(
+        "assignment-#{subject_key}-#{flag_key}",
+        experiment_config.subject_shards
+      )
+      assigned_variation = allocation.variations.find do |var|
+        var.shard_range.shard_in_range?(shard)
+      end
+
+      assigned_variation_value_to_log = nil
+      unless assigned_variation.nil?
+        assigned_variation_value_to_log = assigned_variation.value
+        unless expected_variation_type.nil?
+          variation_is_expected_type = EppoClient::VariationType.expected_type?(
+            assigned_variation, expected_variation_type
+          )
+          return nil unless variation_is_expected_type
+        end
+      end
+
+      assignment_event = {
+        "allocation": matched_rule.allocation_key,
+        "experiment": "#{flag_key}-#{matched_rule.allocation_key}",
+        "featureFlag": flag_key,
+        "variation": assigned_variation_value_to_log,
+        "subject": subject_key,
+        "timestamp": Time.now.utc.iso8601,
+        "subjectAttributes": subject_attributes
+      }
+
+      begin
+        @assignment_logger.log_assignment(assignment_event)
+      rescue EppoClient::AssignmentLoggerError => e
+        # Error means log_assignment was not set up. This is okay to ignore.
+      rescue StandardError => e
+        logger.error("[Eppo SDK] Error logging assignment event: #{e}")
+      end
+
+      assigned_variation
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+
+    def shutdown
+      @poller.stop
+    end
+
+    # rubocop:disable Metrics/MethodLength
+    def get_subject_variation_override(experiment_config, subject)
+      subject_hash = Digest::MD5.hexdigest(subject.to_s)
+      if experiment_config&.overrides &&
+         experiment_config.overrides[subject_hash] &&
+         experiment_config.typed_overrides[subject_hash]
+        EppoClient::VariationDto.new(
+          'override',
+          experiment_config.overrides[subject_hash],
+          experiment_config.typed_overrides[subject_hash],
+          EppoClient::ShardRange.new(0, 1000)
+        )
+      end
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    def in_experiment_sample?(subject, experiment_key, subject_shards,
+                              percent_exposure)
+      shard = EppoClient.get_shard("exposure-#{subject}-#{experiment_key}",
+                                   subject_shards)
+      shard <= percent_exposure * subject_shards
+    end
+  end
+  # rubocop:enable Metrics/ClassLength
+end

data/lib/{config.rb → eppo_client/config.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require 'validation'
-require 'assignment_logger'
+require_relative 'validation'
+require_relative 'assignment_logger'
 
 module EppoClient
   # The class for configuring the Eppo client singleton

data/lib/{configuration_requestor.rb → eppo_client/configuration_requestor.rb}

@@ -1,16 +1,17 @@
 # frozen_string_literal: true
 
-require 'custom_errors'
-require 'constants'
+require_relative 'custom_errors'
+require_relative 'constants'
 
 module EppoClient
   # A class for the variation object
   class VariationDto
-    attr_reader :name, :value, :shard_range
+    attr_reader :name, :value, :typed_value, :shard_range
 
-    def initialize(name, value, shard_range)
+    def initialize(name, value, typed_value, shard_range)
       @name = name
       @value = value
+      @typed_value = typed_value
       @shard_range = shard_range
     end
   end
@@ -27,13 +28,15 @@ module EppoClient
 
   # A class for the experiment configuration object
   class ExperimentConfigurationDto
-    attr_reader :subject_shards, :enabled, :name, :overrides, :rules, :allocations
+    attr_reader :subject_shards, :enabled, :name, :overrides,
+                :typed_overrides, :rules, :allocations
 
     def initialize(exp_config)
       @subject_shards = exp_config['subjectShards']
       @enabled = exp_config['enabled']
       @name = exp_config['name'] || nil
       @overrides = exp_config['overrides'] || {}
+      @typed_overrides = exp_config['typedOverrides'] || {}
       @rules = exp_config['rules'] || []
       @allocations = exp_config['allocations']
     end
@@ -41,7 +44,6 @@ module EppoClient
 
   # A class for getting exp configs from the local cache or API
   class ExperimentConfigurationRequestor
-
     attr_reader :config_store
 
     def initialize(http_client, config_store)
@@ -50,7 +52,8 @@ module EppoClient
     end
 
     def get_configuration(experiment_key)
-      @http_client.is_unauthorized && raise(EppoClient::UnauthorizedError, 'please check your API key')
+      @http_client.is_unauthorized && raise(EppoClient::UnauthorizedError,
+                                            'please check your API key')
       @config_store.retrieve_configuration(experiment_key)
     end
 
@@ -58,16 +61,19 @@ module EppoClient
     def fetch_and_store_configurations
       configs = {}
       begin
-        exp_configs = @http_client.get(EppoClient::RAC_ENDPOINT).fetch('flags', {})
+        exp_configs = @http_client.get(EppoClient::RAC_ENDPOINT).fetch(
+          'flags', {}
+        )
+        # rubocop: disable Metrics/BlockLength
         exp_configs.each do |exp_key, exp_config|
           exp_config['allocations'].each do |k, v|
             exp_config['allocations'][k] = EppoClient::AllocationDto.new(
               v['percentExposure'],
               v['variations'].map do |var|
                 EppoClient::VariationDto.new(
-                  var['name'],
-                  var['value'],
-                  EppoClient::ShardRange.new(var['shardRange']['start'], var['shardRange']['end'])
+                  var['name'], var['value'], var['typedValue'],
+                  EppoClient::ShardRange.new(var['shardRange']['start'],
+                                             var['shardRange']['end'])
                 )
               end
             )
@@ -84,11 +90,16 @@ module EppoClient
               allocation_key: rule['allocationKey']
             )
           end
-          configs[exp_key] = EppoClient::ExperimentConfigurationDto.new(exp_config)
+          configs[exp_key] = EppoClient::ExperimentConfigurationDto.new(
+            exp_config
+          )
         end
+        # rubocop: enable Metrics/BlockLength
         @config_store.assign_configurations(configs)
       rescue EppoClient::HttpRequestError => e
-        Logger.new($stdout).error("Error retrieving assignment configurations: #{e}")
+        Logger.new($stdout).error(
+          "Error retrieving assignment configurations: #{e}"
+        )
       end
       configs
     end

data/lib/{configuration_store.rb → eppo_client/configuration_store.rb}

@@ -2,7 +2,7 @@
 
 require 'concurrent/atomic/read_write_lock'
 
-require 'lru_cache'
+require_relative 'lru_cache'
 
 module EppoClient
   # A thread safe store for the configurations to ensure that retrievals pull from a single source of truth

data/lib/{http_client.rb → eppo_client/http_client.rb}

@@ -3,7 +3,7 @@
 require 'faraday'
 require 'faraday/retry'
 
-require 'custom_errors'
+require_relative 'custom_errors'
 
 REQUEST_TIMEOUT_SECONDS = 2
 # This applies only to failed DNS lookups and connection timeouts,

data/lib/{rules.rb → eppo_client/rules.rb}

@@ -47,7 +47,7 @@ module EppoClient
     true
   end
 
-  # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+  # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
   def evaluate_condition(subject_attributes, condition)
     subject_value = subject_attributes[condition.attribute]
     return false if subject_value.nil?
@@ -63,7 +63,7 @@ module EppoClient
       subject_value.is_a?(Numeric) && evaluate_numeric_condition(subject_value, condition)
     end
   end
-  # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+  # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
   # rubocop:disable Metrics/MethodLength
   def evaluate_numeric_condition(subject_value, condition)
@@ -82,5 +82,6 @@ module EppoClient
   end
   # rubocop:enable Metrics/MethodLength
 
-  module_function :find_matching_rule, :matches_rule, :evaluate_condition, :evaluate_numeric_condition
+  module_function :find_matching_rule, :matches_rule, :evaluate_condition,
+                  :evaluate_numeric_condition
 end

data/lib/{shard.rb → eppo_client/shard.rb}

@@ -18,6 +18,8 @@ module EppoClient
     end
   end
 
+  module_function
+
   def get_shard(input, subject_shards)
     hash_output = Digest::MD5.hexdigest(input)
     # get the first 4 bytes of the md5 hex string and parse it using base 16
@@ -25,6 +27,4 @@ module EppoClient
     int_from_hash = hash_output[0...8].to_i(16)
     int_from_hash % subject_shards
   end
-
-  module_function :get_shard
 end

data/lib/eppo_client/validation.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative 'custom_errors'
+
+# The helper module to validate keys
+module EppoClient
+  module_function
+
+  def validate_not_blank(field_name, field_value)
+    (field_value.nil? || field_value == '') && raise(
+      EppoClient::InvalidValueError, "#{field_name} cannot be blank"
+    )
+  end
+end

data/lib/eppo_client/variation_type.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module EppoClient
+  # The class for configuring the Eppo client singleton
+  module VariationType
+    STRING_TYPE = 'string'
+    NUMERIC_TYPE = 'numeric'
+    BOOLEAN_TYPE = 'boolean'
+    JSON_TYPE = 'json'
+
+    module_function
+
+    # rubocop:disable Metrics/MethodLength, Metrics/CyclomaticComplexity
+    def expected_type?(assigned_variation, expected_variation_type)
+      case expected_variation_type
+      when STRING_TYPE
+        assigned_variation.typed_value.is_a?(String)
+      when NUMERIC_TYPE
+        assigned_variation.typed_value.is_a?(Numeric)
+      when BOOLEAN_TYPE
+        assigned_variation.typed_value.is_a?(TrueClass) ||
+          assigned_variation.typed_value.is_a?(FalseClass)
+      when JSON_TYPE
+        begin
+          parsed_json = JSON.parse(assigned_variation.value)
+          JSON.dump(assigned_variation.typed_value)
+          parsed_json == assigned_variation.typed_value
+        rescue JSON::JSONError
+          false
+        end
+      else
+        false
+      end
+    end
+    # rubocop:enable Metrics/MethodLength, Metrics/CyclomaticComplexity
+  end
+end

data/lib/eppo_client/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EppoClient
+  VERSION = '0.2.3'
+end

data/lib/eppo_client.rb

@@ -1,15 +1,14 @@
 # frozen_string_literal: true
 
-require 'parse_gemspec'
-
-require 'assignment_logger'
-require 'http_client'
-require 'poller'
-require 'config'
-require 'client'
-require 'constants'
-require 'configuration_requestor'
-require 'configuration_store'
+require_relative 'eppo_client/assignment_logger'
+require_relative 'eppo_client/http_client'
+require_relative 'eppo_client/poller'
+require_relative 'eppo_client/config'
+require_relative 'eppo_client/client'
+require_relative 'eppo_client/constants'
+require_relative 'eppo_client/configuration_requestor'
+require_relative 'eppo_client/configuration_store'
+require_relative 'eppo_client/version'
 
 # This module scopes all the client SDK's classes and functions
 module EppoClient
@@ -32,13 +31,18 @@ module EppoClient
   # rubocop:disable Metrics/MethodLength
   def init(config)
     config.validate
-    sdk_version = ParseGemspec::Specification.load('eppo-server-sdk.gemspec').to_hash_object[:version]
-    sdk_params = EppoClient::SdkParams.new(config.api_key, 'ruby', sdk_version)
-    http_client = EppoClient::HttpClient.new(config.base_url, sdk_params.formatted)
-    config_store = EppoClient::ConfigurationStore.new(EppoClient::MAX_CACHE_ENTRIES)
+    sdk_params = EppoClient::SdkParams.new(config.api_key, 'ruby',
+                                           EppoClient::VERSION)
+    http_client = EppoClient::HttpClient.new(config.base_url,
+                                             sdk_params.formatted)
+    config_store = EppoClient::ConfigurationStore.new(
+      EppoClient::MAX_CACHE_ENTRIES
+    )
     config_store.lock.with_write_lock do
       EppoClient.initialize_client(
-        EppoClient::ExperimentConfigurationRequestor.new(http_client, config_store),
+        EppoClient::ExperimentConfigurationRequestor.new(
+          http_client, config_store
+        ),
         config.assignment_logger
       )
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eppo-server-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.3
 platform: ruby
 authors:
 - Eppo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-26 00:00:00.000000000 Z
+date: 2023-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -70,26 +70,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.0
-- !ruby/object:Gem::Dependency
-  name: parse_gemspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -136,14 +116,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.41'
+        version: 0.82.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.41'
+        version: 0.82.0
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -170,20 +150,22 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/assignment_logger.rb
-- lib/client.rb
-- lib/config.rb
-- lib/configuration_requestor.rb
-- lib/configuration_store.rb
-- lib/constants.rb
-- lib/custom_errors.rb
 - lib/eppo_client.rb
-- lib/http_client.rb
-- lib/lru_cache.rb
-- lib/poller.rb
-- lib/rules.rb
-- lib/shard.rb
-- lib/validation.rb
+- lib/eppo_client/assignment_logger.rb
+- lib/eppo_client/client.rb
+- lib/eppo_client/config.rb
+- lib/eppo_client/configuration_requestor.rb
+- lib/eppo_client/configuration_store.rb
+- lib/eppo_client/constants.rb
+- lib/eppo_client/custom_errors.rb
+- lib/eppo_client/http_client.rb
+- lib/eppo_client/lru_cache.rb
+- lib/eppo_client/poller.rb
+- lib/eppo_client/rules.rb
+- lib/eppo_client/shard.rb
+- lib/eppo_client/validation.rb
+- lib/eppo_client/variation_type.rb
+- lib/eppo_client/version.rb
 homepage: https://github.com/Eppo-exp/ruby-sdk
 licenses:
 - MIT
@@ -201,14 +183,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.2
+      version: 3.0.6
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.4.6
 signing_key: 
 specification_version: 4
 summary: Eppo SDK for Ruby

data/lib/client.rb

@@ -1,102 +0,0 @@
-# frozen_string_literal: true
-
-require 'singleton'
-require 'time'
-
-require 'constants'
-require 'custom_errors'
-require 'rules'
-require 'shard'
-require 'validation'
-
-module EppoClient
-  # The main client singleton
-  class Client
-    include Singleton
-    attr_accessor :config_requestor, :assignment_logger, :poller
-
-    def instance
-      Client.instance
-    end
-
-    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
-    def get_assignment(
-      subject_key,
-      flag_or_experiment_key,
-      subject_attributes = {},
-      log_level = EppoClient::DEFAULT_LOGGER_LEVEL
-    )
-      logger = Logger.new($stdout)
-      logger.level = log_level
-      EppoClient.validate_not_blank('subject_key', subject_key)
-      EppoClient.validate_not_blank('flag_or_experiment_key', flag_or_experiment_key)
-      experiment_config = @config_requestor.get_configuration(flag_or_experiment_key)
-      override = get_subject_variation_override(experiment_config, subject_key)
-      return override unless override.nil?
-
-      if experiment_config.nil? || experiment_config.enabled == false
-        logger.debug(
-          "[Eppo SDK] No assigned variation. No active experiment or flag for key: #{flag_or_experiment_key}"
-        )
-        return nil
-      end
-
-      matched_rule = EppoClient.find_matching_rule(subject_attributes, experiment_config.rules)
-      if matched_rule.nil?
-        logger.debug(
-          "[Eppo SDK] No assigned variation. Subject attributes do not match targeting rules: #{subject_attributes}"
-        )
-        return nil
-      end
-
-      allocation = experiment_config.allocations[matched_rule.allocation_key]
-      unless in_experiment_sample?(
-        subject_key,
-        flag_or_experiment_key,
-        experiment_config.subject_shards,
-        allocation.percent_exposure
-      )
-        logger.debug(
-          '[Eppo SDK] No assigned variation. Subject is not part of experiment sample population'
-        )
-        return nil
-      end
-
-      shard = EppoClient.get_shard("assignment-#{subject_key}-#{flag_or_experiment_key}", experiment_config.subject_shards)
-      assigned_variation = allocation.variations.find { |var| var.shard_range.shard_in_range?(shard) }.value
-
-      assignment_event = {
-        "experiment": flag_or_experiment_key,
-        "variation": assigned_variation,
-        "subject": subject_key,
-        "timestamp": Time.now.utc.iso8601,
-        "subjectAttributes": subject_attributes
-      }
-
-      begin
-        @assignment_logger.log_assignment(assignment_event)
-      rescue EppoClient::AssignmentLoggerError => e
-        # This error means that log_assignment was not set up. This is okay to ignore.
-      rescue StandardError => e
-        logger.error("[Eppo SDK] Error logging assignment event: #{e}")
-      end
-
-      assigned_variation
-    end
-    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
-
-    def shutdown
-      @poller.stop
-    end
-
-    def get_subject_variation_override(experiment_config, subject)
-      subject_hash = Digest::MD5.hexdigest(subject.to_s)
-      experiment_config&.overrides && experiment_config.overrides[subject_hash]
-    end
-
-    def in_experiment_sample?(subject, experiment_key, subject_shards, percent_exposure)
-      shard = EppoClient.get_shard("exposure-#{subject}-#{experiment_key}", subject_shards)
-      shard <= percent_exposure * subject_shards
-    end
-  end
-end

data/lib/validation.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require 'custom_errors'
-
-# The helper module to validate keys
-module EppoClient
-  def validate_not_blank(field_name, field_value)
-    (field_value.nil? || field_value == '') && raise(EppoClient::InvalidValueError, "#{field_name} cannot be blank")
-  end
-
-  module_function :validate_not_blank
-end