openfeature-provider-flagd 0.2.0__tar.gz → 0.2.2__tar.gz

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.2.2](https://github.com/open-feature/python-sdk-contrib/compare/openfeature-provider-flagd/v0.2.1...openfeature-provider-flagd/v0.2.2) (2025-03-18)
+
+
+### 🐛 Bug Fixes
+
+* **flagd:** handle falsy target values correctly ([#214](https://github.com/open-feature/python-sdk-contrib/issues/214)) ([fafd099](https://github.com/open-feature/python-sdk-contrib/commit/fafd099f07365a7d0032e8215477b51bfe90c01a))
+
+
+### 🧹 Chore
+
+* **deps:** update dependency grpcio-health-checking to v1.71.0 ([#209](https://github.com/open-feature/python-sdk-contrib/issues/209)) ([345e793](https://github.com/open-feature/python-sdk-contrib/commit/345e7934b9de3879d3aff45c8213ece1a98e3711))
+* **deps:** update pre-commit hook astral-sh/ruff-pre-commit to v0.11.0 ([#212](https://github.com/open-feature/python-sdk-contrib/issues/212)) ([1b9b5f1](https://github.com/open-feature/python-sdk-contrib/commit/1b9b5f128a7fe08ffbf84cbc7de2986f95dc01f5))
+* **flagd:** Add sync metadata disabled ([#211](https://github.com/open-feature/python-sdk-contrib/issues/211)) ([2f85057](https://github.com/open-feature/python-sdk-contrib/commit/2f850574943cc92d55d198c8ccd91e80583a2ee6))
+
+## [0.2.1](https://github.com/open-feature/python-sdk-contrib/compare/openfeature-provider-flagd/v0.2.0...openfeature-provider-flagd/v0.2.1) (2025-03-10)
+
+
+### ✨ New Features
+
+* **flagd:** Add features to customize auth to Sync API servers ([#203](https://github.com/open-feature/python-sdk-contrib/issues/203)) ([5151e94](https://github.com/open-feature/python-sdk-contrib/commit/5151e941d229101bdbcc5b40f570f69d77ddda7b))
+* **flagd:** Context value hydration ([#195](https://github.com/open-feature/python-sdk-contrib/issues/195)) ([4fa619b](https://github.com/open-feature/python-sdk-contrib/commit/4fa619b93faf1d1f62a9ead99f33baa21c04e267))
+
 ## [0.2.0](https://github.com/open-feature/python-sdk-contrib/compare/openfeature-provider-flagd/v0.1.5...openfeature-provider-flagd/v0.2.0) (2025-02-18)
 
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openfeature-provider-flagd
-Version: 0.2.0
+Version: 0.2.2
 Summary: OpenFeature provider for the flagd flag evaluation engine
 Project-URL: Homepage, https://github.com/open-feature/python-sdk-contrib
 Author-email: OpenFeature <openfeature-core@groups.io>

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openfeature-provider-flagd"
-version = "0.2.0"
+version = "0.2.2"
 description = "OpenFeature provider for the flagd flag evaluation engine"
 readme = "README.md"
 authors = [{ name = "OpenFeature", email = "openfeature-core@groups.io" }]
@@ -40,7 +40,7 @@ dependencies = [
   "pytest-bdd",
   "testcontainers",
   "asserts",
-  "grpcio-health-checking==1.70.0",
+  "grpcio-health-checking==1.71.0",
 ]
 pre-install-commands = [
   "hatch build",

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/config.py

@@ -3,6 +3,8 @@ import os
 import typing
 from enum import Enum
 
+import grpc
+
 
 class ResolverType(Enum):
     RPC = "rpc"
@@ -45,9 +47,11 @@ ENV_VAR_RETRY_BACKOFF_MS = "FLAGD_RETRY_BACKOFF_MS"
 ENV_VAR_RETRY_BACKOFF_MAX_MS = "FLAGD_RETRY_BACKOFF_MAX_MS"
 ENV_VAR_RETRY_GRACE_PERIOD_SECONDS = "FLAGD_RETRY_GRACE_PERIOD"
 ENV_VAR_SELECTOR = "FLAGD_SOURCE_SELECTOR"
+ENV_VAR_PROVIDER_ID = "FLAGD_SOURCE_PROVIDER_ID"
 ENV_VAR_STREAM_DEADLINE_MS = "FLAGD_STREAM_DEADLINE_MS"
 ENV_VAR_TLS = "FLAGD_TLS"
 ENV_VAR_TLS_CERT = "FLAGD_SERVER_CERT_PATH"
+ENV_VAR_DEFAULT_AUTHORITY = "FLAGD_DEFAULT_AUTHORITY"
 
 T = typing.TypeVar("T")
 
@@ -81,6 +85,7 @@ class Config:
         port: typing.Optional[int] = None,
         tls: typing.Optional[bool] = None,
         selector: typing.Optional[str] = None,
+        provider_id: typing.Optional[str] = None,
         resolver: typing.Optional[ResolverType] = None,
         offline_flag_source_path: typing.Optional[str] = None,
         offline_poll_interval_ms: typing.Optional[int] = None,
@@ -93,6 +98,9 @@ class Config:
         cache: typing.Optional[CacheType] = None,
         max_cache_size: typing.Optional[int] = None,
         cert_path: typing.Optional[str] = None,
+        default_authority: typing.Optional[str] = None,
+        channel_credentials: typing.Optional[grpc.ChannelCredentials] = None,
+        sync_metadata_disabled: typing.Optional[bool] = None,
     ):
         self.host = env_or_default(ENV_VAR_HOST, DEFAULT_HOST) if host is None else host
 
@@ -227,3 +235,25 @@ class Config:
         self.selector = (
             env_or_default(ENV_VAR_SELECTOR, None) if selector is None else selector
         )
+
+        self.provider_id = (
+            env_or_default(ENV_VAR_PROVIDER_ID, None)
+            if provider_id is None
+            else provider_id
+        )
+
+        self.default_authority = (
+            env_or_default(ENV_VAR_DEFAULT_AUTHORITY, None)
+            if default_authority is None
+            else default_authority
+        )
+
+        self.channel_credentials = channel_credentials
+
+        # TODO: remove the metadata call entirely after https://github.com/open-feature/flagd/issues/1584
+        # This is a temporary stop-gap solutions to support servers that don't implement sync.GetMetadata
+        # (see: https://buf.build/open-feature/flagd/docs/main:flagd.sync.v1#flagd.sync.v1.FlagSyncService.GetMetadata).
+        # Using this option disables call to sync.GetMetadata
+        # Disabling will prevent static context from flagd being used in evaluations.
+        # GetMetadata and this option will be removed.
+        self.sync_metadata_disabled = sync_metadata_disabled

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/provider.py

@@ -24,13 +24,18 @@
 import typing
 import warnings
 
+import grpc
+
 from openfeature.evaluation_context import EvaluationContext
+from openfeature.event import ProviderEventDetails
 from openfeature.flag_evaluation import FlagResolutionDetails
+from openfeature.hook import Hook
 from openfeature.provider import AbstractProvider
 from openfeature.provider.metadata import Metadata
 
 from .config import CacheType, Config, ResolverType
 from .resolvers import AbstractResolver, GrpcResolver, InProcessResolver
+from .sync_metadata_hook import SyncMetadataHook
 
 T = typing.TypeVar("T")
 
@@ -47,6 +52,7 @@ class FlagdProvider(AbstractProvider):
         timeout: typing.Optional[int] = None,
         retry_backoff_ms: typing.Optional[int] = None,
         selector: typing.Optional[str] = None,
+        provider_id: typing.Optional[str] = None,
         resolver_type: typing.Optional[ResolverType] = None,
         offline_flag_source_path: typing.Optional[str] = None,
         stream_deadline_ms: typing.Optional[int] = None,
@@ -56,6 +62,9 @@ class FlagdProvider(AbstractProvider):
         retry_backoff_max_ms: typing.Optional[int] = None,
         retry_grace_period: typing.Optional[int] = None,
         cert_path: typing.Optional[str] = None,
+        default_authority: typing.Optional[str] = None,
+        channel_credentials: typing.Optional[grpc.ChannelCredentials] = None,
+        sync_metadata_disabled: typing.Optional[bool] = None,
     ):
         """
         Create an instance of the FlagdProvider
@@ -88,6 +97,7 @@ class FlagdProvider(AbstractProvider):
             retry_backoff_max_ms=retry_backoff_max_ms,
             retry_grace_period=retry_grace_period,
             selector=selector,
+            provider_id=provider_id,
             resolver=resolver_type,
             offline_flag_source_path=offline_flag_source_path,
             stream_deadline_ms=stream_deadline_ms,
@@ -95,9 +105,20 @@ class FlagdProvider(AbstractProvider):
             cache=cache,
             max_cache_size=max_cache_size,
             cert_path=cert_path,
+            default_authority=default_authority,
+            channel_credentials=channel_credentials,
+            sync_metadata_disabled=sync_metadata_disabled,
         )
+        self.enriched_context: dict = {}
 
         self.resolver = self.setup_resolver()
+        self.hooks: list[Hook] = [SyncMetadataHook(self.get_enriched_context)]
+
+    def get_enriched_context(self) -> EvaluationContext:
+        return EvaluationContext(attributes=self.enriched_context)
+
+    def get_provider_hooks(self) -> list[Hook]:
+        return self.hooks
 
     def setup_resolver(self) -> AbstractResolver:
         if self.config.resolver == ResolverType.RPC:
@@ -114,7 +135,7 @@ class FlagdProvider(AbstractProvider):
         ):
             return InProcessResolver(
                 self.config,
-                self.emit_provider_ready,
+                self.emit_provider_ready_with_context,
                 self.emit_provider_error,
                 self.emit_provider_stale,
                 self.emit_provider_configuration_changed,
@@ -184,3 +205,10 @@ class FlagdProvider(AbstractProvider):
         return self.resolver.resolve_object_details(
             key, default_value, evaluation_context
         )
+
+    def emit_provider_ready_with_context(
+        self, details: ProviderEventDetails, context: dict
+    ) -> None:
+        self.enriched_context = context
+        self.emit_provider_ready(details)
+        pass

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/resolvers/grpc.py

@@ -137,7 +137,10 @@ class GrpcResolver:
 
     def _state_change_callback(self, new_state: ChannelConnectivity) -> None:
         logger.debug(f"gRPC state change: {new_state}")
-        if new_state == ChannelConnectivity.READY:
+        if (
+            new_state == grpc.ChannelConnectivity.READY
+            or new_state == grpc.ChannelConnectivity.IDLE
+        ):
             if not self.thread or not self.thread.is_alive():
                 self.thread = threading.Thread(
                     target=self.listen,
@@ -276,7 +279,7 @@ class GrpcResolver:
             return cached_flag
 
         context = self._convert_context(evaluation_context)
-        call_args = {"timeout": self.deadline}
+        call_args = {"timeout": self.deadline, "wait_for_ready": True}
         try:
             request: Message
             if flag_type == FlagType.BOOLEAN:

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/resolvers/in_process.py

@@ -21,7 +21,7 @@ class InProcessResolver:
     def __init__(
         self,
         config: Config,
-        emit_provider_ready: typing.Callable[[ProviderEventDetails], None],
+        emit_provider_ready: typing.Callable[[ProviderEventDetails, dict], None],
         emit_provider_error: typing.Callable[[ProviderEventDetails], None],
         emit_provider_stale: typing.Callable[[ProviderEventDetails], None],
         emit_provider_configuration_changed: typing.Callable[
@@ -121,7 +121,7 @@ class InProcessResolver:
             )
 
         variant, value = flag.get_variant(variant)
-        if not value:
+        if value is None:
             raise ParseError(f"Resolved variant {variant} not in variants config.")
 
         return FlagResolutionDetails(

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/resolvers/process/connector/file_watcher.py

@@ -24,7 +24,7 @@ class FileWatcher(FlagStateConnector):
         self,
         config: Config,
         flag_store: FlagStore,
-        emit_provider_ready: typing.Callable[[ProviderEventDetails], None],
+        emit_provider_ready: typing.Callable[[ProviderEventDetails, dict], None],
         emit_provider_error: typing.Callable[[ProviderEventDetails], None],
     ):
         if config.offline_flag_source_path is None:
@@ -94,7 +94,8 @@ class FileWatcher(FlagStateConnector):
                 self.emit_provider_ready(
                     ProviderEventDetails(
                         message="Reloading file contents recovered from error state"
-                    )
+                    ),
+                    {},
                 )
                 self.should_emit_ready_on_success = False
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/resolvers/process/connector/grpc_watcher.py

@@ -5,6 +5,8 @@ import time
 import typing
 
 import grpc
+from google.protobuf.json_format import MessageToDict
+from google.protobuf.struct_pb2 import Struct
 
 from openfeature.evaluation_context import EvaluationContext
 from openfeature.event import ProviderEventDetails
@@ -26,7 +28,7 @@ class GrpcWatcher(FlagStateConnector):
         self,
         config: Config,
         flag_store: FlagStore,
-        emit_provider_ready: typing.Callable[[ProviderEventDetails], None],
+        emit_provider_ready: typing.Callable[[ProviderEventDetails, dict], None],
         emit_provider_error: typing.Callable[[ProviderEventDetails], None],
         emit_provider_stale: typing.Callable[[ProviderEventDetails], None],
     ):
@@ -41,6 +43,7 @@ class GrpcWatcher(FlagStateConnector):
         self.streamline_deadline_seconds = config.stream_deadline_ms * 0.001
         self.deadline = config.deadline_ms * 0.001
         self.selector = config.selector
+        self.provider_id = config.provider_id
         self.emit_provider_ready = emit_provider_ready
         self.emit_provider_error = emit_provider_error
         self.emit_provider_stale = emit_provider_stale
@@ -54,13 +57,23 @@ class GrpcWatcher(FlagStateConnector):
     def _generate_channel(self, config: Config) -> grpc.Channel:
         target = f"{config.host}:{config.port}"
         # Create the channel with the service config
-        options = [
+        options: list[tuple[str, typing.Any]] = [
             ("grpc.keepalive_time_ms", config.keep_alive_time),
             ("grpc.initial_reconnect_backoff_ms", config.retry_backoff_ms),
             ("grpc.max_reconnect_backoff_ms", config.retry_backoff_max_ms),
             ("grpc.min_reconnect_backoff_ms", config.stream_deadline_ms),
         ]
-        if config.tls:
+        if config.default_authority is not None:
+            options.append(("grpc.default_authority", config.default_authority))
+
+        if config.channel_credentials is not None:
+            channel_args = {
+                "options": options,
+                "credentials": config.channel_credentials,
+            }
+            channel = grpc.secure_channel(target, **channel_args)
+
+        elif config.tls:
             channel_args = {
                 "options": options,
                 "credentials": grpc.ssl_channel_credentials(),
@@ -106,7 +119,10 @@ class GrpcWatcher(FlagStateConnector):
 
     def _state_change_callback(self, new_state: grpc.ChannelConnectivity) -> None:
         logger.debug(f"gRPC state change: {new_state}")
-        if new_state == grpc.ChannelConnectivity.READY:
+        if (
+            new_state == grpc.ChannelConnectivity.READY
+            or new_state == grpc.ChannelConnectivity.IDLE
+        ):
             if not self.thread or not self.thread.is_alive():
                 self.thread = threading.Thread(
                     target=self.listen,
@@ -147,16 +163,38 @@ class GrpcWatcher(FlagStateConnector):
         self.active = False
         self.channel.close()
 
+    def _create_request_args(self) -> dict:
+        request_args = {}
+        if self.selector is not None:
+            request_args["selector"] = self.selector
+        if self.provider_id is not None:
+            request_args["provider_id"] = self.provider_id
+
+        return request_args
+
     def listen(self) -> None:
         call_args = (
             {"timeout": self.streamline_deadline_seconds}
             if self.streamline_deadline_seconds > 0
             else {}
         )
-        request_args = {"selector": self.selector} if self.selector is not None else {}
+        request_args = self._create_request_args()
 
         while self.active:
             try:
+                context_values_response: sync_pb2.GetMetadataResponse
+                if self.config.sync_metadata_disabled:
+                    context_values_response = sync_pb2.GetMetadataResponse(
+                        metadata=Struct()
+                    )
+                else:
+                    context_values_request = sync_pb2.GetMetadataRequest()
+                    context_values_response = self.stub.GetMetadata(
+                        context_values_request, wait_for_ready=True
+                    )
+
+                context_values = MessageToDict(context_values_response)
+
                 request = sync_pb2.SyncFlagsRequest(**request_args)
 
                 logger.debug("Setting up gRPC sync flags connection")
@@ -173,7 +211,8 @@ class GrpcWatcher(FlagStateConnector):
                         self.emit_provider_ready(
                             ProviderEventDetails(
                                 message="gRPC sync connection established"
-                            )
+                            ),
+                            context_values["metadata"],
                         )
                         self.connected = True
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/contrib/provider/flagd/resolvers/process/flags.py

@@ -72,10 +72,8 @@ class Flag:
             data["default_variant"] = data["defaultVariant"]
             del data["defaultVariant"]
 
-        if "source" in data:
-            del data["source"]
-        if "selector" in data:
-            del data["selector"]
+        data.pop("source", None)
+        data.pop("selector", None)
         try:
             flag = cls(key=key, **data)
             return flag

openfeature_provider_flagd-0.2.2/src/openfeature/contrib/provider/flagd/sync_metadata_hook.py

@@ -0,0 +1,14 @@
+import typing
+
+from openfeature.evaluation_context import EvaluationContext
+from openfeature.hook import Hook, HookContext, HookHints
+
+
+class SyncMetadataHook(Hook):
+    def __init__(self, context_supplier: typing.Callable[[], EvaluationContext]):
+        self.context_supplier = context_supplier
+
+    def before(
+        self, hook_context: HookContext, hints: HookHints
+    ) -> typing.Optional[EvaluationContext]:
+        return self.context_supplier()

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/schemas/protobuf/flagd/evaluation/v1/evaluation_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from openfeature.schemas.protobuf.flagd.evaluation.v1 import evaluation_pb2 as openfeature_dot_schemas_dot_protobuf_dot_flagd_dot_evaluation_dot_v1_dot_evaluation__pb2
 
-GRPC_GENERATED_VERSION = '1.70.0'
+GRPC_GENERATED_VERSION = '1.71.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/schemas/protobuf/flagd/sync/v1/sync_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from openfeature.schemas.protobuf.flagd.sync.v1 import sync_pb2 as openfeature_dot_schemas_dot_protobuf_dot_flagd_dot_sync_dot_v1_dot_sync__pb2
 
-GRPC_GENERATED_VERSION = '1.70.0'
+GRPC_GENERATED_VERSION = '1.71.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/schemas/protobuf/schema/v1/schema_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from openfeature.schemas.protobuf.schema.v1 import schema_pb2 as openfeature_dot_schemas_dot_protobuf_dot_schema_dot_v1_dot_schema__pb2
 
-GRPC_GENERATED_VERSION = '1.70.0'
+GRPC_GENERATED_VERSION = '1.71.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/src/openfeature/schemas/protobuf/sync/v1/sync_service_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from openfeature.schemas.protobuf.sync.v1 import sync_service_pb2 as openfeature_dot_schemas_dot_protobuf_dot_sync_dot_v1_dot_sync__service__pb2
 
-GRPC_GENERATED_VERSION = '1.70.0'
+GRPC_GENERATED_VERSION = '1.71.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/tests/e2e/file/conftest.py

@@ -12,6 +12,7 @@ feature_list = {
     "~sync",
     "~caching",
     "~grace",
+    "~contextEnrichment",
 }
 
 

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/tests/e2e/step/event_steps.py

@@ -8,6 +8,8 @@ from pytest_bdd import given, parsers, then, when
 from openfeature.client import OpenFeatureClient
 from openfeature.event import ProviderEvent
 
+logger = logging.getLogger("openfeature.contrib.tests")
+
 events = {
     "ready": ProviderEvent.PROVIDER_READY,
     "error": ProviderEvent.PROVIDER_ERROR,
@@ -28,7 +30,7 @@ def event_handles() -> list:
 )
 def add_event_handler(client: OpenFeatureClient, event_type: str, event_handles: list):
     def handler(event):
-        logging.warning((event_type, event))
+        logger.warning((event_type, event))
         event_handles.append(
             {
                 "type": event_type,
@@ -38,7 +40,7 @@ def add_event_handler(client: OpenFeatureClient, event_type: str, event_handles:
 
     client.add_handler(events[event_type], handler)
 
-    logging.warning(("handler added", event_type))
+    logger.warning(("handler added", event_type))
 
 
 def assert_handlers(handles, event_type: str, max_wait: int = 2):

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/tests/e2e/step/provider_steps.py

@@ -22,6 +22,8 @@ KEY_FLAGS = "flags"
 
 MERGED_FILE = "merged_file"
 
+logger = logging.getLogger("openfeature.contrib.tests")
+
 
 class TestProviderType(Enum):
     UNAVAILABLE = "unavailable"
@@ -133,7 +135,7 @@ def container(request):
         try:
             container.stop()
         except:  # noqa: E722 - we want to ensure all containers are stopped, even if we do have an exception here
-            logging.debug("container was not running anymore")
+            logger.debug("container was not running anymore")
 
     # Teardown code
     request.addfinalizer(fin)

{openfeature_provider_flagd-0.2.0 → openfeature_provider_flagd-0.2.2}/tests/e2e/testfilter.py

@@ -1,6 +1,8 @@
 import logging
 import os
 
+logger = logging.getLogger("openfeature.contrib.tests")
+
 
 class TestFilter:
     def __init__(self, config, feature_list=None, resolver=None, base_path=None):
@@ -40,7 +42,7 @@ class TestFilter:
             all_tags = self._get_item_tags(item)
 
             # Debug: Print collected tags for each item
-            logging.debug(f"Item: {item.nodeid}, Tags: {all_tags}")
+            logger.debug(f"Item: {item.nodeid}, Tags: {all_tags}")
 
             # Include-only logic: Skip items that do not match include_tags
             if (

openfeature_provider_flagd-0.2.2/tests/test_in_process.py

@@ -0,0 +1,218 @@
+from unittest.mock import Mock, create_autospec
+
+import pytest
+
+from openfeature.contrib.provider.flagd.config import Config
+from openfeature.contrib.provider.flagd.resolvers.in_process import InProcessResolver
+from openfeature.contrib.provider.flagd.resolvers.process.flags import Flag, FlagStore
+from openfeature.evaluation_context import EvaluationContext
+from openfeature.exception import FlagNotFoundError, ParseError
+
+
+def targeting():
+    return {
+        "if": [
+            {"==": [{"var": "targetingKey"}, "target_variant"]},
+            "target_variant",
+            None,
+        ]
+    }
+
+
+def context(targeting_key):
+    return EvaluationContext(targeting_key=targeting_key)
+
+
+@pytest.fixture
+def config():
+    return create_autospec(Config)
+
+
+@pytest.fixture
+def flag_store():
+    return create_autospec(FlagStore)
+
+
+@pytest.fixture
+def flag():
+    return Flag(
+        key="flag",
+        state="ENABLED",
+        variants={"default_variant": False, "target_variant": True},
+        default_variant="default_variant",
+        targeting=targeting(),
+    )
+
+
+@pytest.fixture
+def resolver(config):
+    config.offline_flag_source_path = "flag.json"
+    config.deadline_ms = 100
+    return InProcessResolver(
+        config=config,
+        emit_provider_ready=Mock(),
+        emit_provider_error=Mock(),
+        emit_provider_stale=Mock(),
+        emit_provider_configuration_changed=Mock(),
+    )
+
+
+def test_resolve_boolean_details_flag_not_found(resolver):
+    resolver.flag_store.get_flag = Mock(return_value=None)
+    with pytest.raises(FlagNotFoundError):
+        resolver.resolve_boolean_details("nonexistent_flag", False)
+
+
+def test_resolve_boolean_details_disabled_flag(flag, resolver):
+    flag.state = "DISABLED"
+    resolver.flag_store.get_flag = Mock(return_value=flag)
+
+    result = resolver.resolve_boolean_details("disabled_flag", False)
+
+    assert result.reason == "DISABLED"
+    assert result.variant is None
+    assert not result.value
+
+
+def test_resolve_boolean_details_invalid_variant(resolver, flag):
+    flag.targeting = {"var": ["targetingKey", "invalid_variant"]}
+
+    resolver.flag_store.get_flag = Mock(return_value=flag)
+
+    with pytest.raises(ParseError):
+        resolver.resolve_boolean_details("flag", False)
+
+
+@pytest.mark.parametrize(
+    "input_config, resolve_config, expected",
+    [
+        (
+            {
+                "variants": {"default_variant": False, "target_variant": True},
+                "targeting": None,
+            },
+            {
+                "context": None,
+                "method": "resolve_boolean_details",
+                "default_value": False,
+            },
+            {"reason": "STATIC", "variant": "default_variant", "value": False},
+        ),
+        (
+            {
+                "variants": {"default_variant": False, "target_variant": True},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("no_target_variant"),
+                "method": "resolve_boolean_details",
+                "default_value": False,
+            },
+            {"reason": "DEFAULT", "variant": "default_variant", "value": False},
+        ),
+        (
+            {
+                "variants": {"default_variant": False, "target_variant": True},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("target_variant"),
+                "method": "resolve_boolean_details",
+                "default_value": False,
+            },
+            {"reason": "TARGETING_MATCH", "variant": "target_variant", "value": True},
+        ),
+        (
+            {
+                "variants": {"default_variant": "default", "target_variant": "target"},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("target_variant"),
+                "method": "resolve_string_details",
+                "default_value": "placeholder",
+            },
+            {
+                "reason": "TARGETING_MATCH",
+                "variant": "target_variant",
+                "value": "target",
+            },
+        ),
+        (
+            {
+                "variants": {"default_variant": 1.0, "target_variant": 2.0},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("target_variant"),
+                "method": "resolve_float_details",
+                "default_value": 0.0,
+            },
+            {"reason": "TARGETING_MATCH", "variant": "target_variant", "value": 2.0},
+        ),
+        (
+            {
+                "variants": {"default_variant": True, "target_variant": False},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("target_variant"),
+                "method": "resolve_boolean_details",
+                "default_value": True,
+            },
+            {"reason": "TARGETING_MATCH", "variant": "target_variant", "value": False},
+        ),
+        (
+            {
+                "variants": {"default_variant": 10, "target_variant": 0},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("target_variant"),
+                "method": "resolve_integer_details",
+                "default_value": 1,
+            },
+            {"reason": "TARGETING_MATCH", "variant": "target_variant", "value": 0},
+        ),
+        (
+            {
+                "variants": {"default_variant": {}, "target_variant": {}},
+                "targeting": targeting(),
+            },
+            {
+                "context": context("target_variant"),
+                "method": "resolve_object_details",
+                "default_value": {},
+            },
+            {"reason": "TARGETING_MATCH", "variant": "target_variant", "value": {}},
+        ),
+    ],
+    ids=[
+        "static_flag",
+        "boolean_default_fallback",
+        "boolean_targeting_match",
+        "string_targeting_match",
+        "float_targeting_match",
+        "boolean_falsy_target",
+        "integer_falsy_target",
+        "object_falsy_target",
+    ],
+)
+def test_resolver_details(
+    resolver,
+    flag,
+    input_config,
+    resolve_config,
+    expected,
+):
+    flag.variants = input_config["variants"]
+    flag.targeting = input_config["targeting"]
+    resolver.flag_store.get_flag = Mock(return_value=flag)
+
+    result = getattr(resolver, resolve_config["method"])(
+        "flag", resolve_config["default_value"], resolve_config["context"]
+    )
+
+    assert result.reason == expected["reason"]
+    assert result.variant == expected["variant"]
+    assert result.value == expected["value"]