flagsmith 6.2.2__tar.gz → 6.3.0__tar.gz

{flagsmith-6.2.2 → flagsmith-6.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flagsmith
-Version: 6.2.2
+Version: 6.3.0
 Summary: Flagsmith Python SDK
 License: BSD3
 License-File: LICENSE
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Requires-Dist: flagsmith-flag-engine (>=11.0.0,<12.0.0)
 Requires-Dist: iso8601 (>=2.1.0,<3.0.0) ; python_version < "3.11"
 Requires-Dist: requests (>=2.32.3,<3.0.0)

{flagsmith-6.2.2 → flagsmith-6.3.0}/flagsmith/analytics.py

@@ -8,7 +8,7 @@ from datetime import datetime
 
 from requests_futures.sessions import FuturesSession  # type: ignore
 
-from flagsmith.version import __version__
+from flagsmith.version import DEFAULT_USER_AGENT, __version__
 
 logger = logging.getLogger(__name__)
 
@@ -218,7 +218,7 @@ class EventProcessor:
                 headers={
                     "Content-Type": "application/json; charset=utf-8",
                     "X-Environment-Key": self._environment_key,
-                    "Flagsmith-SDK-User-Agent": f"flagsmith-python-client/{__version__}",
+                    "Flagsmith-SDK-User-Agent": DEFAULT_USER_AGENT,
                 },
             )
         except RuntimeError:

{flagsmith-6.2.2 → flagsmith-6.3.0}/flagsmith/flagsmith.py

@@ -41,13 +41,12 @@ from flagsmith.types import (
     TraitMapping,
 )
 from flagsmith.utils.identities import generate_identity_data
-from flagsmith.version import __version__
+from flagsmith.version import DEFAULT_USER_AGENT
 
 logger = logging.getLogger(__name__)
 
 DEFAULT_API_URL = "https://edge.api.flagsmith.com/api/v1/"
 DEFAULT_REALTIME_API_URL = "https://realtime.flagsmith.com/"
-DEFAULT_USER_AGENT = f"flagsmith-python-sdk/{__version__}"
 
 
 class Flagsmith:
@@ -369,7 +368,9 @@ class Flagsmith:
         Resolve a flag for an identity and record an exposure event.
 
         The exposure event's ``value`` is the flag's variant key. It is only
-        sent when the flag exists, is enabled and carries a variant; any
+        sent when the flag exists, is enabled and the identity is enrolled in
+        the feature's experiment (``flag.experiment.in_experiment``) with a
+        variant; any
         other outcome is logged and skipped to keep experimentation data
         clean. A `DefaultFlag` served via the `default_flag_handler` counts
         as the feature not existing.
@@ -389,6 +390,12 @@ class Flagsmith:
                 FLAG_EXPOSURE_EVENT,
                 feature_name,
             )
+        elif not (flag.experiment and flag.experiment.in_experiment):
+            logger.debug(
+                "Not sending %s for feature %s: identity is not in a running experiment.",
+                FLAG_EXPOSURE_EVENT,
+                feature_name,
+            )
         elif flag.variant is None:
             logger.debug(
                 "Not sending %s for feature %s: flag has no variant.",
@@ -401,6 +408,7 @@ class Flagsmith:
                 identifier=identifier,
                 value=flag.variant,
                 traits=traits,
+                metadata={"experiment_id": flag.experiment.id},
             )
         return flag
 

{flagsmith-6.2.2 → flagsmith-6.3.0}/flagsmith/models.py

@@ -41,6 +41,28 @@ def build_segment_overrides_index(
     return index
 
 
+@dataclass(frozen=True)
+class ExperimentMetadata:
+    """The running experiment a flag was evaluated under; identity evaluations only."""
+
+    id: int
+    name: str
+    in_experiment: bool
+
+    @classmethod
+    def from_api_metadata(
+        cls,
+        metadata: typing.Optional[typing.Mapping[str, typing.Any]],
+    ) -> typing.Optional[ExperimentMetadata]:
+        if not metadata or not (experiment := metadata.get("experiment")):
+            return None
+        return cls(
+            id=experiment["id"],
+            name=experiment["name"],
+            in_experiment=experiment["in_experiment"],
+        )
+
+
 @dataclass
 class BaseFlag:
     enabled: bool
@@ -59,6 +81,7 @@ class Flag(BaseFlag):
     variant: typing.Optional[str] = None
     reason: typing.Optional[str] = None
     is_default: bool = field(default=False)
+    experiment: typing.Optional[ExperimentMetadata] = None
 
     @classmethod
     def from_evaluation_result(
@@ -88,6 +111,7 @@ class Flag(BaseFlag):
             feature_id=flag_data["feature"]["id"],
             variant=flag_data.get("variant"),
             reason=flag_data.get("reason"),
+            experiment=ExperimentMetadata.from_api_metadata(flag_data.get("metadata")),
         )
 
 

{flagsmith-6.2.2 → flagsmith-6.3.0}/flagsmith/version.py

@@ -1,3 +1,5 @@
 from importlib.metadata import version
 
 __version__ = version("flagsmith")
+
+DEFAULT_USER_AGENT = f"flagsmith-python-sdk/{__version__}"

{flagsmith-6.2.2 → flagsmith-6.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "flagsmith"
-version = "6.2.2"
+version = "6.3.0"
 description = "Flagsmith Python SDK"
 authors = ["Flagsmith <support@flagsmith.com>"]
 license = "BSD3"