flowwatch-client 2.1.0__tar.gz

flowwatch_client-2.1.0/.gitignore

@@ -0,0 +1,76 @@
+# Dependencies
+node_modules/
+**/node_modules/
+
+# Build output
+dist/
+build/
+out/
+coverage/
+*.tsbuildinfo
+
+# Package manager caches
+.npm/
+.pnpm-store/
+.yarn/
+!.yarn/releases/
+!.yarn/plugins/
+!.yarn/sdks/
+!.yarn/versions/
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Environment and local secrets
+.env
+.env.*
+!.env.example
+!.env*.example
+.fw.env
+
+# Test app (internal development only)
+apps/test-app/
+apps/
+
+# Local infra data
+infra/data/
+infra/.data/
+docker-data/
+postgres-data/
+redis-data/
+elasticsearch-data/
+flowwatch_npm_project_details.md
+PROJECT_HANDOFF.md
+docs/
+
+# Runtime temp files
+tmp/
+temp/
+.cache/
+
+# Test and tooling caches
+.nyc_output/
+.vitest/
+.jest/
+.eslintcache
+
+# Framework/tool output
+.vite/
+.turbo/
+.next/
+
+# IDE/editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+desktop.ini

flowwatch_client-2.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: flowwatch-client
+Version: 2.1.0
+Summary: Python client SDK for FlowWatch — feature flags, durable workflows, tracing, and error capture
+Project-URL: Homepage, https://github.com/PranshulSoni/flowwatch
+Project-URL: Issues, https://github.com/PranshulSoni/flowwatch/issues
+License: ISC
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# flowwatch (Python)
+
+Python client for [FlowWatch](https://github.com/PranshulSoni/flowwatch). Wraps the FlowWatch sidecar REST API — requires the [sidecar server](https://github.com/PranshulSoni/flowwatch#multi-language-support-sidecar-server) to be running.
+
+## Install
+
+```bash
+pip install flowwatch-client
+```
+
+## Usage
+
+```python
+from flowwatch import FlowwatchClient
+
+client = FlowwatchClient("http://localhost:9400", token="your-sidecar-token")
+
+# Feature flag
+if client.evaluate_flag("new-billing-flow", {"userId": "u123", "plan": "pro"}):
+    use_new_flow()
+
+# Durable workflow
+result = client.trigger_workflow("checkout", {"cartId": "cart_1"})
+print(result["executionId"])
+
+# Auto-timed trace span
+with client.trace_span("process-order", "function"):
+    process_order()
+
+# Error capture
+try:
+    risky()
+except Exception as e:
+    import traceback
+    client.capture_error(str(e), stack=traceback.format_exc(), source="my-service")
+
+# Health check
+print(client.health())
+
+client.close()
+```
+
+### Async
+
+```python
+from flowwatch import AsyncFlowwatchClient
+
+async with AsyncFlowwatchClient("http://localhost:9400", token="your-token") as client:
+    enabled = await client.evaluate_flag("dark-mode", {"userId": "u1"})
+    result = await client.trigger_workflow("send-email", {"to": "user@example.com"})
+```

flowwatch_client-2.1.0/README.md

@@ -0,0 +1,51 @@
+# flowwatch (Python)
+
+Python client for [FlowWatch](https://github.com/PranshulSoni/flowwatch). Wraps the FlowWatch sidecar REST API — requires the [sidecar server](https://github.com/PranshulSoni/flowwatch#multi-language-support-sidecar-server) to be running.
+
+## Install
+
+```bash
+pip install flowwatch-client
+```
+
+## Usage
+
+```python
+from flowwatch import FlowwatchClient
+
+client = FlowwatchClient("http://localhost:9400", token="your-sidecar-token")
+
+# Feature flag
+if client.evaluate_flag("new-billing-flow", {"userId": "u123", "plan": "pro"}):
+    use_new_flow()
+
+# Durable workflow
+result = client.trigger_workflow("checkout", {"cartId": "cart_1"})
+print(result["executionId"])
+
+# Auto-timed trace span
+with client.trace_span("process-order", "function"):
+    process_order()
+
+# Error capture
+try:
+    risky()
+except Exception as e:
+    import traceback
+    client.capture_error(str(e), stack=traceback.format_exc(), source="my-service")
+
+# Health check
+print(client.health())
+
+client.close()
+```
+
+### Async
+
+```python
+from flowwatch import AsyncFlowwatchClient
+
+async with AsyncFlowwatchClient("http://localhost:9400", token="your-token") as client:
+    enabled = await client.evaluate_flag("dark-mode", {"userId": "u1"})
+    result = await client.trigger_workflow("send-email", {"to": "user@example.com"})
+```

flowwatch_client-2.1.0/flowwatch/__init__.py

@@ -0,0 +1,3 @@
+from .client import AsyncFlowwatchClient, FlowwatchClient
+
+__all__ = ["FlowwatchClient", "AsyncFlowwatchClient"]

flowwatch_client-2.1.0/flowwatch/client.py

@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+import time
+from contextlib import contextmanager
+from typing import Any, Generator
+
+import httpx
+
+
+class FlowwatchClient:
+    """Synchronous FlowWatch sidecar client. Use as a context manager for connection cleanup."""
+
+    def __init__(self, base_url: str = "http://localhost:9400", token: str | None = None) -> None:
+        headers = {"Authorization": f"Bearer {token}"} if token else {}
+        self._http = httpx.Client(base_url=base_url, headers=headers)
+
+    def evaluate_flag(self, key: str, context: dict[str, Any] | None = None) -> bool:
+        r = self._http.post("/api/flag", json={"key": key, "context": context or {}})
+        r.raise_for_status()
+        return bool(r.json().get("enabled", False))
+
+    def trigger_workflow(self, name: str, input: Any = None) -> dict[str, Any]:
+        r = self._http.post("/api/trigger", json={"name": name, "input": input})
+        r.raise_for_status()
+        return r.json()
+
+    def log_trace_span(
+        self,
+        name: str,
+        type: str,
+        duration_ms: float,
+        status: str = "ok",
+        metadata: dict[str, Any] | None = None,
+    ) -> None:
+        r = self._http.post(
+            "/api/trace-span",
+            json={"name": name, "type": type, "durationMs": duration_ms, "status": status, "metadata": metadata},
+        )
+        r.raise_for_status()
+
+    def capture_error(
+        self,
+        message: str,
+        name: str = "Error",
+        stack: str | None = None,
+        source: str | None = None,
+        **options: Any,
+    ) -> None:
+        r = self._http.post(
+            "/api/capture-error",
+            json={
+                "error": {"message": message, "name": name, "stack": stack},
+                "options": {"source": source, **options},
+            },
+        )
+        r.raise_for_status()
+
+    def health(self) -> dict[str, Any]:
+        r = self._http.get("/api/health")
+        r.raise_for_status()
+        return r.json()
+
+    @contextmanager
+    def trace_span(
+        self, name: str, type: str, metadata: dict[str, Any] | None = None
+    ) -> Generator[None, None, None]:
+        """Auto-times the wrapped block and submits a trace span on exit."""
+        start = time.monotonic()
+        status = "ok"
+        try:
+            yield
+        except Exception:
+            status = "error"
+            raise
+        finally:
+            self.log_trace_span(name, type, (time.monotonic() - start) * 1000, status, metadata)
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> FlowwatchClient:
+        return self
+
+    def __exit__(self, *_: Any) -> None:
+        self.close()
+
+
+class AsyncFlowwatchClient:
+    """Async FlowWatch sidecar client. Use as an async context manager for connection cleanup."""
+
+    def __init__(self, base_url: str = "http://localhost:9400", token: str | None = None) -> None:
+        headers = {"Authorization": f"Bearer {token}"} if token else {}
+        self._http = httpx.AsyncClient(base_url=base_url, headers=headers)
+
+    async def evaluate_flag(self, key: str, context: dict[str, Any] | None = None) -> bool:
+        r = await self._http.post("/api/flag", json={"key": key, "context": context or {}})
+        r.raise_for_status()
+        return bool(r.json().get("enabled", False))
+
+    async def trigger_workflow(self, name: str, input: Any = None) -> dict[str, Any]:
+        r = await self._http.post("/api/trigger", json={"name": name, "input": input})
+        r.raise_for_status()
+        return r.json()
+
+    async def log_trace_span(
+        self,
+        name: str,
+        type: str,
+        duration_ms: float,
+        status: str = "ok",
+        metadata: dict[str, Any] | None = None,
+    ) -> None:
+        r = await self._http.post(
+            "/api/trace-span",
+            json={"name": name, "type": type, "durationMs": duration_ms, "status": status, "metadata": metadata},
+        )
+        r.raise_for_status()
+
+    async def capture_error(
+        self,
+        message: str,
+        name: str = "Error",
+        stack: str | None = None,
+        source: str | None = None,
+        **options: Any,
+    ) -> None:
+        r = await self._http.post(
+            "/api/capture-error",
+            json={
+                "error": {"message": message, "name": name, "stack": stack},
+                "options": {"source": source, **options},
+            },
+        )
+        r.raise_for_status()
+
+    async def health(self) -> dict[str, Any]:
+        r = await self._http.get("/api/health")
+        r.raise_for_status()
+        return r.json()
+
+    async def aclose(self) -> None:
+        await self._http.aclose()
+
+    async def __aenter__(self) -> AsyncFlowwatchClient:
+        return self
+
+    async def __aexit__(self, *_: Any) -> None:
+        await self.aclose()

flowwatch_client-2.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "flowwatch-client"
+version = "2.1.0"
+description = "Python client SDK for FlowWatch — feature flags, durable workflows, tracing, and error capture"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "ISC" }
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/PranshulSoni/flowwatch"
+Issues = "https://github.com/PranshulSoni/flowwatch/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["flowwatch"]