flagly-sdk 0.1.0__tar.gz

flagly_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: flagly-sdk
+Version: 0.1.0
+Summary: Python SDK for the Flagly feature-flag API
+License: MIT
+Project-URL: Homepage, https://github.com/useflagly/backend
+Project-URL: Repository, https://github.com/useflagly/backend
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

flagly_sdk-0.1.0/flagly/__init__.py

@@ -0,0 +1,4 @@
+from .client import FlaglyClient
+from .models import ValidateBody, ReceiveMessage
+
+__all__ = ["FlaglyClient", "ValidateBody", "ReceiveMessage"]

flagly_sdk-0.1.0/flagly/client.py

@@ -0,0 +1,93 @@
+"""HTTP client for the Flagly feature-flag API."""
+
+from __future__ import annotations
+
+import json
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Optional
+
+from .models import ValidateBody, ReceiveMessage
+
+
+class FlaglyClient:
+    """Client for the Flagly /validate API."""
+
+    def __init__(self, base_url: str, token: Optional[str] = None, timeout: float = 10.0) -> None:
+        self._base_url = base_url.rstrip("/")
+        self._token = token
+        self._timeout = timeout
+
+    def _headers(self, environment: Optional[str] = None) -> Dict[str, str]:
+        h = {"Content-Type": "application/json"}
+        if self._token:
+            h["Authorization"] = f"Bearer {self._token}"
+        if environment:
+            h["environment"] = environment
+        return h
+
+    def _request(self, method: str, path: str, body: Any = None, environment: Optional[str] = None) -> Any:
+        url = self._base_url + path
+        data = json.dumps(body).encode() if body is not None else None
+        req = urllib.request.Request(url, data=data, headers=self._headers(environment), method=method)
+        with urllib.request.urlopen(req, timeout=self._timeout) as resp:
+            raw = resp.read()
+            if not raw:
+                return None
+            return json.loads(raw)
+
+    def health_check(self) -> Dict[str, Any]:
+        """GET /validate/health"""
+        return self._request("GET", "/validate/health")
+
+    def validate_flag(self, slug: str, body: ValidateBody, environment: Optional[str] = None) -> Dict[str, Any]:
+        """POST /validate/flag/:slug"""
+        return self._request("POST", f"/validate/flag/{urllib.parse.quote(slug)}", body.to_dict(), environment)
+
+    def get_flag_cache(self, slug: str, identifier: Optional[str] = None) -> Dict[str, Any]:
+        """GET /validate/flag/:slug"""
+        path = f"/validate/flag/{urllib.parse.quote(slug)}"
+        if identifier:
+            path += f"?identifier={urllib.parse.quote(identifier)}"
+        return self._request("GET", path)
+
+    def validate_flow(self, slug: str, body: ValidateBody, environment: Optional[str] = None) -> Dict[str, Any]:
+        """POST /validate/flow/:slug"""
+        return self._request("POST", f"/validate/flow/{urllib.parse.quote(slug)}", body.to_dict(), environment)
+
+    def get_flow_cache(self, slug: str, identifier: Optional[str] = None) -> Dict[str, Any]:
+        """GET /validate/flow/:slug"""
+        path = f"/validate/flow/{urllib.parse.quote(slug)}"
+        if identifier:
+            path += f"?identifier={urllib.parse.quote(identifier)}"
+        return self._request("GET", path)
+
+    def validate_flow_part(self, slug: str, body: ValidateBody, environment: Optional[str] = None) -> Dict[str, Any]:
+        """POST /validate/flow-part/:slug"""
+        return self._request("POST", f"/validate/flow-part/{urllib.parse.quote(slug)}", body.to_dict(), environment)
+
+    def get_flow_part_cache(self, slug: str, identifier: Optional[str] = None) -> Dict[str, Any]:
+        """GET /validate/flow-part/:slug"""
+        path = f"/validate/flow-part/{urllib.parse.quote(slug)}"
+        if identifier:
+            path += f"?identifier={urllib.parse.quote(identifier)}"
+        return self._request("GET", path)
+
+    def validate_scenario(self, slug: str, body: ValidateBody, environment: Optional[str] = None) -> Dict[str, Any]:
+        """POST /validate/scenario/:slug"""
+        return self._request("POST", f"/validate/scenario/{urllib.parse.quote(slug)}", body.to_dict(), environment)
+
+    def get_scenario_cache(self, slug: str, identifier: Optional[str] = None) -> Dict[str, Any]:
+        """GET /validate/scenario/:slug"""
+        path = f"/validate/scenario/{urllib.parse.quote(slug)}"
+        if identifier:
+            path += f"?identifier={urllib.parse.quote(identifier)}"
+        return self._request("GET", path)
+
+    def initialize(self, body: ReceiveMessage, environment: Optional[str] = None) -> Optional[Dict[str, Any]]:
+        """POST /validate/initialize"""
+        return self._request("POST", "/validate/initialize", body.to_dict(), environment)
+
+    def get_result(self, identifier: str) -> Dict[str, Any]:
+        """GET /validate/result/:identifier"""
+        return self._request("GET", f"/validate/result/{urllib.parse.quote(identifier)}")

flagly_sdk-0.1.0/flagly/models.py

@@ -0,0 +1,54 @@
+# Code generated from JSON Schema. DO NOT EDIT.
+from __future__ import annotations
+from typing import Any, Dict, Optional
+
+
+class ValidateBody:
+    identifier: Optional[str]
+    context: Optional[Dict[str, Any]]
+
+    def __init__(self, identifier: Optional[str] = None, context: Optional[Dict[str, Any]] = None) -> None:
+        self.identifier = identifier
+        self.context = context
+
+    def to_dict(self) -> Dict[str, Any]:
+        result: Dict[str, Any] = {}
+        if self.identifier is not None:
+            result["identifier"] = self.identifier
+        if self.context is not None:
+            result["context"] = self.context
+        return result
+
+    @staticmethod
+    def from_dict(d: Dict[str, Any]) -> "ValidateBody":
+        return ValidateBody(identifier=d.get("identifier"), context=d.get("context"))
+
+
+class ReceiveMessage:
+    identifier: str
+    slug: str
+    company_id: Optional[float]
+    context: Optional[Dict[str, Any]]
+
+    def __init__(self, identifier: str, slug: str, company_id: Optional[float] = None, context: Optional[Dict[str, Any]] = None) -> None:
+        self.identifier = identifier
+        self.slug = slug
+        self.company_id = company_id
+        self.context = context
+
+    def to_dict(self) -> Dict[str, Any]:
+        result: Dict[str, Any] = {"identifier": self.identifier, "slug": self.slug}
+        if self.company_id is not None:
+            result["companyId"] = self.company_id
+        if self.context is not None:
+            result["context"] = self.context
+        return result
+
+    @staticmethod
+    def from_dict(d: Dict[str, Any]) -> "ReceiveMessage":
+        return ReceiveMessage(
+            identifier=d["identifier"],
+            slug=d["slug"],
+            company_id=d.get("companyId"),
+            context=d.get("context"),
+        )

flagly_sdk-0.1.0/flagly_sdk.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: flagly-sdk
+Version: 0.1.0
+Summary: Python SDK for the Flagly feature-flag API
+License: MIT
+Project-URL: Homepage, https://github.com/useflagly/backend
+Project-URL: Repository, https://github.com/useflagly/backend
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

flagly_sdk-0.1.0/flagly_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+flagly/__init__.py
+flagly/client.py
+flagly/models.py
+flagly_sdk.egg-info/PKG-INFO
+flagly_sdk.egg-info/SOURCES.txt
+flagly_sdk.egg-info/dependency_links.txt
+flagly_sdk.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+flagly

flagly_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flagly-sdk"
+version = "0.1.0"
+description = "Python SDK for the Flagly feature-flag API"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/useflagly/backend"
+Repository = "https://github.com/useflagly/backend"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["flagly*"]

flagly_sdk-0.1.0/setup.cfg

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