vwo-sdk 1.6.0 → 1.14.0

data/lib/vwo/constants.rb

@@ -1,4 +1,4 @@
-# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+# Copyright 2019-2021 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.
@@ -26,20 +26,29 @@ class VWO
     HTTP_PROTOCOL = 'http://'
     HTTPS_PROTOCOL = 'https://'
     URL_NAMESPACE = '6ba7b811-9dad-11d1-80b4-00c04fd430c8'
-    SDK_VERSION = '1.6.0'
+    SDK_VERSION = '1.14.0'
     SDK_NAME = 'ruby'
+    VWO_DELIMITER = '_vwo_'
+    MAX_EVENTS_PER_REQUEST = 5000
+    MIN_EVENTS_PER_REQUEST = 1
+    DEFAULT_EVENTS_PER_REQUEST = 100
+    DEFAULT_REQUEST_TIME_INTERVAL = 600 # 10 * 60(secs) = 600 secs i.e. 10 minutes
+    MIN_REQUEST_TIME_INTERVAL = 2
 
     module ENDPOINTS
       BASE_URL = 'dev.visualwebsiteoptimizer.com'
-      ACCOUNT_SETTINGS = '/server-side/settings'
+      SETTINGS_URL = '/server-side/settings'
+      WEBHOOK_SETTINGS_URL = '/server-side/pull'
       TRACK_USER = '/server-side/track-user'
       TRACK_GOAL = '/server-side/track-goal'
       PUSH = '/server-side/push'
+      BATCH_EVENTS = '/server-side/batch-events'
     end
 
     module EVENTS
       TRACK_USER = 'track-user'
       TRACK_GOAL = 'track-goal'
+      PUSH = 'push'
     end
 
     module DATATYPE
@@ -61,6 +70,12 @@ class VWO
       BOOLEAN = 'boolean'
     end
 
+    module Hooks
+      DECISION_TYPES = {
+        'CAMPAIGN_DECISION' => 'CAMPAIGN_DECISION'
+      }
+    end
+
     RUBY_VARIABLE_TYPES = {
       'string' => [String],
       'integer' => [Integer],
@@ -68,6 +83,12 @@ class VWO
       'boolean' => [TrueClass, FalseClass]
     }
 
+    GOAL_TYPES = {
+      'REVENUE' => 'REVENUE_TRACKING',
+      'CUSTOM' => 'CUSTOM_GOAL',
+      'ALL' => 'ALL'
+    }
+
     module ApiMethods
       ACTIVATE = 'activate'
       GET_VARIATION_NAME = 'get_variation_name'
@@ -75,6 +96,8 @@ class VWO
       IS_FEATURE_ENABLED = 'is_feature_enabled'
       GET_FEATURE_VARIABLE_VALUE = 'get_feature_variable_value'
       PUSH = 'push'
+      GET_AND_UPDATE_SETTINGS_FILE = 'get_and_update_settings_file'
+      FLUSH_EVENTS = 'flush_events'
     end
 
     module PushApi

data/lib/vwo/core/bucketer.rb

@@ -1,4 +1,4 @@
-# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+# Copyright 2019-2021 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.

data/lib/vwo/core/variation_decider.rb

@@ -1,4 +1,4 @@
-# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+# Copyright 2019-2021 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.
@@ -18,15 +18,20 @@ require_relative '../utils/campaign'
 require_relative '../services/segment_evaluator'
 require_relative '../utils/validations'
 require_relative 'bucketer'
+require_relative '../constants'
+require_relative '../services/hooks_manager'
+require_relative '../utils/uuid'
 
 class VWO
   module Core
     class VariationDecider
-      attr_reader :user_storage_service
+      attr_reader :user_storage_service, :has_stored_variation, :hooks_manager
 
       include VWO::Enums
       include VWO::Utils::Campaign
       include VWO::Utils::Validations
+      include VWO::CONSTANTS
+      include VWO::Utils::UUID
 
       FILE = FileNameEnum::VariationDecider
 
@@ -34,12 +39,13 @@ class VWO
       # @param[Hash] -   Settings file
       # @param[Class] -  Class instance having the capability of
       #                  get and save.
-      def initialize(settings_file, user_storage_service = nil)
+      def initialize(settings_file, user_storage_service = nil, options = {})
         @logger = VWO::Logger.get_instance
         @user_storage_service = user_storage_service
         @bucketer = VWO::Core::Bucketer.new
         @settings_file = settings_file
         @segment_evaluator = VWO::Services::SegmentEvaluator.new
+        @hooks_manager = VWO::Services::HooksManager.new(options)
       end
 
       # Returns variation for the user for the passed campaign-key
@@ -51,14 +57,42 @@ class VWO
       # @param[String]          :user_id             The unique ID assigned to User
       # @param[Hash]            :campaign            Campaign hash itself
       # @param[String]          :campaign_key        The unique ID of the campaign passed
+      # @param[String]          :goal_identifier     The unique campaign's goal identifier
       # @return[String,String]                       ({variation_id, variation_name}|Nil): Tuple of
       #                                              variation_id and variation_name if variation allotted, else nil
 
-      def get_variation(user_id, campaign, api_name, campaign_key, custom_variables = {}, variation_targeting_variables = {})
+      def get_variation(user_id, campaign, api_name, campaign_key, custom_variables = {}, variation_targeting_variables = {}, goal_identifier = '')
         campaign_key ||= campaign['key']
 
         return unless campaign
 
+        @has_stored_variation = false
+        decision = {
+          :campaign_id => campaign['id'],
+          :campaign_key => campaign_key,
+          :campaign_type => campaign['type'],
+        # campaign segmentation conditions
+          :custom_variables => custom_variables,
+        # event name
+          :event => Hooks::DECISION_TYPES['CAMPAIGN_DECISION'],
+        # goal tracked in case of track API
+          :goal_identifier => goal_identifier,
+        # campaign whitelisting flag
+          :is_forced_variation_enabled => campaign['isForcedVariationEnabled'] ? campaign['isForcedVariationEnabled'] : false,
+          :sdk_version => SDK_VERSION,
+        # API name which triggered the event
+          :source => api_name,
+        # Passed in API
+          :user_id => user_id,
+        # Campaign Whitelisting conditions
+          :variation_targeting_variables => variation_targeting_variables,
+          :is_user_whitelisted => false,
+          :from_user_storage_service => false,
+          :is_feature_enabled => true,
+        # VWO generated UUID based on passed UserId and Account ID
+          :vwo_user_id => generator_for(user_id, @settings_file['accountId'])
+        }
+
         if campaign['isForcedVariationEnabled']
           variation = evaluate_whitelisting(
             user_id,
@@ -88,6 +122,19 @@ class VWO
             )
           )
 
+          if variation
+            if campaign['type'] == CampaignTypes::VISUAL_AB || campaign['type'] == CampaignTypes::FEATURE_TEST
+              decision[:variation_name] = variation['name']
+              decision[:variation_id] = variation['id']
+              if campaign['type'] == CampaignTypes::FEATURE_TEST
+                decision[:is_feature_enabled] = variation['isFeatureEnabled']
+              elsif campaign['type'] == CampaignTypes::VISUAL_AB
+                decision[:is_user_whitelisted] = !!variation['name']
+              end
+            end
+            @hooks_manager.execute(decision)
+          end
+
           return variation if variation && variation['name']
         else
           @logger.log(
@@ -104,8 +151,13 @@ class VWO
 
         user_campaign_map = get_user_storage(user_id, campaign_key)
         variation = get_stored_variation(user_id, campaign_key, user_campaign_map) if valid_hash?(user_campaign_map)
+        variation = variation.dup  # deep copy
 
         if variation
+          if valid_string?(user_campaign_map['goal_identifier']) && api_name == ApiMethods::TRACK
+            variation['goal_identifier'] = user_campaign_map['goal_identifier']
+          end
+          @has_stored_variation = true
           @logger.log(
             LogLevelEnum::INFO,
             format(
@@ -116,7 +168,55 @@ class VWO
               variation_name: variation['name']
             )
           )
+          decision[:from_user_storage_service] = !!variation['name']
+          if variation
+            if campaign['type'] == CampaignTypes::VISUAL_AB || campaign['type'] == CampaignTypes::FEATURE_TEST
+              decision[:variation_name] = variation['name']
+              decision[:variation_id] = variation['id']
+              if campaign['type'] == CampaignTypes::FEATURE_TEST
+                decision[:is_feature_enabled] = variation['isFeatureEnabled']
+              end
+            end
+            @hooks_manager.execute(decision)
+          end
           return variation
+        else
+          @logger.log(
+            LogLevelEnum::DEBUG,
+            format(
+              LogMessageEnum::DebugMessages::NO_STORED_VARIATION,
+              file: FILE,
+              campaign_key: campaign_key,
+              user_id: user_id
+            )
+          )
+
+          if ([ApiMethods::TRACK, ApiMethods::GET_VARIATION_NAME, ApiMethods::GET_FEATURE_VARIABLE_VALUE].include? api_name) &&
+            @user_storage_service && campaign['type'] != CampaignTypes::FEATURE_ROLLOUT
+            @logger.log(
+              LogLevelEnum::DEBUG,
+              format(
+                LogMessageEnum::DebugMessages::CAMPAIGN_NOT_ACTIVATED,
+                file: FILE,
+                campaign_key: campaign_key,
+                user_id: user_id,
+                api_name: api_name
+              )
+            )
+
+            @logger.log(
+              LogLevelEnum::INFO,
+              format(
+                LogMessageEnum::InfoMessages::CAMPAIGN_NOT_ACTIVATED,
+                file: FILE,
+                campaign_key: campaign_key,
+                user_id: user_id,
+                api_name: api_name,
+                reason: api_name == ApiMethods::TRACK ? 'track it' : 'get the decision/value'
+              )
+            )
+            return
+          end
         end
 
         # Pre-segmentation
@@ -178,7 +278,7 @@ class VWO
         variation = get_variation_allotted(user_id, campaign)
 
         if variation && variation['name']
-          save_user_storage(user_id, campaign_key, variation['name']) if variation['name']
+          save_user_storage(user_id, campaign_key, variation['name'], goal_identifier) if variation['name']
 
           @logger.log(
             LogLevelEnum::INFO,
@@ -197,6 +297,17 @@ class VWO
             format(LogMessageEnum::InfoMessages::NO_VARIATION_ALLOCATED, file: FILE, campaign_key: campaign_key, user_id: user_id)
           )
         end
+
+        if variation
+          if campaign['type'] == CampaignTypes::VISUAL_AB || campaign['type'] == CampaignTypes::FEATURE_TEST
+            decision[:variation_name] = variation['name']
+            decision[:variation_id] = variation['id']
+            if campaign['type'] == CampaignTypes::FEATURE_TEST
+              decision[:is_feature_enabled] = variation['isFeatureEnabled']
+            end
+          end
+          @hooks_manager.execute(decision)
+        end
         variation
       end
 
@@ -293,6 +404,45 @@ class VWO
         nil
       end
 
+      # If UserStorageService is provided, save the assigned variation
+      #
+      # @param[String]              :user_id            Unique user identifier
+      # @param[String]              :campaign_key       Unique campaign identifier
+      # @param[String]              :variation_name     Variation identifier
+      # @param[String]              :goal_identifier    The unique campaign's goal identifier
+      # @return[Boolean]                                true if found otherwise false
+
+      def save_user_storage(user_id, campaign_key, variation_name, goal_identifier)
+        unless @user_storage_service
+          @logger.log(
+            LogLevelEnum::DEBUG,
+            format(LogMessageEnum::DebugMessages::NO_USER_STORAGE_SERVICE_SAVE, file: FILE)
+          )
+          return false
+        end
+        new_campaign_user_mapping = {}
+        new_campaign_user_mapping['campaign_key'] = campaign_key
+        new_campaign_user_mapping['user_id'] = user_id
+        new_campaign_user_mapping['variation_name'] = variation_name
+        if !goal_identifier.empty?
+          new_campaign_user_mapping['goal_identifier'] = goal_identifier
+        end
+
+        @user_storage_service.set(new_campaign_user_mapping)
+
+        @logger.log(
+          LogLevelEnum::INFO,
+          format(LogMessageEnum::InfoMessages::SAVING_DATA_USER_STORAGE_SERVICE, file: FILE, user_id: user_id)
+        )
+        true
+      rescue StandardError
+        @logger.log(
+          LogLevelEnum::ERROR,
+          format(LogMessageEnum::ErrorMessages::SAVE_USER_STORAGE_SERVICE_FAILED, file: FILE, user_id: user_id)
+        )
+        false
+      end
+
       private
 
       # Evaluate all the variations in the campaign to find
@@ -464,41 +614,6 @@ class VWO
           variation_name
         )
       end
-
-      # If UserStorageService is provided, save the assigned variation
-      #
-      # @param[String]              :user_id            Unique user identifier
-      # @param[String]              :campaign_key       Unique campaign identifier
-      # @param[String]              :variation_name     Variation identifier
-      # @return[Boolean]                                true if found otherwise false
-
-      def save_user_storage(user_id, campaign_key, variation_name)
-        unless @user_storage_service
-          @logger.log(
-            LogLevelEnum::DEBUG,
-            format(LogMessageEnum::DebugMessages::NO_USER_STORAGE_SERVICE_SAVE, file: FILE)
-          )
-          return false
-        end
-        new_campaign_user_mapping = {}
-        new_campaign_user_mapping['campaign_key'] = campaign_key
-        new_campaign_user_mapping['user_id'] = user_id
-        new_campaign_user_mapping['variation_name'] = variation_name
-
-        @user_storage_service.set(new_campaign_user_mapping)
-
-        @logger.log(
-          LogLevelEnum::INFO,
-          format(LogMessageEnum::InfoMessages::SAVING_DATA_USER_STORAGE_SERVICE, file: FILE, user_id: user_id)
-        )
-        true
-      rescue StandardError
-        @logger.log(
-          LogLevelEnum::ERROR,
-          format(LogMessageEnum::ErrorMessages::SAVE_USER_STORAGE_SERVICE_FAILED, file: FILE, user_id: user_id)
-        )
-        false
-      end
     end
   end
 end

data/lib/vwo/enums.rb

@@ -1,4 +1,4 @@
-# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+# Copyright 2019-2021 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.
@@ -71,6 +71,8 @@ class VWO
       SegmentEvaluator = VWO_PATH + '/services/segment_evaluator'
       Logger = VWO_PATH + '/logger'
       SettingsFileProcessor = VWO_PATH + '/services/settings_file_processor'
+      BatchEventsQueue = VWO_PATH + '/services/batch_events_queue'
+      BatchEventsDispatcher = VWO_PATH + '/services/batch_events_dispatcher'
 
       CampaignUtil = UTIL_PATH + '/campaign'
       FunctionUtil = UTIL_PATH + '/function'
@@ -106,6 +108,11 @@ class VWO
         GOT_VARIATION_FOR_USER = '(%<file>s): userId:%<user_id>s for campaign:%<campaign_key>s got variationName:%<variation_name>s'
         SEGMENTATION_STATUS = '(%<file>s): In API: %<api_name>s, for UserId:%<user_id>s of campaign:%<campaign_key>s  with variables:%<custom_variables>s %<status>s %<segmentation_type>s for %<variation_name>s'
         PARAMS_FOR_PUSH_CALL = '(%<file>s): Params for push call - %<properties>s'
+        CAMPAIGN_NOT_ACTIVATED = '(%<file>s): Campaign:%<campaign_key>s for User ID:%<user_id>s is not yet activated for API:%<api_name>s. Use activate API to activate A/B test or isFeatureEnabled API to activate Feature Test.'
+        BATCH_EVENT_LIMIT_EXCEEDED = '(%<file>s): Impression event - %<end_point>s failed due to exceeding payload size. Parameter eventsPerRequest in batchEvents config in launch API has value:%<eventsPerRequest>s for accountId:%<accountId>s. Please read the official documentation for knowing the size limits.'
+        BULK_NOT_PROCESSED = "(%<file>s): Batch events couldn't be received by VWO. Calling Flush Callback with error and data."
+        BEFORE_FLUSHING = '(%<file>s): Flushing events queue %<manually>s having %<length>s events %<timer>s queue summary: %<queue_metadata>s'
+        EVENT_BATCHING_INSUFFICIENT = '(%<file>s): %<key>s not provided, assigning default value'
       end
 
       # Info Messages
@@ -120,9 +127,9 @@ class VWO
         AUDIENCE_CONDITION_NOT_MET = '(%<file>s): userId:%<user_id>s does not become part of campaign because of not meeting audience conditions'
         GOT_VARIATION_FOR_USER = '(%<file>s): userId:%<user_id>s for campaign:%<campaign_key>s got variationName:%<variation_name>s'
         USER_GOT_NO_VARIATION = '(%<file>s): userId:%<user_id>s for campaign:%<campaign_key>s did not allot any variation'
-        IMPRESSION_SUCCESS = '(%<file>s): Impression event - %<end_point>s was successfully received by VWO having main keys: accountId:%<account_id>s userId:%<user_id>s campaignId:%<campaign_id>s and variationId:%<variation_id>s'
-        MAIN_KEYS_FOR_IMPRESSION = '(%<file>s): Having main keys: accountId:%<account_id>s} userId:%<user_id>s campaignId:%<campaign_id>s and variationId:%<variation_id>s'
-        MAIN_KEYS_FOR_PUSH_API = '(%<file>s): Having main keys: accountId:%<account_id>s} userId:%<user_id>s u:%<u>s and tags:%<tags>s}'
+        IMPRESSION_SUCCESS = '(%<file>s): Impression event - %<end_point>s was successfully received by VWO having main keys: sdkKey:%<sdk_key>s accountId:%<account_id>s campaignId:%<campaign_id>s and variationId:%<variation_id>s'
+        MAIN_KEYS_FOR_IMPRESSION = '(%<file>s): Having main keys: {sdkKey:%<sdk_key>s accountId:%<account_id>s campaignId:%<campaign_id>s and variationId:%<variation_id>s}'
+        MAIN_KEYS_FOR_PUSH_API = '(%<file>s): Having main keys: {sdkKey:%<sdk_key>s accountId:%<account_id>s u:%<u>s and tags:%<tags>s}'
         INVALID_VARIATION_KEY = '(%<file>s): Variation was not assigned to userId:%<user_id>s for campaign:%<campaign_key>s'
 
         USER_IN_FEATURE_ROLLOUT = '(%<file>s): User ID:%<user_id>s is in feature rollout:%<campaign_key>s'
@@ -140,6 +147,14 @@ class VWO
 
         SEGMENTATION_STATUS = '(%<file>s): In API: %<api_name>s, for UserId:%<user_id>s of campaign:%<campaign_key>s  with variables:%<custom_variables>s %<status>s %<segmentation_type>s %<variation_name>s'
         WHITELISTING_SKIPPED = '(%<file>s): In API: %<api_name>s, Skipping whitelisting for UserId:%<user_id>s of campaign:%<campaign_key>s'
+        SETTINGS_NOT_UPDATED = '(%<file>s): Settings-file fetched are same as earlier fetched settings'
+        SETTINGS_FILE_UPDATED = '(%<file>s): %<api_name>s vwo_sdk_instance is updated with the latest settings_file'
+        CAMPAIGN_NOT_ACTIVATED = '(%<file>s): Activate the campaign:%<campaign_key>s for User ID:%<user_id>s to %<reason>s.'
+        GOAL_ALREADY_TRACKED = '(%<file>s): Goal:%<goal_identifier>s of Campaign:%<campaign_key>s for User ID:%<user_id>s has already been tracked earlier. Skipping now'
+        USER_ALREADY_TRACKED = '(%<file>s): User ID:%<user_id>s for Campaign:%<campaign_key>s has already been tracked earlier for "%<api_name>s" API. Skipping now'
+        API_CALLED = '(%<file>s): API: {api_name} called for UserId:%<user_id>s'
+        BULK_IMPRESSION_SUCCESS = '(%<file>s): Impression event - %<end_point>s was successfully received by VWO having accountId:%<a>s'
+        AFTER_FLUSHING = '(%<file>s): Events queue having %<length>s events has been flushed %<manually>s queue summary: %<queue_metadata>s'
       end
 
       # Warning Messages
@@ -152,7 +167,7 @@ class VWO
         API_CONFIG_CORRUPTED = '(%<file>s): %<api_name>s API has corrupted configuration'
         GET_VARIATION_NAME_API_INVALID_PARAMS = '(%<file>s): %<api_name>s API got bad parameters. It expects campaignTestKey(String) as first and userId(String) as second argument, customVariables(Hash) can be passed via options for pre-segmentation'
         GET_VARIATION_API_CONFIG_CORRUPTED = '(%<file>s): "getVariation" API has corrupted configuration'
-        TRACK_API_INVALID_PARAMS = '(%<file>s): %<api_name>s API got bad parameters. It expects campaignTestKey(String) as first userId(String) as second and goalIdentifier(String/Number) as third argument. Fourth is revenueValue(Float/Number/String) and is required for revenue goal only. customVariables(Hash) can be passed via options for pre-segmentation'
+        TRACK_API_INVALID_PARAMS = '(%<file>s): %<api_name>s API got bad parameters. It expects campaignTestKey(Nil/String/Array) as first userId(String) as second and goalIdentifier(String/Number) as third argument. Fourth is revenueValue(Float/Number/String) and is required for revenue goal only. customVariables(Hash) can be passed via options for pre-segmentation'
         TRACK_API_CONFIG_CORRUPTED = '(%<file>s): "track" API has corrupted configuration'
         TRACK_API_GOAL_NOT_FOUND = '(%<file>s): Goal:%<goal_identifier>s not found for campaign:%<campaign_key>s and userId:%<user_id>s'
         TRACK_API_REVENUE_NOT_PASSED_FOR_REVENUE_GOAL = '(%<file>s): Revenue value should be passed for revenue goal:%<goal_identifier>s for campaign:%<campaign_key>s and userId:%<user_id>s'
@@ -179,6 +194,16 @@ class VWO
         PUSH_API_INVALID_PARAMS = '(%<file>s): %<api_name>s API got bad parameters. It expects tag_key(String) as first and tag_value(String) as second argument and user_id(String) as third argument'
         TAG_VALUE_LENGTH_EXCEEDED = '(%<file>s): In API: %<api_name>s, the length of tag_value:%<tag_value>s and userID: %<user_id>s can not be greater than 255'
         TAG_KEY_LENGTH_EXCEEDED = '(%<file>s): In API: %<api_name>s, the length of tag_key:%<tag_key>s and userID: %<user_id>s can not be greater than 255'
+        TRACK_API_MISSING_PARAMS = '(%<file>s): "track" API got bad parameters. It expects campaignKey(null/String/array) as first, userId(String/Number) as second and goalIdentifier (string) as third argument. options is revenueValue(Float/Number/String) and is required for revenue goal only.'
+        NO_CAMPAIGN_FOUND = '(%<file>s): No campaign found for goal_identifier:%<goal_identifier>s. Please verify from VWO app.'
+        INVALID_TRACK_RETURNING_USER_VALUE  = '(%<file>s): should_track_returning_user should be boolean'
+        INVALID_GOAL_TYPE = '(%<file>s): goal_type_to_track should be certain strings'
+        EVENT_BATCHING_NOT_OBJECT = '(%<file>s): Batch events settings are not of type object.'
+        EVENTS_PER_REQUEST_INVALID = '(%<file>s): events_per_request should be an integer'
+        REQUEST_TIME_INTERVAL_INVALID = '(%<file>s): request_time_interval should be a number'
+        EVENTS_PER_REQUEST_OUT_OF_BOUNDS = '(%<file>s): events_per_request should be >= %<min_value>s and <= %<max_value>s'
+        REQUEST_TIME_INTERVAL_OUT_OF_BOUNDS = '(%<file>s): request_time_interval should be >= %<min_value>s'
+        FLUSH_CALLBACK_INVALID = '(%<file>s): flush_callback is not callable'
       end
     end
 

data/lib/vwo/logger.rb

@@ -1,4 +1,4 @@
-# Copyright 2019-2020 Wingify Software Pvt. Ltd.
+# Copyright 2019-2021 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.