configcat 7.0.0 → 8.0.0

data/lib/configcat/user.rb

@@ -1,10 +1,45 @@
 module ConfigCat
-  #    The user object for variation evaluation
+  # User Object. Contains user attributes which are used for evaluating targeting rules and percentage options.
   class User
     PREDEFINED = ["Identifier", "Email", "Country"]
 
     attr_reader :identifier
 
+    # Initialize a User object.
+    # Args:
+    #     identifier: The unique identifier of the user or session (e.g. email address, primary key, session ID, etc.)
+    #     email: Email address of the user.
+    #     country: Country of the user.
+    #     custom: Custom attributes of the user for advanced targeting rule definitions (e.g. role, subscription type, etc.)
+    #     All comparators support string values as User Object attribute (in some cases they need to be provided in a
+    #     specific format though, see below), but some of them also support other types of values. It depends on the
+    #     comparator how the values will be handled. The following rules apply:
+    #     Text-based comparators (EQUALS, IS_ONE_OF, etc.)
+    #     * accept string values,
+    #     * all other values are automatically converted to string
+    #       (a warning will be logged but evaluation will continue as normal).
+    #     SemVer-based comparators (IS_ONE_OF_SEMVER, LESS_THAN_SEMVER, GREATER_THAN_SEMVER, etc.)
+    #     * accept string values containing a properly formatted, valid semver value,
+    #     * all other values are considered invalid
+    #       (a warning will be logged and the currently evaluated targeting rule will be skipped).
+    #     Number-based comparators (EQUALS_NUMBER, LESS_THAN_NUMBER, GREATER_THAN_OR_EQUAL_NUMBER, etc.)
+    #     * accept float values and all other numeric values which can safely be converted to float,
+    #     * accept string values containing a properly formatted, valid float value,
+    #     * all other values are considered invalid
+    #       (a warning will be logged and the currently evaluated targeting rule will be skipped).
+    #     Date time-based comparators (BEFORE_DATETIME / AFTER_DATETIME)
+    #     * accept datetime values, which are automatically converted to a second-based Unix timestamp
+    #       (datetime values with naive timezone are considered to be in UTC),
+    #     * accept float values representing a second-based Unix timestamp
+    #       and all other numeric values which can safely be converted to float,
+    #     * accept string values containing a properly formatted, valid float value,
+    #     * all other values are considered invalid
+    #       (a warning will be logged and the currently evaluated targeting rule will be skipped).
+    #     String array-based comparators (ARRAY_CONTAINS_ANY_OF / ARRAY_NOT_CONTAINS_ANY_OF)
+    #     * accept arrays of strings,
+    #     * accept string values containing a valid JSON string which can be deserialized to an array of strings,
+    #     * all other values are considered invalid
+    #       (a warning will be logged and the currently evaluated targeting rule will be skipped).
     def initialize(identifier, email: nil, country: nil, custom: nil)
       @identifier = (!identifier.equal?(nil)) ? identifier : ""
       @data = { "Identifier" => identifier, "Email" => email, "Country" => country }
@@ -26,10 +61,14 @@ module ConfigCat
       dump = {
         'Identifier': @identifier,
         'Email': @data['Email'],
-        'Country': @data['Country'],
-        'Custom': @custom,
+        'Country': @data['Country']
       }
-      return dump.to_json
+      dump.merge!(@custom) if @custom
+      filtered_dump = dump.reject { |_, v| v.nil? }
+      formatted_dump = filtered_dump.transform_values do |value|
+        value.is_a?(DateTime) ? value.strftime('%Y-%m-%dT%H:%M:%S.%L%z') : value
+      end
+      return JSON.generate(formatted_dump, ascii_only: false, separators: %w[, :])
     end
   end
 end

data/lib/configcat/utils.rb

@@ -3,8 +3,28 @@ module ConfigCat
     DISTANT_FUTURE = Float::INFINITY
     DISTANT_PAST = 0
 
+    def self.get_date_time(seconds_since_epoch)
+      Time.at(seconds_since_epoch).utc
+    end
+
     def self.get_utc_now_seconds_since_epoch
-      return Time.now.utc.to_f
+      Time.now.utc.to_f
+    end
+
+    def self.get_seconds_since_epoch(date_time)
+      date_time.to_time.to_f
+    end
+
+    def self.is_string_list(value)
+      # Check if the value is an Array
+      return false unless value.is_a?(Array)
+
+      # Check if all elements in the Array are Strings
+      value.each do |item|
+        return false unless item.is_a?(String)
+      end
+
+      return true
     end
   end
 end

data/lib/configcat/version.rb

@@ -1,3 +1,3 @@
 module ConfigCat
-  VERSION = "7.0.0"
+  VERSION = "8.0.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: configcat
 version: !ruby/object:Gem::Version
-  version: 7.0.0
+  version: 8.0.0
 platform: ruby
 authors:
 - ConfigCat
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-17 00:00:00.000000000 Z
+date: 2024-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -120,6 +120,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/configcat.rb
+- lib/configcat/config.rb
 - lib/configcat/configcache.rb
 - lib/configcat/configcatclient.rb
 - lib/configcat/configcatlogger.rb
@@ -127,9 +128,10 @@ files:
 - lib/configcat/configentry.rb
 - lib/configcat/configfetcher.rb
 - lib/configcat/configservice.rb
-- lib/configcat/constants.rb
 - lib/configcat/datagovernance.rb
+- lib/configcat/evaluationcontext.rb
 - lib/configcat/evaluationdetails.rb
+- lib/configcat/evaluationlogbuilder.rb
 - lib/configcat/interfaces.rb
 - lib/configcat/localdictionarydatasource.rb
 - lib/configcat/localfiledatasource.rb

data/lib/configcat/constants.rb

@@ -1,18 +0,0 @@
-module ConfigCat
-  CONFIG_FILE_NAME = "config_v5"
-  SERIALIZATION_FORMAT_VERSION = "v2"
-
-  PREFERENCES = "p"
-  BASE_URL = "u"
-  REDIRECT = "r"
-
-  FEATURE_FLAGS = "f"
-  VALUE = "v"
-  COMPARATOR = "t"
-  COMPARISON_ATTRIBUTE = "a"
-  COMPARISON_VALUE = "c"
-  ROLLOUT_PERCENTAGE_ITEMS = "p"
-  PERCENTAGE = "p"
-  ROLLOUT_RULES = "r"
-  VARIATION_ID = "i"
-end