|
| 1 | +from __future__ import annotations |
| 2 | + |
1 | 3 | import typing
|
| 4 | +from abc import abstractmethod |
2 | 5 | from enum import Enum
|
3 | 6 |
|
4 | 7 | from openfeature.evaluation_context import EvaluationContext
|
| 8 | +from openfeature.event import ProviderEvent, ProviderEventDetails |
5 | 9 | from openfeature.flag_evaluation import FlagResolutionDetails
|
6 | 10 | from openfeature.hook import Hook
|
7 | 11 |
|
8 | 12 | from .metadata import Metadata
|
9 | 13 |
|
10 |
| -__all__ = ["ProviderStatus", "FeatureProvider", "Metadata"] |
| 14 | +__all__ = ["AbstractProvider", "ProviderStatus", "FeatureProvider", "Metadata"] |
11 | 15 |
|
12 | 16 |
|
13 | 17 | class ProviderStatus(Enum):
|
@@ -61,3 +65,82 @@ def resolve_object_details(
|
61 | 65 | default_value: typing.Union[dict, list],
|
62 | 66 | evaluation_context: typing.Optional[EvaluationContext] = None,
|
63 | 67 | ) -> FlagResolutionDetails[typing.Union[dict, list]]: ...
|
| 68 | + |
| 69 | + |
| 70 | +class AbstractProvider(FeatureProvider): |
| 71 | + def initialize(self, evaluation_context: EvaluationContext) -> None: |
| 72 | + pass |
| 73 | + |
| 74 | + def shutdown(self) -> None: |
| 75 | + pass |
| 76 | + |
| 77 | + @abstractmethod |
| 78 | + def get_metadata(self) -> Metadata: |
| 79 | + pass |
| 80 | + |
| 81 | + def get_provider_hooks(self) -> typing.List[Hook]: |
| 82 | + return [] |
| 83 | + |
| 84 | + @abstractmethod |
| 85 | + def resolve_boolean_details( |
| 86 | + self, |
| 87 | + flag_key: str, |
| 88 | + default_value: bool, |
| 89 | + evaluation_context: typing.Optional[EvaluationContext] = None, |
| 90 | + ) -> FlagResolutionDetails[bool]: |
| 91 | + pass |
| 92 | + |
| 93 | + @abstractmethod |
| 94 | + def resolve_string_details( |
| 95 | + self, |
| 96 | + flag_key: str, |
| 97 | + default_value: str, |
| 98 | + evaluation_context: typing.Optional[EvaluationContext] = None, |
| 99 | + ) -> FlagResolutionDetails[str]: |
| 100 | + pass |
| 101 | + |
| 102 | + @abstractmethod |
| 103 | + def resolve_integer_details( |
| 104 | + self, |
| 105 | + flag_key: str, |
| 106 | + default_value: int, |
| 107 | + evaluation_context: typing.Optional[EvaluationContext] = None, |
| 108 | + ) -> FlagResolutionDetails[int]: |
| 109 | + pass |
| 110 | + |
| 111 | + @abstractmethod |
| 112 | + def resolve_float_details( |
| 113 | + self, |
| 114 | + flag_key: str, |
| 115 | + default_value: float, |
| 116 | + evaluation_context: typing.Optional[EvaluationContext] = None, |
| 117 | + ) -> FlagResolutionDetails[float]: |
| 118 | + pass |
| 119 | + |
| 120 | + @abstractmethod |
| 121 | + def resolve_object_details( |
| 122 | + self, |
| 123 | + flag_key: str, |
| 124 | + default_value: typing.Union[dict, list], |
| 125 | + evaluation_context: typing.Optional[EvaluationContext] = None, |
| 126 | + ) -> FlagResolutionDetails[typing.Union[dict, list]]: |
| 127 | + pass |
| 128 | + |
| 129 | + def emit_provider_ready(self, details: ProviderEventDetails) -> None: |
| 130 | + self.emit(ProviderEvent.PROVIDER_READY, details) |
| 131 | + |
| 132 | + def emit_provider_configuration_changed( |
| 133 | + self, details: ProviderEventDetails |
| 134 | + ) -> None: |
| 135 | + self.emit(ProviderEvent.PROVIDER_CONFIGURATION_CHANGED, details) |
| 136 | + |
| 137 | + def emit_provider_error(self, details: ProviderEventDetails) -> None: |
| 138 | + self.emit(ProviderEvent.PROVIDER_ERROR, details) |
| 139 | + |
| 140 | + def emit_provider_stale(self, details: ProviderEventDetails) -> None: |
| 141 | + self.emit(ProviderEvent.PROVIDER_STALE, details) |
| 142 | + |
| 143 | + def emit(self, event: ProviderEvent, details: ProviderEventDetails) -> None: |
| 144 | + from openfeature.provider._registry import provider_registry |
| 145 | + |
| 146 | + provider_registry.dispatch_event(self, event, details) |
0 commit comments