vwo-sdk 1.3.0 → 1.5.0

data/lib/vwo/logger.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 require 'logger'
 
 class VWO
@@ -33,5 +31,13 @@ class VWO
     def log(level, message)
       @@logger_instance.log(level, message)
     end
+
+    def instance
+      @@logger_instance
+    end
+
+    def level
+      @@logger_instance.level
+    end
   end
 end

data/lib/vwo/schemas/settings_file.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 require 'json'
 
 class VWO

data/lib/vwo/services/event_dispatcher.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 require_relative '../logger'
 require_relative '../enums'
 require_relative '../utils/request'
@@ -62,13 +60,13 @@ class VWO
               variation_id: impression[:combination]
             )
           )
-          return true
+          true
         else
           @logger.log(
             LogLevelEnum::ERROR,
             format(LogMessageEnum::ErrorMessages::IMPRESSION_FAILED, file: FileNameEnum::EventDispatcher, end_point: impression['url'])
           )
-          return false
+          false
         end
       rescue StandardError
         @logger.log(

data/lib/vwo/services/operand_evaluator.rb

@@ -0,0 +1,114 @@
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+#
+# 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 '../utils/function'
+require_relative '../utils/segment'
+
+class VWO
+  module Services
+    class OperandEvaluator
+      include VWO::Utils::Function
+      include VWO::Utils::Segment
+
+      # Checks if both values are same after 'down-casing'
+      # i.e. case insensitive check
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def lower?(operand_value, custom_variables_value)
+        operand_value.downcase == custom_variables_value.downcase
+      end
+
+      # Checks if custom_variables_value contains operand_value
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def contains?(operand_value, custom_variables_value)
+        custom_variables_value.include?(operand_value)
+      end
+
+      # Checks if custom_variables_value ends with operand_value
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def starts_with?(operand_value, custom_variables_value)
+        custom_variables_value.end_with?(operand_value)
+      end
+
+      # Checks if custom_variables_value starts with operand_value
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def ends_with?(operand_value, custom_variables_value)
+        custom_variables_value.start_with?(operand_value)
+      end
+
+      # Checks if custom_variables_value matches the regex specified by operand_value
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def regex?(operand_value, custom_variables_value)
+        pattern = Regexp.new operand_value
+        custom_variables_value =~ pattern
+      end
+
+      # Checks if both values are exactly same
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def equals?(operand_value, custom_variables_value)
+        custom_variables_value == operand_value
+      end
+
+      # Identifies the condition stated in the leaf node and evaluates the result
+      #
+      # @param [String] :operand_value            Leaf value from the segments
+      # @param [String] :custom_variables_value   Value from the custom_variables
+      #
+      # @return [Boolean]
+      def evaluate_operand?(operand, custom_variables)
+        # Extract custom_variable_key and custom_variables_value from operand
+
+        operand_key, operand = get_key_value(operand)
+
+        # Retrieve corresponding custom_variable value from custom_variables
+        custom_variables_value = custom_variables[operand_key]
+
+        # Pre process custom_variable value
+        custom_variables_value = process_custom_variables_value(custom_variables_value)
+
+        # Pre process operand value
+        operand_type, operand_value = process_operand_value(operand)
+
+        # Process the custom_variables_value and operand_value to make them of same type
+        operand_value, custom_variables_value = convert_to_true_types(operand_value, custom_variables_value)
+
+        # Call the self method corresponding to operand_type to evaluate the result
+        public_send("#{operand_type}?", operand_value, custom_variables_value)
+      end
+    end
+  end
+end

data/lib/vwo/services/segment_evaluator.rb

@@ -0,0 +1,109 @@
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+#
+# 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 '../logger'
+require_relative '../enums'
+require_relative './operand_evaluator'
+require_relative '../utils/function'
+require_relative '../utils/segment'
+require_relative '../utils/validations'
+
+class VWO
+  module Services
+    class SegmentEvaluator
+      include VWO::Enums
+      include VWO::Utils::Function
+      include VWO::Utils::Segment
+      include VWO::Utils::Validations
+
+      # Initializes this class with VWOLogger and OperandEvaluator
+      def initialize
+        @logger = VWO::Logger.get_instance
+        @operand_evaluator = OperandEvaluator.new
+      end
+
+      # A parser which recursively evaluates the expression tree represented by dsl,
+      # and returns the result
+      #
+      # @param[Hash]      :dsl                      The segments defined in the campaign
+      # @param[Hash]      :custom_variables         Key/value pair of custom_attributes properties
+      #
+      # @return[Boolean]
+      #
+      def evaluate_util(dsl, custom_variables)
+        operator, sub_dsl = get_key_value(dsl)
+        if operator == OperatorTypes::NOT
+          !evaluate_util(sub_dsl, custom_variables)
+        elsif operator == OperatorTypes::AND
+          sub_dsl.all? { |y| evaluate_util(y, custom_variables) }
+        elsif operator == OperatorTypes::OR
+          sub_dsl.any? { |y| evaluate_util(y, custom_variables) }
+        elsif operator == OperandTypes::CUSTOM_VARIABLE
+          @operand_evaluator.evaluate_operand?(sub_dsl, custom_variables)
+        end
+      end
+
+      # Evaluates the custom_variables passed against the pre-segmentation condition defined
+      # in the corresponding campaign.
+      #
+      # @param[String]                  :campaign_key         Running_campaign's key
+      # @param[String]                  :user_id              Unique user identifier
+      # @param[Hash]                    :dsl                  Segments provided in the settings_file
+      # @param[Hash]                    :custom_variables     Custom variables provided in the apis
+      #
+      # @return[Boolean]                true if user passed pre-segmentation, else false
+      #
+      def evaluate(campaign_key, user_id, dsl, custom_variables)
+        result = evaluate_util(dsl, custom_variables) if valid_value?(dsl)
+        if result
+          @logger.log(
+            LogLevelEnum::INFO,
+            format(
+              LogMessageEnum::InfoMessages::USER_PASSED_PRE_SEGMENTATION,
+              file: FileNameEnum::SegmentEvaluator,
+              user_id: user_id,
+              campaign_key: campaign_key,
+              custom_variables: custom_variables
+            )
+          )
+        else
+          @logger.log(
+            LogLevelEnum::INFO,
+            format(
+              LogMessageEnum::InfoMessages::USER_FAILED_PRE_SEGMENTATION,
+              file: FileNameEnum::SegmentEvaluator,
+              user_id: user_id,
+              campaign_key: campaign_key,
+              custom_variables: custom_variables
+            )
+          )
+        end
+        result
+      rescue StandardError => e
+        @logger.log(
+          LogLevelEnum::ERROR,
+          format(
+            LogMessageEnum::ErrorMessages::PRE_SEGMENTATION_ERROR,
+            file: FileNameEnum::SegmentEvaluator,
+            user_id: user_id,
+            campaign_key: campaign_key,
+            custom_variables: custom_variables,
+            error_message: e
+          )
+        )
+        false
+      end
+    end
+  end
+end

data/lib/vwo/services/settings_file_manager.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 require_relative '../utils/function'
 require_relative '../utils/request'
 require_relative '../utils/validations'
@@ -46,7 +44,7 @@ class VWO
         is_valid_key = valid_number?(@account_id) || valid_string?(@account_id)
 
         unless is_valid_key && valid_string?(@sdk_key)
-          STDERR.puts 'account_id and sdk_key are required for fetching account settings. Aborting!'
+          puts 'account_id and sdk_key are required for fetching account settings. Aborting!'
           return '{}'
         end
 
@@ -60,12 +58,12 @@ class VWO
             Got Status Code: #{settings_file_response.code}
             and message: #{settings_file_response.body}.
           DOC
-          STDERR.puts message
+          puts message
           return
         end
         settings_file_response.body
       rescue StandardError => e
-        STDERR.puts "Error fetching Settings File #{e}"
+        puts "Error fetching Settings File #{e}"
       end
 
       private

data/lib/vwo/services/settings_file_processor.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 require_relative '../logger'
 require_relative '../enums'
 require_relative '../utils/campaign'

data/lib/vwo/user_storage.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 class VWO
   # UserStorage Class is used to store user-variation mapping.
   # Override this class to implement your own functionality.

data/lib/vwo/utils/campaign.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Wingify Software Pvt. Ltd.
+# Copyright 2019-2020 Wingify Software Pvt. Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# frozen_string_literal: true
-
 require_relative '../logger'
 require_relative '../enums'
 require_relative '../constants'
@@ -25,18 +23,6 @@ class VWO
       include VWO::Enums
       include VWO::CONSTANTS
 
-      # Finds and Returns campaign from given campaign_key.
-      #
-      # @param[Hash]      :settings_file      Settings file
-      # @param[String]    :campaign_key      Campaign identifier key
-      # @return[Hash]     :campaign object
-
-      def get_campaign(settings_file, campaign_key)
-        (settings_file['campaigns'] || []).find do |campaign|
-          campaign['key'] == campaign_key
-        end
-      end
-
       # Sets variation allocation range in the provided campaign
       #
       # @param [Hash]: Campaign object
@@ -72,23 +58,48 @@ class VWO
       end
 
       # Returns goal from given campaign_key and gaol_identifier.
-      # @param[Hash]              :settings_file        Settings file
-      # @param[String]            :campaign_key        Campaign identifier key
+      # @param[String]            :campaign             Campaign object
       # @param[String]            :goal_identifier      Goal identifier
       #
       # @return[Hash]                                  Goal corresponding to Goal_identifier in respective campaign
 
-      def get_campaign_goal(settings_file, campaign_key, goal_identifier)
-        return unless settings_file && campaign_key && goal_identifier
-
-        campaign = get_campaign(settings_file, campaign_key)
-        return unless campaign
+      def get_campaign_goal(campaign, goal_identifier)
+        return unless campaign && goal_identifier
 
         campaign['goals'].find do |goal|
           goal['identifier'] == goal_identifier
         end
       end
 
+      # Returns segments from the campaign
+      # @param[Hash]          campaign      Running campaign
+      # @return[Hash]         A dsl of segments
+      #
+      def get_segments(campaign)
+        campaign['segments']
+      end
+
+      # Returns control variation from a given campaign
+      # @param[Hash]          campaign      Running campaign
+      # @return[Hash]         variation     Control variation from the campaign, ie having id = 1
+
+      def get_control_variation(campaign)
+        campaign['variations'].find do |variation|
+          variation['id'] == 1
+        end
+      end
+
+      # Returns variable from given variables list.
+      # @params[Array]          variables           List of variables, whether in campaigns or inside variation
+      # @param[String]          variable_key        Variable identifier
+      # @return[Hash]                               Variable corresponding to variable_key in given variable list
+
+      def get_variable(variables, variable_key)
+        variables.find do |variable|
+          variable['key'] == variable_key
+        end
+      end
+
       private
 
       # Returns the bucket size of variation.
@@ -120,6 +131,17 @@ class VWO
           variation['name'] == variation_name
         end
       end
+
+      # Finds and Returns campaign from given campaign_key.
+      # [Hash]                :settings_file          Settings file for the project
+      # [String]              :campaign_key           Campaign identifier key
+      # @return[Hash]                                 Campaign object
+
+      def get_campaign(settings_file, campaign_key)
+        settings_file['campaigns'].find do |campaign|
+          campaign['key'] == campaign_key
+        end
+      end
     end
   end
 end