feat: attribute based targeting

Author: sakshamg1304

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [1.13.0] - 2025-09-04
+
+### Added
+
+- Post-segmentation variables are now automatically included as unregistered attributes, enabling post-segmentation without requiring manual setup.
+- Added support for built-in targeting conditions, including browser version, OS version, and IP address, with advanced operator support (greaterThan, lessThan, regex).
+
 ## [1.12.0] - 2025-09-02
 
 ### Added

setup.py

@@ -121,7 +121,7 @@ def run(self):
 
 setup(
     name="vwo-fme-python-sdk",
-    version="1.12.0",
+    version="1.13.0",
     description="VWO Feature Management and Experimentation SDK for Python",
     long_description=long_description,
     long_description_content_type="text/markdown",

vwo/constants/Constants.py

@@ -17,7 +17,7 @@ class Constants:
     # TODO: read from setup.py
     sdk_meta = {
         "name": "vwo-fme-python-sdk",
-        "version": "1.12.0"
+        "version": "1.13.0"
     }
 
     # Constants

vwo/models/user/context_model.py

@@ -14,7 +14,7 @@
 
 
 from .context_vwo_model import ContextVWOModel
-from typing import Dict
+from typing import Dict, List
 
 
 class ContextModel:
@@ -27,6 +27,7 @@ def __init__(self, context: Dict):
             "variation_targeting_variables", {}
         )
         self._vwo = ContextVWOModel(context.get("_vwo")) if "_vwo" in context else None
+        self.post_segmentation_variables = context.get("post_segmentation_variables", [])
 
     def get_id(self) -> str:
         return str(self.id) if self.id is not None else None
@@ -56,3 +57,9 @@ def get_vwo(self) -> ContextVWOModel:
 
     def set_vwo(self, vwo: ContextVWOModel) -> None:
         self._vwo = vwo
+
+    def get_post_segmentation_variables(self) -> List[str]:
+        return self.post_segmentation_variables
+
+    def set_post_segmentation_variables(self, post_segmentation_variables: List[str]) -> None:
+        self.post_segmentation_variables = post_segmentation_variables

vwo/packages/segmentation_evaluator/core/segmentation_manager.py

@@ -22,6 +22,8 @@
 from ....models.campaign.feature_model import FeatureModel
 from ....models.user.context_model import ContextModel
 from ....utils.gateway_service_util import get_query_params, get_from_gateway_service
+from ....constants.Constants import Constants
+from ....services.url_service import UrlService
 
 
 class SegmentationManager:
@@ -77,27 +79,32 @@ def set_contextual_data(
         if not context.get_user_agent() and not context.get_ip_address():
             return
 
-        if (
-            feature.get_is_gateway_service_required()
-        ):  # Check if gateway service is required
-            if SettingsManager.get_instance().is_gateway_service_provided and (
-                context.get_vwo() is None
-            ):
-                query_params = {}
-                if context.get_user_agent():
-                    query_params["userAgent"] = context.get_user_agent()
-
-                if context.get_ip_address():
-                    query_params["ipAddress"] = context.get_ip_address()
-
-                try:
-                    params = get_query_params(query_params)
-                    _vwo = get_from_gateway_service(params, UrlEnum.GET_USER_DATA.value)
-                    context.set_vwo(ContextVWOModel(_vwo))
-                except Exception as err:
-                    LogManager.get_instance().error(
-                        f"Error in setting contextual data for segmentation. Got error: {err}"
-                    )
+        # Call gateway service if required for segmentation OR if gateway service is provided and user agent is available
+        should_call_gateway_service = (
+            (feature.get_is_gateway_service_required() and Constants.HOST_NAME not in UrlService.get_base_url()) or
+            (Constants.HOST_NAME not in UrlService.get_base_url() and 
+             (context.get_user_agent() or context.get_ip_address()))
+        )
+        
+        if should_call_gateway_service and context.get_vwo() is None:
+            query_params = {}
+            if not context.get_user_agent() and not context.get_ip_address():
+                return
+                
+            if context.get_user_agent():
+                query_params["userAgent"] = context.get_user_agent()
+
+            if context.get_ip_address():
+                query_params["ipAddress"] = context.get_ip_address()
+
+            try:
+                params = get_query_params(query_params)
+                _vwo = get_from_gateway_service(params, UrlEnum.GET_USER_DATA.value)
+                context.set_vwo(ContextVWOModel(_vwo))
+            except Exception as err:
+                LogManager.get_instance().error(
+                    f"Error in setting contextual data for segmentation. Got error: {err}"
+                )
 
     def validate_segmentation(self, dsl, properties):
         """

vwo/packages/segmentation_evaluator/enums/segment_operand_regex_enum.py

@@ -25,7 +25,7 @@ class SegmentOperandRegexEnum(Enum):
     REGEX_MATCH = r"^regex\((.*)\)"
     STARTING_STAR = r"^\*"
     ENDING_STAR = r"\*$"
-    GREATER_THAN_MATCH = r"^gt\((\d+\.?\d*|\.\d+)\)$"
-    GREATER_THAN_EQUAL_TO_MATCH = r"^gte\((\d+\.?\d*|\.\d+)\)$"
-    LESS_THAN_MATCH = r"^lt\((\d+\.?\d*|\.\d+)\)$"
-    LESS_THAN_EQUAL_TO_MATCH = r"^lte\((\d+\.?\d*|\.\d+)\)$"
+    GREATER_THAN_MATCH = r"^gt\(([\d.]+)\)$"
+    GREATER_THAN_EQUAL_TO_MATCH = r"^gte\(([\d.]+)\)$"
+    LESS_THAN_MATCH = r"^lt\(([\d.]+)\)$"
+    LESS_THAN_EQUAL_TO_MATCH = r"^lte\(([\d.]+)\)$"

vwo/packages/segmentation_evaluator/enums/segment_operator_value_enum.py

@@ -31,3 +31,6 @@ class SegmentOperatorValueEnum(Enum):
     BROWSER_AGENT = "browser_string"
     UA = "ua"
     FEATURE_ID = "featureId"
+    IP = "ip_address"
+    BROWSER_VERSION = "browser_version"
+    OS_VERSION = "os_version"

vwo/packages/segmentation_evaluator/evaluators/segment_evaluator.py

@@ -55,6 +55,18 @@ def is_segmentation_valid(self, dsl, properties):
             return SegmentOperandEvaluator().evaluate_user_agent_dsl(
                 sub_dsl, self.context
             )
+        elif operator == SegmentOperatorValueEnum.IP.value:
+            return SegmentOperandEvaluator().evaluate_string_operand_dsl(
+                sub_dsl, self.context, SegmentOperatorValueEnum.IP.value
+            )
+        elif operator == SegmentOperatorValueEnum.BROWSER_VERSION.value:
+            return SegmentOperandEvaluator().evaluate_string_operand_dsl(
+                sub_dsl, self.context, SegmentOperatorValueEnum.BROWSER_VERSION.value
+            )
+        elif operator == SegmentOperatorValueEnum.OS_VERSION.value:
+            return SegmentOperandEvaluator().evaluate_string_operand_dsl(
+                sub_dsl, self.context, SegmentOperatorValueEnum.OS_VERSION.value
+            )
         else:
             return False