launchdarkly-openfeature-server 0.8.0__tar.gz → 0.8.2__tar.gz

{launchdarkly_openfeature_server-0.8.0 → launchdarkly_openfeature_server-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: launchdarkly-openfeature-server
-Version: 0.8.0
+Version: 0.8.2
 Summary: An OpenFeature provider for the LaunchDarkly Python server SDK
 License: Apache-2.0
 License-File: LICENSE
@@ -16,6 +16,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
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
 Requires-Dist: launchdarkly-server-sdk (>=9.17.0,<10)
@@ -63,7 +64,7 @@ This matrix mirrors the [feature matrix of the OpenFeature SDK for Python](https
 | ✅      | Hooks                           | Hooks are registered on the OpenFeature API and client; the provider requires no additional support and its results are visible to hooks, including [flag metadata](#flag-metadata).                                       |
 | ✅      | Logging                         | The provider logs through the logging configuration of the `Config` it is given.                                                                                                                                           |
 | ✅      | Domains                         | Domains bind clients to providers in the OpenFeature SDK; a separate provider instance may be registered per domain.                                                                                                       |
-| ✅      | Eventing                        | LaunchDarkly data source status changes are emitted as `PROVIDER_READY`, `PROVIDER_STALE` and `PROVIDER_ERROR`; flag changes as `PROVIDER_CONFIGURATION_CHANGED` with the changed flag key.                              |
+| ✅      | Eventing                        | LaunchDarkly data source status changes are emitted as `PROVIDER_READY`, `PROVIDER_STALE` and `PROVIDER_ERROR`, and only when the status changes; flag changes as `PROVIDER_CONFIGURATION_CHANGED` with the changed flag key.                              |
 | ✅      | Tracking                        | `track` sends a LaunchDarkly custom event for the evaluation context, with the tracking event value and remaining details attached.                                                                                        |
 | ✅      | Initialization                  | `initialize` reports whether the LaunchDarkly client became ready. The optional `start_wait` parameter bounds initialization; zero applies no timeout and waits until the data source becomes valid or permanently fails. |
 | ✅      | Shutdown                        | `shutdown` closes the LaunchDarkly client; a closed client cannot be restarted, so a new provider instance is required afterward.                                                                                          |
@@ -121,6 +122,8 @@ There are several other attributes which have special functionality within a sin
 - A key of `anonymous`. Must be a boolean value.  [Equivalent to the 'anonymous' builder method in the SDK.](https://launchdarkly-python-sdk.readthedocs.io/en/latest/api-main.html#ldclient.ContextBuilder.anonymous)
 - A key of `name`. Must be a string. [Equivalent to the 'name' builder method in the SDK.](https://launchdarkly-python-sdk.readthedocs.io/en/latest/api-main.html#ldclient.ContextBuilder.name)
 
+The LaunchDarkly context model has no date type, so a `datetime` attribute is converted to a string containing its ISO-8601 representation in UTC, which is the format the LaunchDarkly date targeting operators accept. A `datetime` without a timezone is treated as UTC. This conversion is applied to `datetime` values nested in lists and dictionaries as well.
+
 ### Examples
 
 #### A single user context

{launchdarkly_openfeature_server-0.8.0 → launchdarkly_openfeature_server-0.8.2}/README.md

@@ -37,7 +37,7 @@ This matrix mirrors the [feature matrix of the OpenFeature SDK for Python](https
 | ✅      | Hooks                           | Hooks are registered on the OpenFeature API and client; the provider requires no additional support and its results are visible to hooks, including [flag metadata](#flag-metadata).                                       |
 | ✅      | Logging                         | The provider logs through the logging configuration of the `Config` it is given.                                                                                                                                           |
 | ✅      | Domains                         | Domains bind clients to providers in the OpenFeature SDK; a separate provider instance may be registered per domain.                                                                                                       |
-| ✅      | Eventing                        | LaunchDarkly data source status changes are emitted as `PROVIDER_READY`, `PROVIDER_STALE` and `PROVIDER_ERROR`; flag changes as `PROVIDER_CONFIGURATION_CHANGED` with the changed flag key.                              |
+| ✅      | Eventing                        | LaunchDarkly data source status changes are emitted as `PROVIDER_READY`, `PROVIDER_STALE` and `PROVIDER_ERROR`, and only when the status changes; flag changes as `PROVIDER_CONFIGURATION_CHANGED` with the changed flag key.                              |
 | ✅      | Tracking                        | `track` sends a LaunchDarkly custom event for the evaluation context, with the tracking event value and remaining details attached.                                                                                        |
 | ✅      | Initialization                  | `initialize` reports whether the LaunchDarkly client became ready. The optional `start_wait` parameter bounds initialization; zero applies no timeout and waits until the data source becomes valid or permanently fails. |
 | ✅      | Shutdown                        | `shutdown` closes the LaunchDarkly client; a closed client cannot be restarted, so a new provider instance is required afterward.                                                                                          |
@@ -95,6 +95,8 @@ There are several other attributes which have special functionality within a sin
 - A key of `anonymous`. Must be a boolean value.  [Equivalent to the 'anonymous' builder method in the SDK.](https://launchdarkly-python-sdk.readthedocs.io/en/latest/api-main.html#ldclient.ContextBuilder.anonymous)
 - A key of `name`. Must be a string. [Equivalent to the 'name' builder method in the SDK.](https://launchdarkly-python-sdk.readthedocs.io/en/latest/api-main.html#ldclient.ContextBuilder.name)
 
+The LaunchDarkly context model has no date type, so a `datetime` attribute is converted to a string containing its ISO-8601 representation in UTC, which is the format the LaunchDarkly date targeting operators accept. A `datetime` without a timezone is treated as UTC. This conversion is applied to `datetime` values nested in lists and dictionaries as well.
+
 ### Examples
 
 #### A single user context

{launchdarkly_openfeature_server-0.8.0 → launchdarkly_openfeature_server-0.8.2}/ld_openfeature/impl/context_converter.py

@@ -1,5 +1,6 @@
+from datetime import datetime, timezone
 from logging import getLogger
-from typing import Any, Dict, List, Mapping, Optional
+from typing import Any, Dict, List, Mapping, Optional, Sequence
 
 from ldclient.context import Context, ContextBuilder, ContextMultiBuilder
 from openfeature.evaluation_context import EvaluationContext, EvaluationContextAttribute
@@ -8,6 +9,33 @@ from openfeature.evaluation_context import EvaluationContext, EvaluationContextA
 logger = getLogger("launchdarkly-openfeature-server")
 
 
+def _to_ld_value(value: Any) -> Any:
+    """
+    Convert an OpenFeature attribute value into a value the LaunchDarkly SDK can represent.
+
+    A datetime becomes its ISO-8601 representation in UTC, because the LaunchDarkly value model has
+    no date type. A datetime without a timezone is treated as UTC. A value which cannot be
+    converted becomes None.
+    """
+    if value is None or isinstance(value, (bool, int, float, str)):
+        return value
+
+    if isinstance(value, datetime):
+        if value.tzinfo is None:
+            value = value.replace(tzinfo=timezone.utc)
+
+        return value.astimezone(timezone.utc).isoformat().replace('+00:00', 'Z')
+
+    if isinstance(value, Mapping):
+        return {str(k): _to_ld_value(v) for k, v in value.items()}
+
+    if isinstance(value, Sequence):
+        return [_to_ld_value(item) for item in value]
+
+    logger.error("The attribute value of type %s could not be converted; using None instead", type(value).__name__)
+    return None
+
+
 class EvaluationContextConverter:
     def to_ld_context(self, context: EvaluationContext) -> Context:
         """
@@ -108,6 +136,6 @@ class EvaluationContextConverter:
             elif k == 'privateAttributes':
                 logger.error("The attribute 'privateAttributes' must be an array")
             else:
-                builder.set(k, v)
+                builder.set(k, _to_ld_value(v))
 
         return builder.build()

{launchdarkly_openfeature_server-0.8.0 → launchdarkly_openfeature_server-0.8.2}/ld_openfeature/provider.py

@@ -44,6 +44,9 @@ class LaunchDarklyProvider(AbstractProvider):
         self.__context_converter = EvaluationContextConverter()
         self.__details_converter = ResolutionDetailsConverter()
 
+        self.__status_lock = threading.Lock()
+        self.__last_emitted_state: Optional[DataSourceState] = None
+
     @property
     def client(self) -> LDClient:
         """
@@ -53,11 +56,27 @@ class LaunchDarklyProvider(AbstractProvider):
         """
         return self.__client
 
+    def __is_new_status(self, state: DataSourceState) -> bool:
+        """
+        Report whether a state changes the provider status. Several data source states can map to the same provider
+        status, and a repeated status is not a change an application can act on.
+        """
+        with self.__status_lock:
+            if state == self.__last_emitted_state:
+                return False
+
+            self.__last_emitted_state = state
+            return True
+
     def __handle_data_source_status(self, status: DataSourceStatus):
         state = status.state
         if state == DataSourceState.INITIALIZING:
             return
-        elif state == DataSourceState.VALID:
+
+        if not self.__is_new_status(state):
+            return
+
+        if state == DataSourceState.VALID:
             self.emit_provider_ready(ProviderEventDetails())
         elif state == DataSourceState.OFF:
             error_message = self.__get_message(status,

launchdarkly_openfeature_server-0.8.2/ld_openfeature/version.py

@@ -0,0 +1 @@
+VERSION = "0.8.2"  # x-release-please-version

{launchdarkly_openfeature_server-0.8.0 → launchdarkly_openfeature_server-0.8.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "launchdarkly-openfeature-server"
-version = "0.8.0"
+version = "0.8.2"
 description = "An OpenFeature provider for the LaunchDarkly Python server SDK"
 authors = ["LaunchDarkly <dev@launchdarkly.com>"]
 license = "Apache-2.0"

launchdarkly_openfeature_server-0.8.0/ld_openfeature/version.py

@@ -1 +0,0 @@
-VERSION = "0.8.0"  # x-release-please-version