optimizely-sdk 3.4.0 → 3.8.0

data/lib/optimizely/optimizely_user_context.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2020, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+
+require 'json'
+
+module Optimizely
+  class OptimizelyUserContext
+    # Representation of an Optimizely User Context using which APIs are to be called.
+
+    attr_reader :user_id
+
+    def initialize(optimizely_client, user_id, user_attributes)
+      @attr_mutex = Mutex.new
+      @optimizely_client = optimizely_client
+      @user_id = user_id
+      @user_attributes = user_attributes.nil? ? {} : user_attributes.clone
+    end
+
+    def clone
+      OptimizelyUserContext.new(@optimizely_client, @user_id, user_attributes)
+    end
+
+    def user_attributes
+      @attr_mutex.synchronize { @user_attributes.clone }
+    end
+
+    # Set an attribute for a given key
+    #
+    # @param key - An attribute key
+    # @param value - An attribute value
+
+    def set_attribute(attribute_key, attribute_value)
+      @attr_mutex.synchronize { @user_attributes[attribute_key] = attribute_value }
+    end
+
+    # Returns a decision result (OptimizelyDecision) for a given flag key and a user context, which contains all data required to deliver the flag.
+    #
+    # If the SDK finds an error, it'll return a `decision` with nil for `variation_key`. The decision will include an error message in `reasons`
+    #
+    # @param key -A flag key for which a decision will be made
+    # @param options - A list of options for decision making.
+    #
+    # @return [OptimizelyDecision] A decision result
+
+    def decide(key, options = nil)
+      @optimizely_client&.decide(clone, key, options)
+    end
+
+    # Returns a hash of decision results (OptimizelyDecision) for multiple flag keys and a user context.
+    #
+    # If the SDK finds an error for a key, the response will include a decision for the key showing `reasons` for the error.
+    # The SDK will always return hash of decisions. When it can not process requests, it'll return an empty hash after logging the errors.
+    #
+    # @param keys - A list of flag keys for which the decisions will be made.
+    # @param options - A list of options for decision making.
+    #
+    # @return - Hash of decisions containing flag keys as hash keys and corresponding decisions as their values.
+
+    def decide_for_keys(keys, options = nil)
+      @optimizely_client&.decide_for_keys(clone, keys, options)
+    end
+
+    # Returns a hash of decision results (OptimizelyDecision) for all active flag keys.
+    #
+    # @param options - A list of options for decision making.
+    #
+    # @return - Hash of decisions containing flag keys as hash keys and corresponding decisions as their values.
+
+    def decide_all(options = nil)
+      @optimizely_client&.decide_all(clone, options)
+    end
+
+    # Track an event
+    #
+    # @param event_key - Event key representing the event which needs to be recorded.
+
+    def track_event(event_key, event_tags = nil)
+      @optimizely_client&.track(event_key, @user_id, user_attributes, event_tags)
+    end
+
+    def as_json
+      {
+        user_id: @user_id,
+        attributes: @user_attributes
+      }
+    end
+
+    def to_json(*args)
+      as_json.to_json(*args)
+    end
+  end
+end

data/lib/optimizely/project_config.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-#    Copyright 2016-2019, Optimizely and contributors
+#    Copyright 2016-2020, Optimizely and contributors
 #
 #    Licensed under the Apache License, Version 2.0 (the "License");
 #    you may not use this file except in compliance with the License.
@@ -20,6 +20,8 @@ module Optimizely
     # ProjectConfig is an interface capturing the experiment, variation and feature definitions.
     # The default implementation of ProjectConfig can be found in DatafileProjectConfig.
 
+    def datafile; end
+
     def account_id; end
 
     def attributes; end
@@ -44,6 +46,8 @@ module Optimizely
 
     def revision; end
 
+    def send_flag_decisions; end
+
     def rollouts; end
 
     def experiment_running?(experiment); end

data/lib/optimizely/semantic_version.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+#
+#    Copyright 2020, Optimizely and contributors
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+#
+
+require_relative 'exceptions'
+
+module Optimizely
+  module SemanticVersion
+    # Semantic Version Operators
+    SEMVER_PRE_RELEASE = '-'
+    SEMVER_BUILD = '+'
+
+    module_function
+
+    def pre_release?(target)
+      # Method to check if the given version is a prerelease
+      #
+      # target - String representing semantic version
+      #
+      # Returns true if the given version is a prerelease
+      #         false if it doesn't
+
+      raise unless target.is_a? String
+
+      prerelease_index = target.index(SEMVER_PRE_RELEASE)
+      build_index = target.index(SEMVER_BUILD)
+
+      return false if prerelease_index.nil?
+      return true if build_index.nil?
+
+      # when both operators are present prerelease should precede the build operator
+      prerelease_index < build_index
+    end
+
+    def build?(target)
+      # Method to check if the given version is a build
+      #
+      # target - String representing semantic version
+      #
+      # Returns true if the given version is a build
+      #         false if it doesn't
+
+      raise unless target.is_a? String
+
+      prerelease_index = target.index(SEMVER_PRE_RELEASE)
+      build_index = target.index(SEMVER_BUILD)
+
+      return false if build_index.nil?
+      return true if prerelease_index.nil?
+
+      # when both operators are present build should precede the prerelease operator
+      build_index < prerelease_index
+    end
+
+    def split_semantic_version(target)
+      # Method to split the given version.
+      #
+      # target - String representing semantic version
+      #
+      # Returns List The array of version split into smaller parts i.e major, minor, patch etc,
+      #         Exception if the given version is invalid.
+
+      target_prefix = target
+      target_suffix = ''
+      target_parts = []
+
+      raise InvalidSemanticVersion if target.include? ' '
+
+      if pre_release?(target)
+        target_parts = target.split(SEMVER_PRE_RELEASE, 2)
+      elsif build? target
+        target_parts = target.split(SEMVER_BUILD, 2)
+      end
+
+      unless target_parts.empty?
+        target_prefix = target_parts[0].to_s
+        target_suffix = target_parts[1..-1]
+      end
+
+      # expect a version string of the form x.y.z
+      dot_count = target_prefix.count('.')
+      raise InvalidSemanticVersion if dot_count > 2
+
+      target_version_parts = target_prefix.split('.')
+      raise InvalidSemanticVersion if target_version_parts.length != dot_count + 1
+
+      target_version_parts.each do |part|
+        raise InvalidSemanticVersion unless Helpers::Validator.string_numeric? part
+      end
+
+      target_version_parts.concat(target_suffix) if target_suffix.is_a?(Array)
+
+      target_version_parts
+    end
+
+    def compare_user_version_with_target_version(target_version, user_version)
+      # Compares target and user versions
+      #
+      # target_version - String representing target version
+      # user_version - String representing user version
+
+      # Returns boolean 0 if user version is equal to target version,
+      #                 1 if user version is greater than target version,
+      #                -1 if user version is less than target version.
+
+      raise InvalidAttributeType unless target_version.is_a? String
+      raise InvalidAttributeType unless user_version.is_a? String
+
+      is_target_version_prerelease = pre_release?(target_version)
+      is_user_version_prerelease = pre_release?(user_version)
+
+      target_version_parts = split_semantic_version(target_version)
+      user_version_parts = split_semantic_version(user_version)
+      user_version_parts_len = user_version_parts.length if user_version_parts
+
+      # Up to the precision of targetedVersion, expect version to match exactly.
+      target_version_parts.each_with_index do |_item, idx|
+        if user_version_parts_len <= idx
+          # even if they are equal at this point. if the target is a prerelease
+          # then user version must be greater than the pre release.
+          return 1 if is_target_version_prerelease
+
+          return -1
+
+        elsif !Helpers::Validator.string_numeric? user_version_parts[idx]
+          # compare strings
+          if user_version_parts[idx] < target_version_parts[idx]
+            return 1 if is_target_version_prerelease && !is_user_version_prerelease
+
+            return -1
+
+          elsif user_version_parts[idx] > target_version_parts[idx]
+            return -1 if is_user_version_prerelease && !is_target_version_prerelease
+
+            return 1
+          end
+
+        else
+          user_version_part = user_version_parts[idx].to_i
+          target_version_part = target_version_parts[idx].to_i
+
+          return 1 if user_version_part > target_version_part
+          return -1 if user_version_part < target_version_part
+        end
+      end
+
+      return -1 if is_user_version_prerelease && !is_target_version_prerelease
+
+      0
+    end
+  end
+end

data/lib/optimizely/version.rb

@@ -17,5 +17,5 @@
 #
 module Optimizely
   CLIENT_ENGINE = 'ruby-sdk'
-  VERSION = '3.4.0'
+  VERSION = '3.8.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: optimizely-sdk
 version: !ruby/object:Gem::Version
-  version: 3.4.0
+  version: 3.8.0
 platform: ruby
 authors:
 - Optimizely
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-23 00:00:00.000000000 Z
+date: 2021-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -94,20 +94,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: httparty
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.11'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.11'
 - !ruby/object:Gem::Dependency
   name: json-schema
   requirement: !ruby/object:Gem::Requirement
@@ -149,11 +135,15 @@ files:
 - lib/optimizely/bucketer.rb
 - lib/optimizely/condition_tree_evaluator.rb
 - lib/optimizely/config/datafile_project_config.rb
+- lib/optimizely/config/proxy_config.rb
 - lib/optimizely/config_manager/async_scheduler.rb
 - lib/optimizely/config_manager/http_project_config_manager.rb
 - lib/optimizely/config_manager/project_config_manager.rb
 - lib/optimizely/config_manager/static_project_config_manager.rb
 - lib/optimizely/custom_attribute_condition_evaluator.rb
+- lib/optimizely/decide/optimizely_decide_option.rb
+- lib/optimizely/decide/optimizely_decision.rb
+- lib/optimizely/decide/optimizely_decision_message.rb
 - lib/optimizely/decision_service.rb
 - lib/optimizely/error_handler.rb
 - lib/optimizely/event/batch_event_processor.rb
@@ -178,14 +168,17 @@ files:
 - lib/optimizely/helpers/date_time_utils.rb
 - lib/optimizely/helpers/event_tag_utils.rb
 - lib/optimizely/helpers/group.rb
+- lib/optimizely/helpers/http_utils.rb
 - lib/optimizely/helpers/validator.rb
 - lib/optimizely/helpers/variable_type.rb
 - lib/optimizely/logger.rb
 - lib/optimizely/notification_center.rb
 - lib/optimizely/optimizely_config.rb
 - lib/optimizely/optimizely_factory.rb
+- lib/optimizely/optimizely_user_context.rb
 - lib/optimizely/params.rb
 - lib/optimizely/project_config.rb
+- lib/optimizely/semantic_version.rb
 - lib/optimizely/user_profile_service.rb
 - lib/optimizely/version.rb
 homepage: https://www.optimizely.com/