refactor: move InternalHookProvider to provider/_protocols.py

Signed-off-by: Jonathan Norris <jonathan.norris@dynatrace.com>

Author: jonathannorris

openfeature/provider/__init__.py

@@ -11,6 +11,7 @@
 from openfeature.hook import Hook
 from openfeature.track import TrackingEventDetails
 
+from ._protocols import InternalHookProvider
 from .metadata import Metadata
 
 if typing.TYPE_CHECKING:
@@ -137,38 +138,6 @@ def track(
     ) -> None: ...
 
 
-@typing.runtime_checkable
-class InternalHookProvider(typing.Protocol):
-    """Protocol for providers that manage their own provider hook execution.
-
-    Providers implementing this protocol (e.g. MultiProvider) handle provider
-    hook lifecycle internally. The client will skip its own provider hook
-    invocations and instead delegate to the provider via the set/reset methods.
-
-    The registry will also use get_status() from this protocol instead of its
-    own internal status tracking for providers that implement it.
-
-    Implementations must set ``_is_internal_hook_provider = True`` as a class
-    attribute. This marker is checked alongside ``isinstance`` to avoid false
-    positives from duck-typed objects (e.g. ``Mock``).
-    """
-
-    _is_internal_hook_provider: typing.ClassVar[bool]
-
-    def uses_internal_provider_hooks(self) -> bool: ...
-
-    def set_internal_provider_hook_runtime(
-        self,
-        flag_type: typing.Any,
-        client_metadata: typing.Any,
-        hook_hints: typing.Any,
-    ) -> typing.Any: ...
-
-    def reset_internal_provider_hook_runtime(self, token: typing.Any) -> None: ...
-
-    def get_status(self) -> ProviderStatus: ...
-
-
 class AbstractProvider(FeatureProvider):
     def __init__(self, *args: typing.Any, **kwargs: typing.Any) -> None:
         # this makes sure to invoke the parent of `FeatureProvider` -> `object`

openfeature/provider/_protocols.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import typing
+
+if typing.TYPE_CHECKING:
+    from openfeature.provider import ProviderStatus
+
+
+@typing.runtime_checkable
+class InternalHookProvider(typing.Protocol):
+    """Protocol for providers that manage their own provider hook execution.
+
+    Providers implementing this protocol (e.g. MultiProvider) handle provider
+    hook lifecycle internally. The client will skip its own provider hook
+    invocations and instead delegate to the provider via the set/reset methods.
+
+    The registry will also use get_status() from this protocol instead of its
+    own internal status tracking for providers that implement it.
+
+    Implementations must set ``_is_internal_hook_provider = True`` as a class
+    attribute. This marker is checked alongside ``isinstance`` to avoid false
+    positives from duck-typed objects (e.g. ``Mock``).
+    """
+
+    _is_internal_hook_provider: typing.ClassVar[bool]
+
+    def uses_internal_provider_hooks(self) -> bool: ...
+
+    def set_internal_provider_hook_runtime(
+        self,
+        flag_type: typing.Any,
+        client_metadata: typing.Any,
+        hook_hints: typing.Any,
+    ) -> typing.Any: ...
+
+    def reset_internal_provider_hook_runtime(self, token: typing.Any) -> None: ...
+
+    def get_status(self) -> ProviderStatus: ...