flagswitch-sdk 0.1.0__py3-none-any.whl

flagswitch_sdk/__init__.py

@@ -0,0 +1,13 @@
+from flagswitch_sdk.client import FlagSwitch
+from flagswitch_sdk.exceptions import (
+    FlagSwitchConnectionError,
+    FlagSwitchError,
+    InvalidApiKeyError,
+)
+
+__all__ = [
+    "FlagSwitch",
+    "FlagSwitchError",
+    "InvalidApiKeyError",
+    "FlagSwitchConnectionError",
+]

flagswitch_sdk/client.py

@@ -0,0 +1,63 @@
+import time
+from typing import Any
+
+import httpx
+
+from flagswitch_sdk.exceptions import FlagSwitchConnectionError, InvalidApiKeyError
+
+
+_BASE_URL = "http://localhost:8010/api/fs"
+_CACHE_TTL = 30
+
+
+class FlagSwitch:
+    def __init__(self, api_key: str):
+        self._api_key = api_key
+        self._cache_ttl = _CACHE_TTL
+        self._cache: dict[str, Any] = {}
+        self._cache_ts: float = 0
+
+    def _is_cache_valid(self) -> bool:
+        return bool(self._cache) and (time.time() - self._cache_ts) < self._cache_ttl
+
+    async def _fetch_flags(self) -> dict[str, Any]:
+        try:
+            async with httpx.AsyncClient() as http:
+                response = await http.get(
+                    f"{_BASE_URL}/evaluate",
+                    headers={"X-Api-Key": self._api_key},
+                    timeout=5.0,
+                )
+        except httpx.RequestError as e:
+            raise FlagSwitchConnectionError(f"Failed to reach FlagSwitch server: {e}")
+
+        if response.status_code == 401:
+            raise InvalidApiKeyError("Invalid or inactive API key.")
+
+        if response.status_code != 200:
+            raise FlagSwitchConnectionError(
+                f"Unexpected response from FlagSwitch: {response.status_code}"
+            )
+
+        payload = response.json()
+        return payload.get("data") or {}
+
+    async def _get_flags(self) -> dict[str, Any]:
+        if self._is_cache_valid():
+            return self._cache
+
+        flags = await self._fetch_flags()
+        self._cache = flags
+        self._cache_ts = time.time()
+        return flags
+
+    async def is_enabled(self, key: str, default: bool = False) -> bool:
+        flags = await self._get_flags()
+        return bool(flags.get(key, default))
+
+    async def get_all_flags(self) -> dict[str, Any]:
+        return await self._get_flags()
+
+    def invalidate_cache(self) -> None:
+        self._cache = {}
+        self._cache_ts = 0

flagswitch_sdk/exceptions.py

@@ -0,0 +1,10 @@
+class FlagSwitchError(Exception):
+    pass
+
+
+class InvalidApiKeyError(FlagSwitchError):
+    pass
+
+
+class FlagSwitchConnectionError(FlagSwitchError):
+    pass

flagswitch_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: flagswitch-sdk
+Version: 0.1.0
+Summary: Python SDK for FlagSwitch feature flag management
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27

flagswitch_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+flagswitch_sdk/__init__.py,sha256=M2Tzsh6QBcMT0CYH42pFk9lh1EN5W178WdNLXARmuY0,278
+flagswitch_sdk/client.py,sha256=2E6I6zU-k4degIn8euqT7E-alLVhrqR0zk4fiecd-Tw,1921
+flagswitch_sdk/exceptions.py,sha256=1U7kIpG7gpDWlNUTY0DMSu7jvyQNthd6uKAvUWznlTI,158
+flagswitch_sdk-0.1.0.dist-info/METADATA,sha256=1i9JSx55Gb-TKFZzDtHgzwY9V1lA5f_0MLEymtjW3HA,168
+flagswitch_sdk-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+flagswitch_sdk-0.1.0.dist-info/top_level.txt,sha256=HBU_4eNfY6K1zhUZ0MivKVIjO1hKA0t9OnXe2ga0-mA,15
+flagswitch_sdk-0.1.0.dist-info/RECORD,,

flagswitch_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

flagswitch_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+flagswitch_sdk