add dummy clients

README.md

@@ -13,7 +13,7 @@ Installation
 
 To install package:
 
-- ``pdm add evo-featureflags-protobuf``
+- ``pdm add evo-featureflags-client``
 
 To release package:
 

examples/http/aiohttp_client.py

@@ -16,11 +16,13 @@ async def on_start(app):
         project=config.FF_PROJECT,
         variables=[flags.REQUEST_QUERY],
         defaults=flags.Defaults,
+        request_timeout=5,
+        refresh_interval=10,
     )
     app["ff_client"] = FeatureFlagsClient(app["ff_manager"])
 
     try:
-        await app["ff_client"].preload_async(timeout=5)
+        await app["ff_client"].preload_async()
     except Exception:
         log.exception(
             "Unable to preload feature flags, application will "

examples/http/httpx_client.py

@@ -16,11 +16,13 @@ async def on_start(app):
         project=config.FF_PROJECT,
         variables=[flags.REQUEST_QUERY],
         defaults=flags.Defaults,
+        request_timeout=5,
+        refresh_interval=10,
     )
     app["ff_client"] = FeatureFlagsClient(app["ff_manager"])
 
     try:
-        await app["ff_client"].preload_async(timeout=5)
+        await app["ff_client"].preload_async()
     except Exception:
         log.exception(
             "Unable to preload feature flags, application will "

examples/http/requests_client.py

@@ -19,6 +19,8 @@ def get_ff_client():
             project=config.FF_PROJECT,
             variables=[flags.REQUEST_QUERY],
             defaults=flags.Defaults,
+            request_timeout=5,
+            refresh_interval=10,
         )
         ff_client = g._ff_client = FeatureFlagsClient(manager)
     return ff_client

featureflags_client/http/managers/dummy.py

@@ -0,0 +1,73 @@
+import logging
+from typing import Any, Callable, Dict, Optional
+
+from featureflags_client.http.constants import Endpoints
+from featureflags_client.http.managers.base import (
+    AsyncBaseManager,
+    BaseManager,
+)
+
+log = logging.getLogger(__name__)
+
+
+class DummyManager(BaseManager):
+    """Dummy feature flags manager.
+
+    It can be helpful when you want to use flags with their default values.
+    """
+
+    def get(self, name: str) -> Optional[Callable[[Dict], bool]]:
+        """
+        So that `featureflags.http.flags.Flags` will use default values.
+        """
+        return None
+
+    def sync(self) -> None:
+        pass
+
+    def preload(self) -> None:
+        pass
+
+    def _post(
+        self,
+        url: Endpoints,
+        payload: Dict[str, Any],
+        timeout: int,
+    ) -> Dict[str, Any]:
+        pass
+
+
+class AsyncDummyManager(AsyncBaseManager):
+    """Dummy feature flags manager for asyncio apps.
+
+    It can be helpful when you want to use flags with their default values.
+    """
+
+    def get(self, name: str) -> Optional[Callable[[Dict], bool]]:
+        """
+        So that `featureflags.http.flags.Flags` will use default values.
+        """
+        return None
+
+    async def _post(  # type: ignore
+        self,
+        url: Endpoints,
+        payload: Dict[str, Any],
+        timeout: int,
+    ) -> Dict[str, Any]:
+        pass
+
+    async def close(self) -> None:
+        pass
+
+    async def sync(self) -> None:  # type: ignore
+        pass
+
+    async def preload(self) -> None:  # type: ignore
+        pass
+
+    def start(self) -> None:
+        pass
+
+    async def wait_closed(self) -> None:
+        pass

pyproject.toml

@@ -53,7 +53,7 @@ test = [
     "faker==18.13",
     "tox-pdm==0.7.0",
     "grpclib==0.4.6",
-    "protobuf<4.0.0",
+    "protobuf>=4.24.4",
     "grpcio==1.59.0",
     "hiku==0.7.1",
 ]
@@ -74,7 +74,7 @@ examples = [
     "flask>=2.2.5",
     "sanic>=23.3.0",
     "grpclib>=0.4.6",
-    "protobuf<4.0.0",
+    "protobuf>=4.24.4",
     "grpcio==1.59.0",
     "httpx>=0.24.1",
     "requests>=2.31.0",