eppo-server-sdk 3.5.1-aarch64-linux-musl → 3.7.0-aarch64-linux-musl

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6941a5ca4d4841c98bc8c4a0851bbcac648740bbb23d1705d022b4555aafb5df
-  data.tar.gz: 8c1fbbfb86e2cc42e5eefd5c942af600346d756a4d4fcf55abd9234e8049bbd5
+  metadata.gz: d2b12ba3a16c344cb94c6603cf687b8142b1b5104511f856d584615fd2e34fbd
+  data.tar.gz: c66093838020f9eaf1ef68502a640a62255019dc58dbe560d927eaffd4384070
 SHA512:
-  metadata.gz: c089114a7d8efbc30f6357b5e75766c59ccc232ca99915f6ee4699393037b910f163c5c5384fd0171467bc6c6f4ab290add933edf2569313bf00cc81ba018cd2
-  data.tar.gz: 8accb234fb188e19be1e9f1cb317e6456ebda0efe28776495d57a04b48357cede9f09060ba8a716bea14beff30031b890c49bcf44196cf00dea613c13b2d23fc
+  metadata.gz: 3eb96240cd52815e8b903e58182fc29b5dafee3ce5512e7b5583893e6a3157c85313e0af9aa34dde69dd9c23f125971d5d0d39173f9ccb74f3102d26dc3c42c4
+  data.tar.gz: 2612376e28b9430593a1c06db623678a64c418a818a60fb6777046551af8e0df7caf1c2791c16b06aeb7767b95cf2f29624bb0ef35a4f7f1206af9d2cc13ec05

data/lib/eppo_client/client.rb

@@ -31,64 +31,210 @@ module EppoClient
       @core = EppoClient::Core::Client.new(config)
     end
 
+    ##
+    # Waits for client to fetch configuration and get ready to serve
+    # assignments.
+    #
+    # This method blocks the current thread until configuration is
+    # successfully fetched or +timeout+ seconds passed.
+    #
+    # Note: this method returns immediately if configuration poller
+    # has been disabled.
+    #
+    # @param timeout [Numeric] Maximum time to wait in seconds
+    # @return [nil]
+    def wait_for_initialization(timeout=1)
+      return unless @core
+      @core.wait_for_initialization(timeout)
+    end
+
+    ##
+    # Returns the currently active configuration.
     def configuration
       @core.configuration
     end
 
+    ##
+    # Sets the currently active configuration.
     def configuration=(configuration)
       @core.configuration = configuration
     end
 
+    ##
+    # Prepare the client for shutdown.
+    #
+    # This method stops the configuration poller and any other background threads.
+    #
+    # @return [nil]
     def shutdown
       @core.shutdown
     end
 
-    # Unstable
-    # Enqueues an arbitrary event. Events must have a type and a payload
+    ##
+    # Tracks an arbitrary event. Events must have a type and a payload.
+    #
+    # @note This method is considered unstable and may change in future versions.
+    #
+    # @param event_type [String] The type of the event to track.
+    # @param payload [Hash] The payload of the event to track.
     def unstable_track(event_type, payload)
       @core.track(event_type, payload)
     end
 
+    ##
+    # Returns a string assignment for the given flag key and subject.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [String] The default value to return if the flag is not found or no assignment can be made.
+    # @return [String] The assignment for the given flag key and subject.
     def get_string_assignment(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_inner(flag_key, subject_key, subject_attributes, "STRING", default_value)
     end
 
+    ##
+    # Returns a numeric assignment for the given flag key and subject.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Numeric] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Numeric] The assignment for the given flag key and subject.
     def get_numeric_assignment(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_inner(flag_key, subject_key, subject_attributes, "NUMERIC", default_value)
     end
 
+    ##
+    # Returns an integer assignment for the given flag key and subject.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Integer] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Integer] The assignment for the given flag key and subject.
     def get_integer_assignment(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_inner(flag_key, subject_key, subject_attributes, "INTEGER", default_value)
     end
 
+    ##
+    # Returns a boolean assignment for the given flag key and subject.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Boolean] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Boolean] The assignment for the given flag key and subject.
     def get_boolean_assignment(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_inner(flag_key, subject_key, subject_attributes, "BOOLEAN", default_value)
     end
 
+    ##
+    # Returns a JSON assignment for the given flag key and subject.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Hash] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Hash] The assignment for the given flag key and subject.
     def get_json_assignment(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_inner(flag_key, subject_key, subject_attributes, "JSON", default_value)
     end
 
+    ##
+    # Returns detailed information about a string assignment for the given flag key and subject.
+    #
+    # @note This method is intended for debugging purposes and is discouraged from use in
+    #   production. It is a couple of times slower than the non-detail methods. The evaluation
+    #   details format is primarily designed for human consumption (debugging) and is therefore
+    #   unstable and may change between SDK versions.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [String] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Hash] A hash containing {:variation => assigned_value, :action => nil, :evaluationDetails => {detailed_evaluation_info}}
     def get_string_assignment_details(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_details_inner(flag_key, subject_key, subject_attributes, "STRING", default_value)
     end
 
+    ##
+    # Returns detailed information about a numeric assignment for the given flag key and subject.
+    #
+    # @note This method is intended for debugging purposes and is discouraged from use in
+    #   production. It is a couple of times slower than the non-detail methods. The evaluation
+    #   details format is primarily designed for human consumption (debugging) and is therefore
+    #   unstable.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Numeric] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Hash] A hash containing {:variation => assigned_value, :action => nil, :evaluationDetails => {detailed_evaluation_info}}
     def get_numeric_assignment_details(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_details_inner(flag_key, subject_key, subject_attributes, "NUMERIC", default_value)
     end
 
+    ##
+    # Returns detailed information about an integer assignment for the given flag key and subject.
+    #
+    # @note This method is intended for debugging purposes and is discouraged from use in
+    #   production. It is a couple of times slower than the non-detail methods. The evaluation
+    #   details format is primarily designed for human consumption (debugging) and is therefore
+    #   unstable and may change between SDK versions.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Integer] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Hash] A hash containing {:variation => assigned_value, :action => nil, :evaluationDetails => {detailed_evaluation_info}}
     def get_integer_assignment_details(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_details_inner(flag_key, subject_key, subject_attributes, "INTEGER", default_value)
     end
 
+    ##
+    # Returns detailed information about a boolean assignment for the given flag key and subject.
+    #
+    # @note This method is intended for debugging purposes and is discouraged from use in
+    #   production. It is a couple of times slower than the non-detail methods. The evaluation
+    #   details format is primarily designed for human consumption (debugging) and is therefore
+    #   unstable and may change between SDK versions.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Boolean] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Hash] A hash containing {:variation => assigned_value, :action => nil, :evaluationDetails => {detailed_evaluation_info}}
     def get_boolean_assignment_details(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_details_inner(flag_key, subject_key, subject_attributes, "BOOLEAN", default_value)
     end
 
+    ##
+    # Returns detailed information about a JSON assignment for the given flag key and subject.
+    #
+    # @note This method is intended for debugging purposes and is discouraged from use in
+    #   production. It is a couple of times slower than the non-detail methods. The evaluation
+    #   details format is primarily designed for human consumption (debugging) and is therefore
+    #   unstable and may change between SDK versions.
+    #
+    # @param flag_key [String] The key of the flag to get an assignment for.
+    # @param subject_key [String] The key of the subject to get an assignment for.
+    # @param subject_attributes [Hash] The attributes of the subject to get an assignment for.
+    # @param default_value [Hash] The default value to return if the flag is not found or no assignment can be made.
+    # @return [Hash] A hash containing {:variation => assigned_value, :action => nil, :evaluationDetails => {detailed_evaluation_info}}
     def get_json_assignment_details(flag_key, subject_key, subject_attributes, default_value)
       get_assignment_details_inner(flag_key, subject_key, subject_attributes, "JSON", default_value)
     end
 
+    ##
+    # Returns a bandit action based on the flag key, subject, and available actions.
+    #
+    # @param flag_key [String] The key of the flag to get an action for.
+    # @param subject_key [String] The key of the subject to get an action for.
+    # @param subject_attributes [Hash] The attributes of the subject.
+    # @param actions [Hash] A map of available actions and their attributes.
+    # @param default_variation [String] The default variation to return if no assignment can be made.
+    # @return [Hash] A hash containing the assigned variation and action.
     def get_bandit_action(flag_key, subject_key, subject_attributes, actions, default_variation)
       attributes = coerce_context_attributes(subject_attributes)
       actions = actions.to_h { |action, attributes| [action, coerce_context_attributes(attributes)] }
@@ -103,6 +249,20 @@ module EppoClient
       }
     end
 
+    ##
+    # Returns detailed information about a bandit action based on the flag key, subject, and available actions.
+    #
+    # @note This method is intended for debugging purposes and is discouraged from use in
+    #   production. It is a couple of times slower than the non-detail methods. The evaluation
+    #   details format is primarily designed for human consumption (debugging) and is therefore
+    #   unstable and may change between SDK versions.
+    #
+    # @param flag_key [String] The key of the flag to get an action for.
+    # @param subject_key [String] The key of the subject to get an action for.
+    # @param subject_attributes [Hash] The attributes of the subject.
+    # @param actions [Hash] A map of available actions and their attributes.
+    # @param default_variation [String] The default variation to return if no assignment can be made.
+    # @return [Hash] A hash containing {:variation => assigned_variation, :action => assigned_action, :evaluationDetails => {detailed_evaluation_info}}
     def get_bandit_action_details(flag_key, subject_key, subject_attributes, actions, default_variation)
       attributes = coerce_context_attributes(subject_attributes)
       actions = actions.to_h { |action, attributes| [action, coerce_context_attributes(attributes)] }
@@ -120,7 +280,6 @@ module EppoClient
 
     private
 
-    # rubocop:disable Metrics/MethodLength
     def get_assignment_inner(flag_key, subject_key, subject_attributes, expected_type, default_value)
       logger = Logger.new($stdout)
       begin

data/lib/eppo_client/version.rb

@@ -2,5 +2,5 @@
 
 # TODO: this version and ext/eppo_client/Cargo.toml should be in sync
 module EppoClient
-  VERSION = "3.5.1"
+  VERSION = "3.7.0"
 end

data/lib/eppo_client.rb

@@ -6,6 +6,14 @@ require_relative "eppo_client/version"
 # EppoClient is the main module for initializing the Eppo client.
 # It provides a method to initialize the client with a given configuration.
 module EppoClient
+  ##
+  # Initializes the Eppo client singleton.
+  #
+  # @note The client returned by this method may still be in the process of initializing.
+  #       Use the `#wait_for_initialization` method to wait for the client to be ready.
+  #
+  # @param config [EppoClient::Config] The configuration for the client.
+  # @return [EppoClient::Client] The client.
   def init(config)
     client = EppoClient::Client.instance
     client.init(config)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eppo-server-sdk
 version: !ruby/object:Gem::Version
-  version: 3.5.1
+  version: 3.7.0
 platform: aarch64-linux-musl
 authors:
 - Eppo
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-03-14 00:00:00.000000000 Z
+date: 2025-04-15 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: