optimizely-sdk 5.6.0__tar.gz → 5.8.0__tar.gz

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Optimizely Python SDK Changelog
 
+## 5.8.0
+October 30th, 2026
+
+### Changed
+
+**Local Holdouts: rule evaluation continues after a holdout hit**: 
+When a user matches a local holdout on a rule, the SDK now excludes the user from that rule only 
+and continues evaluating the remaining rules, instead of returning the holdout variation and skipping 
+the rest of the flag. Each local holdout hit sends its own holdout impression event (using the 
+existing event format), regardless of `sendFlagDecisions`. Global holdouts are unchanged.
+
+- Continue rule evaluation after local holdout hit ([#525](https://github.com/optimizely/python-sdk/pull/525))
+- Remove dead Python 3.7 typing guards ([#526](https://github.com/optimizely/python-sdk/pull/526))
+
+---
+
+## 5.7.0
+September 2nd, 2026
+
+### New Features
+
+**Holdout Targeted Delivery Exclusion**: Holdouts can now be configured to exclude Targeted Delivery rules, so users held out of experiments still receive their Targeted Delivery experiences. This gives you a cleaner measure of experiment impact without holding users back from ongoing rollouts.
+
+- Add holdout exclusion logic for Targeted Delivery rules ([#522](https://github.com/optimizely/python-sdk/pull/522))
+
+---
+
 ## 5.6.0
 July 10th, 2026
 

{optimizely_sdk-5.6.0/optimizely_sdk.egg-info → optimizely_sdk-5.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optimizely-sdk
-Version: 5.6.0
+Version: 5.8.0
 Summary: Python SDK for Optimizely Feature Experimentation, Optimizely Full Stack (legacy), and Optimizely Rollouts.
 Home-page: https://github.com/optimizely/python-sdk
 Author: Optimizely
@@ -24,17 +24,17 @@ Requires-Dist: requests>=2.21
 Requires-Dist: idna>=2.10
 Requires-Dist: rpds-py<0.20.0; python_version < "3.11"
 Provides-Extra: test
+Requires-Dist: funcsigs>=0.4; extra == "test"
+Requires-Dist: python-coveralls; extra == "test"
+Requires-Dist: requests>=2.21; extra == "test"
 Requires-Dist: pytest>=6.2.0; extra == "test"
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: jsonschema>=3.2.0; extra == "test"
-Requires-Dist: pyrsistent>=0.16.0; extra == "test"
-Requires-Dist: requests>=2.21; extra == "test"
 Requires-Dist: rpds-py<0.20.0; python_version < "3.11" and extra == "test"
-Requires-Dist: python-coveralls; extra == "test"
-Requires-Dist: funcsigs>=0.4; extra == "test"
 Requires-Dist: idna>=2.10; extra == "test"
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: ruff>=0.15.0; extra == "test"
+Requires-Dist: pyrsistent>=0.16.0; extra == "test"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -304,6 +304,33 @@ idna (BSD 3-Clause License https://github.com/kjd/idna/blob/master/LICENSE.md)
 - Swift - https://github.com/optimizely/swift-sdk
 # Optimizely Python SDK Changelog
 
+## 5.8.0
+October 30th, 2026
+
+### Changed
+
+**Local Holdouts: rule evaluation continues after a holdout hit**: 
+When a user matches a local holdout on a rule, the SDK now excludes the user from that rule only 
+and continues evaluating the remaining rules, instead of returning the holdout variation and skipping 
+the rest of the flag. Each local holdout hit sends its own holdout impression event (using the 
+existing event format), regardless of `sendFlagDecisions`. Global holdouts are unchanged.
+
+- Continue rule evaluation after local holdout hit ([#525](https://github.com/optimizely/python-sdk/pull/525))
+- Remove dead Python 3.7 typing guards ([#526](https://github.com/optimizely/python-sdk/pull/526))
+
+---
+
+## 5.7.0
+September 2nd, 2026
+
+### New Features
+
+**Holdout Targeted Delivery Exclusion**: Holdouts can now be configured to exclude Targeted Delivery rules, so users held out of experiments still receive their Targeted Delivery experiences. This gives you a cleaner measure of experiment impact without holding users back from ongoing rollouts.
+
+- Add holdout exclusion logic for Targeted Delivery rules ([#522](https://github.com/optimizely/python-sdk/pull/522))
+
+---
+
 ## 5.6.0
 July 10th, 2026
 

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/bucketer.py

@@ -12,19 +12,12 @@
 # limitations under the License.
 
 from __future__ import annotations
-from typing import Optional, TYPE_CHECKING, cast
+from typing import Optional, TYPE_CHECKING, cast, Final
 import math
-from sys import version_info
 
 from .lib import pymmh3 as mmh3
 
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
-
 if TYPE_CHECKING:
     # prevent circular dependenacy by skipping import at runtime
     from .project_config import ProjectConfig

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/decision/optimizely_decide_option.py

@@ -11,12 +11,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
+from typing import Final
 
 
 class OptimizelyDecideOption:

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/decision/optimizely_decision_message.py

@@ -11,12 +11,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
+from typing import Final
 
 
 class OptimizelyDecisionMessage:

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/decision_service.py

@@ -1,4 +1,4 @@
-# Copyright 2017-2022, Optimizely
+# Copyright 2017-2022, 2026, Optimizely
 # 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
@@ -64,15 +64,12 @@ class VariationResult(TypedDict):
     variation: Optional[Union[entities.Variation, VariationDict]]
 
 
-class DecisionResult(TypedDict):
-    """
-    A TypedDict representing the result of a decision process.
+class _DecisionResultOptional(TypedDict, total=False):
+    holdout_decision: Decision  # Deprecated: first entry of holdout_decisions.
+    holdout_decisions: List[Decision]
 
-    Attributes:
-        decision (Decision): The decision object containing the outcome of the evaluation.
-        error (bool): Indicates whether an error occurred during the decision process.
-        reasons (List[str]): A list of reasons explaining the decision or any errors encountered.
-    """
+
+class DecisionResult(_DecisionResultOptional):
     decision: Decision
     error: bool
     reasons: List[str]
@@ -556,7 +553,11 @@ class DecisionService:
         }
 
     def get_variation_for_rollout(
-        self, project_config: ProjectConfig, feature: entities.FeatureFlag, user_context: OptimizelyUserContext
+        self,
+        project_config: ProjectConfig,
+        feature: entities.FeatureFlag,
+        user_context: OptimizelyUserContext,
+        holdout_decisions: Optional[list[Decision]] = None
     ) -> tuple[Decision, list[str]]:
         """ Determine which experiment/variation the user is in for a given rollout.
             Returns the variation of the first experiment the user qualifies for.
@@ -566,7 +567,7 @@ class DecisionService:
           flagKey: Feature key.
           rollout: Rollout for which we are getting the variation.
           user: ID and attributes for user.
-          options: Decide options.
+          holdout_decisions: If provided, local holdout decisions for skipped rules are appended to it.
 
         Returns:
           Decision namedtuple consisting of experiment and variation for the user and
@@ -610,23 +611,14 @@ class DecisionService:
                 return Decision(experiment=rule, variation=forced_decision_variation,
                                 source=enums.DecisionSources.ROLLOUT, cmab_uuid=None), decide_reasons
 
-            # Check local holdouts targeting this specific delivery rule (FSSDK-12369)
-            local_holdouts = project_config.get_holdouts_for_rule(rule.id)
-            for holdout in local_holdouts:
-                local_holdout_decision = self.get_variation_for_holdout(
-                    holdout, user_context, project_config
-                )
-                decide_reasons.extend(local_holdout_decision['reasons'])
-
-                local_decision = local_holdout_decision['decision']
-                if local_decision.variation is not None:
-                    message = (
-                        f"The user '{user_id}' is bucketed into local holdout '{holdout.key}' "
-                        f"for delivery rule '{rule.key}'."
-                    )
-                    self.logger.info(message)
-                    decide_reasons.append(message)
-                    return local_decision, decide_reasons
+            local_holdout = self._get_local_holdout_decision(
+                project_config, rule, user_context, 'delivery', decide_reasons
+            )
+            if local_holdout is not None:
+                if holdout_decisions is not None:
+                    holdout_decisions.append(local_holdout)
+                index += 1
+                continue
 
             bucketing_id, bucket_reasons = self._get_bucketing_id(user_id, attributes)
             decide_reasons += bucket_reasons
@@ -751,6 +743,10 @@ class DecisionService:
         reasons = decide_reasons.copy() if decide_reasons else []
         user_id = user_context.user_id
 
+        global_holdout_result: DecisionResult | None = None
+        global_holdout_key: str | None = None
+        holdout_decisions: list[Decision] = []
+
         # Check global holdouts (flag level — before any rules are evaluated)
         global_holdouts = project_config.get_global_holdouts()
         for holdout in global_holdouts:
@@ -758,7 +754,6 @@ class DecisionService:
             reasons.extend(holdout_decision['reasons'])
 
             decision = holdout_decision['decision']
-            # Check if user was bucketed into holdout (has a variation)
             if decision.variation is None:
                 continue
 
@@ -768,18 +763,34 @@ class DecisionService:
             )
             self.logger.info(message)
             reasons.append(message)
-            return {
-                'decision': holdout_decision['decision'],
-                'error': False,
-                'reasons': reasons
-            }
 
-        # If no global holdout decision, check experiments then rollouts
+            if not holdout.exclude_targeted_deliveries:
+                return {
+                    'decision': holdout_decision['decision'],
+                    'error': False,
+                    'reasons': reasons
+                }
+
+            message = (
+                f"Holdout '{holdout.key}' excludes targeted deliveries. "
+                f"Targeted delivery rules will be evaluated."
+            )
+            self.logger.info(message)
+            reasons.append(message)
+            global_holdout_result = holdout_decision
+            global_holdout_key = holdout.key
+            holdout_decisions.append(holdout_decision['decision'])
+            break
+
+        # Check experiments then rollouts
         if feature_flag.experimentIds:
             for experiment_id in feature_flag.experimentIds:
                 experiment = project_config.get_experiment_from_id(experiment_id)
 
                 if experiment:
+                    if global_holdout_result is not None and experiment.type != enums.ExperimentTypes.td:
+                        continue
+
                     # Check for forced decision
                     optimizely_decision_context = OptimizelyUserContext.OptimizelyDecisionContext(
                         feature_flag.key, experiment.key)
@@ -790,33 +801,22 @@ class DecisionService:
                     if forced_decision_variation:
                         decision = Decision(experiment, forced_decision_variation,
                                             enums.DecisionSources.FEATURE_TEST, None)
-                        return {
+                        result: DecisionResult = {
                             'decision': decision,
                             'error': False,
                             'reasons': reasons
                         }
+                        if holdout_decisions:
+                            result['holdout_decisions'] = holdout_decisions
+                            result['holdout_decision'] = holdout_decisions[0]
+                        return result
 
-                    # Check local holdouts targeting this specific experiment rule (FSSDK-12369)
-                    local_holdouts = project_config.get_holdouts_for_rule(experiment.id)
-                    for holdout in local_holdouts:
-                        local_holdout_decision = self.get_variation_for_holdout(
-                            holdout, user_context, project_config
-                        )
-                        reasons.extend(local_holdout_decision['reasons'])
-
-                        local_decision = local_holdout_decision['decision']
-                        if local_decision.variation is not None:
-                            message = (
-                                f"The user '{user_id}' is bucketed into local holdout '{holdout.key}' "
-                                f"for experiment rule '{experiment.key}'."
-                            )
-                            self.logger.info(message)
-                            reasons.append(message)
-                            return {
-                                'decision': local_holdout_decision['decision'],
-                                'error': False,
-                                'reasons': reasons
-                            }
+                    local_holdout = self._get_local_holdout_decision(
+                        project_config, experiment, user_context, 'experiment', reasons
+                    )
+                    if local_holdout is not None:
+                        holdout_decisions.append(local_holdout)
+                        continue
 
                     # Get variation for experiment
                     variation_result = self.get_variation(
@@ -837,15 +837,27 @@ class DecisionService:
                         decision = Decision(experiment, variation_result['variation'],
                                             enums.DecisionSources.FEATURE_TEST,
                                             variation_result['cmab_uuid'])
-                        return {
+                        result = {
                             'decision': decision,
                             'error': False,
                             'reasons': reasons
                         }
+                        if holdout_decisions:
+                            result['holdout_decisions'] = holdout_decisions
+                            result['holdout_decision'] = holdout_decisions[0]
+                        return result
+
+        if global_holdout_result is not None:
+            message = (
+                f"Holdout \"{global_holdout_key}\" has excludeTargetedDeliveries enabled, "
+                f"continuing to rollout evaluation."
+            )
+            self.logger.info(message)
+            reasons.append(message)
 
         # If no experiment decision, check rollouts
         rollout_decision, rollout_reasons = self.get_variation_for_rollout(
-            project_config, feature_flag, user_context
+            project_config, feature_flag, user_context, holdout_decisions
         )
         if rollout_reasons:
             reasons.extend(rollout_reasons)
@@ -863,11 +875,37 @@ class DecisionService:
         else:
             self.logger.debug(f'User "{user_id}" not bucketed into any rollout for feature "{feature_flag.key}".')
 
-        return {
+        final_result: DecisionResult = {
             'decision': rollout_decision,
             'error': False,
             'reasons': reasons
         }
+        if holdout_decisions:
+            final_result['holdout_decisions'] = holdout_decisions
+            final_result['holdout_decision'] = holdout_decisions[0]
+        return final_result
+
+    def _get_local_holdout_decision(
+        self,
+        project_config: ProjectConfig,
+        rule: entities.Experiment,
+        user_context: OptimizelyUserContext,
+        rule_type: str,
+        reasons: list[str]
+    ) -> Optional[Decision]:
+        """Returns the first local holdout decision the user is bucketed into for the rule, if any."""
+        for holdout in project_config.get_holdouts_for_rule(rule.id):
+            holdout_result = self.get_variation_for_holdout(holdout, user_context, project_config)
+            reasons.extend(holdout_result['reasons'])
+            if holdout_result['decision'].variation is not None:
+                message = (
+                    f"The user '{user_context.user_id}' is bucketed into local holdout '{holdout.key}' "
+                    f"for {rule_type} rule '{rule.key}'. Skipping the rule."
+                )
+                self.logger.info(message)
+                reasons.append(message)
+                return holdout_result['decision']
+        return None
 
     def get_variation_for_holdout(
         self,

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/entities.py

@@ -11,13 +11,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 from __future__ import annotations
-from typing import TYPE_CHECKING, Any, Optional, Sequence
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
+from typing import TYPE_CHECKING, Any, Optional, Sequence, Final
 
 
 if TYPE_CHECKING:
@@ -224,6 +218,7 @@ class Holdout(BaseEntity):
         audienceIds: list[str],
         audienceConditions: Optional[Sequence[str | list[str]]] = None,
         includedRules: Optional[list[str]] = None,
+        excludeTargetedDeliveries: bool = False,
         **kwargs: Any
     ):
         self.id = id
@@ -236,6 +231,7 @@ class Holdout(BaseEntity):
         # Per-rule targeting for local holdouts. Scope comes from the datafile
         # section, not this field; ProjectConfig strips it on 'holdouts' entries.
         self.included_rules: Optional[list[str]] = includedRules
+        self.exclude_targeted_deliveries: bool = excludeTargetedDeliveries
 
     def get_audience_conditions_or_ids(self) -> Sequence[str | list[str]]:
         """Returns audienceConditions if present, otherwise audienceIds.

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/event/event_factory.py

@@ -12,8 +12,7 @@
 # limitations under the License.
 
 from __future__ import annotations
-from typing import TYPE_CHECKING, Optional, Sequence, cast, List
-from sys import version_info
+from typing import TYPE_CHECKING, Optional, Sequence, cast, List, Final
 from optimizely import entities
 from optimizely.helpers import enums
 from optimizely.helpers import event_tag_utils
@@ -23,11 +22,6 @@ from . import log_event
 from . import payload
 from . import user_event
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
 if TYPE_CHECKING:
     # prevent circular dependenacy by skipping import at runtime
     from optimizely.project_config import ProjectConfig

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/event/event_processor.py

@@ -17,10 +17,9 @@ import numbers
 import threading
 import time
 
-from typing import Optional
+from typing import Optional, Final
 from datetime import timedelta
 import queue
-from sys import version_info
 
 from optimizely import logger as _logging
 from optimizely import notification_center as _notification_center
@@ -31,12 +30,6 @@ from .event_factory import EventFactory
 from .user_event import UserEvent
 
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
-
 class BaseEventProcessor(ABC):
     """ Class encapsulating event processing. Override with your own implementation. """
 

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/event/log_event.py

@@ -12,17 +12,10 @@
 # limitations under the License.
 
 from __future__ import annotations
-from typing import Optional, Any
-from sys import version_info
+from typing import Optional, Any, Literal
 from optimizely import event_builder
 
 
-if version_info < (3, 8):
-    from typing_extensions import Literal
-else:
-    from typing import Literal
-
-
 class LogEvent(event_builder.Event):
     """ Representation of an event which can be sent to Optimizely events API. """
 

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/event/user_event.py

@@ -13,18 +13,11 @@
 from __future__ import annotations
 import time
 import uuid
-from typing import TYPE_CHECKING, Optional
-from sys import version_info
+from typing import TYPE_CHECKING, Optional, Final
 
 from optimizely import version
 
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
-
 if TYPE_CHECKING:
     # prevent circular dependenacy by skipping import at runtime
     from optimizely.entities import Experiment, Variation, Event, Holdout

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/event_builder.py

@@ -13,9 +13,8 @@
 
 from __future__ import annotations
 import time
-from typing import TYPE_CHECKING, Any, Optional
+from typing import TYPE_CHECKING, Any, Optional, Final, Literal
 import uuid
-from sys import version_info
 
 from . import version
 from .event import event_id_normalizer
@@ -23,11 +22,6 @@ from .helpers import enums
 from .helpers import event_tag_utils
 from .helpers import validator
 
-if version_info < (3, 8):
-    from typing_extensions import Final, Literal
-else:
-    from typing import Final, Literal
-
 if TYPE_CHECKING:
     # prevent circular dependenacy by skipping import at runtime
     from .entities import Experiment

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/event_dispatcher.py

@@ -13,7 +13,7 @@
 
 import json
 import logging
-from sys import version_info
+from typing import Protocol
 
 import requests
 from requests import exceptions as request_exception
@@ -23,11 +23,6 @@ from urllib3.util.retry import Retry
 from . import event_builder
 from .helpers.enums import HTTPVerbs, EventDispatchConfig
 
-if version_info < (3, 8):
-    from typing_extensions import Protocol
-else:
-    from typing import Protocol
-
 
 class CustomEventDispatcher(Protocol):
     """Interface for a custom event dispatcher and required method `dispatch_event`. """

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/helpers/condition.py

@@ -14,8 +14,7 @@
 from __future__ import annotations
 import json
 import numbers
-from typing import TYPE_CHECKING, Any, Callable, Optional
-from sys import version_info
+from typing import TYPE_CHECKING, Any, Callable, Optional, Literal, Final
 
 from . import validator
 from optimizely import optimizely_user_context
@@ -29,12 +28,6 @@ if TYPE_CHECKING:
     from optimizely.logger import Logger
 
 
-if version_info < (3, 8):
-    from typing_extensions import Literal, Final
-else:
-    from typing import Literal, Final
-
-
 class ConditionOperatorTypes:
     AND: Final = 'and'
     OR: Final = 'or'

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/helpers/enums.py

@@ -12,12 +12,7 @@
 # limitations under the License.
 
 import logging
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
+from typing import Final
 
 
 class CommonAudienceEvaluationLogs:

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/helpers/event_tag_utils.py

@@ -12,16 +12,10 @@
 # limitations under the License.
 
 from __future__ import annotations
-from typing import TYPE_CHECKING, Any, Optional, NewType, Dict
+from typing import TYPE_CHECKING, Any, Optional, NewType, Dict, Final
 from . import enums
 import math
 import numbers
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
 
 
 if TYPE_CHECKING:

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/helpers/types.py

@@ -12,14 +12,7 @@
 # limitations under the License.
 from __future__ import annotations
 
-from typing import Literal, Optional, Any
-from sys import version_info
-
-
-if version_info < (3, 8):
-    from typing_extensions import TypedDict
-else:
-    from typing import TypedDict  # type: ignore
+from typing import Literal, Optional, Any, TypedDict
 
 
 # Intermediate types for type checking deserialized datafile json before actual class instantiation.

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/logger.py

@@ -11,17 +11,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 import logging
-from typing import Any, Optional, Union
+from typing import Any, Optional, Union, Final
 import warnings
-from sys import version_info
 
 from .helpers import enums
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
 
 _DEFAULT_LOG_FORMAT: Final = '%(levelname)-8s %(asctime)s %(filename)s:%(lineno)s:%(message)s'
 

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/notification_center.py

@@ -12,15 +12,9 @@
 # limitations under the License.
 
 from __future__ import annotations
-from typing import Any, Callable, Optional
+from typing import Any, Callable, Optional, Final
 from .helpers import enums
 from . import logger as optimizely_logger
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
 
 
 NOTIFICATION_TYPES: Final = tuple(

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/odp/lru_cache.py

@@ -16,13 +16,7 @@ from dataclasses import dataclass, field
 import threading
 from time import time
 from collections import OrderedDict
-from typing import Optional, Generic, TypeVar, Hashable
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Protocol
-else:
-    from typing import Protocol
+from typing import Optional, Generic, TypeVar, Hashable, Protocol
 
 # generic type definitions for LRUCache parameters
 K = TypeVar('K', bound=Hashable, contravariant=True)

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/odp/optimizely_odp_option.py

@@ -11,12 +11,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from sys import version_info
-
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
+from typing import Final
 
 
 class OptimizelyOdpOption:

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/optimizely.py

@@ -1,4 +1,4 @@
-# Copyright 2016-2023, Optimizely
+# Copyright 2016-2023, 2026, Optimizely
 # 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
@@ -1245,7 +1245,8 @@ class Optimizely:
             flag_decision: Decision,
             decision_reasons: Optional[list[str]],
             decide_options: list[str],
-            project_config: ProjectConfig
+            project_config: ProjectConfig,
+            holdout_decisions: Optional[list[Decision]] = None
     ) -> OptimizelyDecision:
         user_id = user_context.user_id
         feature_enabled = False
@@ -1264,6 +1265,27 @@ class Optimizely:
 
         feature_flag = project_config.feature_key_map.get(flag_key)
 
+        # Skipped local holdouts and global holdouts bypassed by exclude_targeted_deliveries
+        if (holdout_decisions
+                and decision_source != DecisionSources.HOLDOUT
+                and OptimizelyDecideOption.DISABLE_DECISION_EVENT not in decide_options):
+            for holdout_decision in holdout_decisions:
+                holdout_enabled = self._get_feature_enabled(holdout_decision.variation)
+                holdout_rule_key = holdout_decision.experiment.key if holdout_decision.experiment else ''
+                self._send_impression_event(
+                    project_config,
+                    holdout_decision.experiment,
+                    holdout_decision.variation,
+                    flag_key,
+                    holdout_rule_key,
+                    str(DecisionSources.HOLDOUT),
+                    holdout_enabled,
+                    user_id,
+                    attributes,
+                    holdout_decision.cmab_uuid
+                )
+            decision_event_dispatched = True
+
         # Send impression event if Decision came from a feature
         if OptimizelyDecideOption.DISABLE_DECISION_EVENT not in decide_options:
             if (decision_source == DecisionSources.FEATURE_TEST or
@@ -1448,11 +1470,13 @@ class Optimizely:
             user_context,
             merged_decide_options
         )
+        holdout_decisions: dict[str, Optional[list[Decision]]] = {}
         for i in range(0, len(flags_without_forced_decision)):
             decision = decision_list[i]['decision']
             reasons = decision_list[i]['reasons']
             error = decision_list[i]['error']
             flag_key = flags_without_forced_decision[i].key
+            holdout_decisions[flag_key] = decision_list[i].get('holdout_decisions')
             # store error decision against key and remove key from valid keys
             if error:
                 optimizely_decision = OptimizelyDecision.new_error_decision(flags_without_forced_decision[i].key,
@@ -1472,7 +1496,8 @@ class Optimizely:
                 flag_decision,
                 decision_reasons,
                 merged_decide_options,
-                project_config
+                project_config,
+                holdout_decisions=holdout_decisions.get(key)
             )
             enabled_flags_only_missing = OptimizelyDecideOption.ENABLED_FLAGS_ONLY not in merged_decide_options
             is_enabled = optimizely_decision.enabled

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/project_config.py

@@ -12,8 +12,7 @@
 # limitations under the License.
 from __future__ import annotations
 import json
-from typing import TYPE_CHECKING, Optional, Type, TypeVar, Union, cast, Any, Iterable, List
-from sys import version_info
+from typing import TYPE_CHECKING, Optional, Type, TypeVar, Union, cast, Any, Iterable, List, Final
 
 from . import entities
 from . import exceptions
@@ -21,11 +20,6 @@ from .helpers import condition as condition_helper
 from .helpers import enums
 from .helpers import types
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
 if TYPE_CHECKING:
     # prevent circular dependenacy by skipping import at runtime
     from .logger import Logger

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/user_profile.py

@@ -12,19 +12,13 @@
 # limitations under the License.
 
 from __future__ import annotations
-from typing import Any, Optional
-from sys import version_info
+from typing import Any, Optional, Final, TYPE_CHECKING
 from . import logger as _logging
 
-if version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final, TYPE_CHECKING
-
-    if TYPE_CHECKING:
-        # prevent circular dependenacy by skipping import at runtime
-        from .entities import Experiment, Variation
-        from optimizely.error_handler import BaseErrorHandler
+if TYPE_CHECKING:
+    # prevent circular dependenacy by skipping import at runtime
+    from .entities import Experiment, Variation
+    from optimizely.error_handler import BaseErrorHandler
 
 
 class UserProfile:

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely/version.py

@@ -11,5 +11,5 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-version_info = (5, 6, 0)
+version_info = (5, 8, 0)
 __version__ = '.'.join(str(v) for v in version_info)

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0/optimizely_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optimizely-sdk
-Version: 5.6.0
+Version: 5.8.0
 Summary: Python SDK for Optimizely Feature Experimentation, Optimizely Full Stack (legacy), and Optimizely Rollouts.
 Home-page: https://github.com/optimizely/python-sdk
 Author: Optimizely
@@ -24,17 +24,17 @@ Requires-Dist: requests>=2.21
 Requires-Dist: idna>=2.10
 Requires-Dist: rpds-py<0.20.0; python_version < "3.11"
 Provides-Extra: test
+Requires-Dist: funcsigs>=0.4; extra == "test"
+Requires-Dist: python-coveralls; extra == "test"
+Requires-Dist: requests>=2.21; extra == "test"
 Requires-Dist: pytest>=6.2.0; extra == "test"
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: jsonschema>=3.2.0; extra == "test"
-Requires-Dist: pyrsistent>=0.16.0; extra == "test"
-Requires-Dist: requests>=2.21; extra == "test"
 Requires-Dist: rpds-py<0.20.0; python_version < "3.11" and extra == "test"
-Requires-Dist: python-coveralls; extra == "test"
-Requires-Dist: funcsigs>=0.4; extra == "test"
 Requires-Dist: idna>=2.10; extra == "test"
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: ruff>=0.15.0; extra == "test"
+Requires-Dist: pyrsistent>=0.16.0; extra == "test"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -304,6 +304,33 @@ idna (BSD 3-Clause License https://github.com/kjd/idna/blob/master/LICENSE.md)
 - Swift - https://github.com/optimizely/swift-sdk
 # Optimizely Python SDK Changelog
 
+## 5.8.0
+October 30th, 2026
+
+### Changed
+
+**Local Holdouts: rule evaluation continues after a holdout hit**: 
+When a user matches a local holdout on a rule, the SDK now excludes the user from that rule only 
+and continues evaluating the remaining rules, instead of returning the holdout variation and skipping 
+the rest of the flag. Each local holdout hit sends its own holdout impression event (using the 
+existing event format), regardless of `sendFlagDecisions`. Global holdouts are unchanged.
+
+- Continue rule evaluation after local holdout hit ([#525](https://github.com/optimizely/python-sdk/pull/525))
+- Remove dead Python 3.7 typing guards ([#526](https://github.com/optimizely/python-sdk/pull/526))
+
+---
+
+## 5.7.0
+September 2nd, 2026
+
+### New Features
+
+**Holdout Targeted Delivery Exclusion**: Holdouts can now be configured to exclude Targeted Delivery rules, so users held out of experiments still receive their Targeted Delivery experiences. This gives you a cleaner measure of experiment impact without holding users back from ongoing rollouts.
+
+- Add holdout exclusion logic for Targeted Delivery rules ([#522](https://github.com/optimizely/python-sdk/pull/522))
+
+---
+
 ## 5.6.0
 July 10th, 2026
 

{optimizely_sdk-5.6.0 → optimizely_sdk-5.8.0}/optimizely_sdk.egg-info/requires.txt

@@ -7,16 +7,16 @@ idna>=2.10
 rpds-py<0.20.0
 
 [test]
+funcsigs>=0.4
+python-coveralls
+requests>=2.21
 pytest>=6.2.0
-coverage
-pytest-cov
 jsonschema>=3.2.0
-pyrsistent>=0.16.0
-requests>=2.21
-python-coveralls
-funcsigs>=0.4
 idna>=2.10
+coverage
+pytest-cov
 ruff>=0.15.0
+pyrsistent>=0.16.0
 
 [test:python_version < "3.11"]
 rpds-py<0.20.0