flagswitch-sdk 0.1.0__tar.gz

flagswitch_sdk-0.1.0/PKG-INFO

@@ -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/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-0.1.0/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-0.1.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/flagswitch_sdk.egg-info/PKG-INFO

@@ -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/flagswitch_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+pyproject.toml
+flagswitch_sdk/__init__.py
+flagswitch_sdk/client.py
+flagswitch_sdk/exceptions.py
+flagswitch_sdk.egg-info/PKG-INFO
+flagswitch_sdk.egg-info/SOURCES.txt
+flagswitch_sdk.egg-info/dependency_links.txt
+flagswitch_sdk.egg-info/requires.txt
+flagswitch_sdk.egg-info/top_level.txt

flagswitch_sdk-0.1.0/flagswitch_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flagswitch_sdk-0.1.0/flagswitch_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.27

flagswitch_sdk-0.1.0/flagswitch_sdk.egg-info/top_level.txt

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

flagswitch_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flagswitch-sdk"
+version = "0.1.0"
+description = "Python SDK for FlagSwitch feature flag management"
+requires-python = ">=3.11"
+dependencies = ["httpx>=0.27"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["flagswitch_sdk*"]

flagswitch_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+