fastapi-alertengine 1.1.2__tar.gz → 1.1.4__tar.gz

fastapi_alertengine-1.1.4/.claude/settings.local.json

@@ -0,0 +1,25 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python -m twine upload dist/fastapi_alertengine-1.1.1*)",
+      "Bash(rm -rf dist/)",
+      "Bash(python -m build)",
+      "Bash(gh pr create --title 'docs: replace README with polished production version + $49 starter pack CTA' --body ':*)",
+      "Bash(where gh:*)",
+      "Bash(mkdir -p /tmp/alertengine_test)",
+      "Read(//tmp/**)",
+      "Bash(python -m venv venv)",
+      "Bash(venv/Scripts/pip install:*)",
+      "Bash(venv/Scripts/python -c \"import fastapi_alertengine; print\\(dir\\(fastapi_alertengine\\)\\)\")",
+      "Bash(venv/Scripts/python test_suite.py)",
+      "Bash(python -m twine upload dist/fastapi_alertengine-1.1.2* -u __token__ -p \"pypi-AgEIcHlwaS5vcmcCJDY2YzU5ZDQ2LTc1MzYtNDBlMC05NmEwLWQzNjY1YWE0YzFmMwACKlszLCJkOGIzYzYyYi04ZjZhLTQ1Y2QtOGI0Yy04NjVkNTc3YzdiMzIiXQAABiCzHg3XIP-Fc19FHsOR-y7ODms4njBSo5IoiXTHJfzUaA\")",
+      "Bash(venv/Scripts/python -c ':*)",
+      "Read(//c/tmp/alertengine_test/**)",
+      "Bash(python -m twine upload dist/fastapi_alertengine-1.1.3* -u __token__ -p \"pypi-AgEIcHlwaS5vcmcCJDY2YzU5ZDQ2LTc1MzYtNDBlMC05NmEwLWQzNjY1YWE0YzFmMwACKlszLCJkOGIzYzYyYi04ZjZhLTQ1Y2QtOGI0Yy04NjVkNTc3YzdiMzIiXQAABiCzHg3XIP-Fc19FHsOR-y7ODms4njBSo5IoiXTHJfzUaA\")",
+      "Bash(python -m twine upload dist/fastapi_alertengine-1.1.3* -u __token__ -p \"pypi-AgEIcHlwaS5vcmcCJDY2YzU5ZDQ2LTc1MzYtNDBlMC05NmEwLWQzNjY1YWE0YzFmMwACKlszLCJkOGIzYzYyYi04ZjZhLTQ1Y2QtOGI0Yy04NjVkNTc3YzdiMzIiXQAABiCzHg3XIP-Fc19FHsOR-y7ODms4njBSo5IoiXTHJfzUaA\" --verbose)",
+      "Bash(venv/Scripts/python -m pytest \"C:/Users/HP/OneDrive/Documents/Tandem Hive/Tandem_Hive_V1_Final/.claude/worktrees/gracious-dubinsky/tests/test_engine_basic.py\" -v --tb=short --import-mode=importlib --pythonpath \"C:/Users/HP/OneDrive/Documents/Tandem Hive/Tandem_Hive_V1_Final/.claude/worktrees/gracious-dubinsky\")",
+      "Bash(PYTHONPATH=\"C:/Users/HP/OneDrive/Documents/Tandem Hive/Tandem_Hive_V1_Final/.claude/worktrees/gracious-dubinsky\" /tmp/alertengine_test/venv/Scripts/python -m pytest tests/test_engine_basic.py -v --tb=short)",
+      "Bash(python -m twine upload dist/fastapi_alertengine-1.1.4* -u __token__ -p \"pypi-AgEIcHlwaS5vcmcCJDY2YzU5ZDQ2LTc1MzYtNDBlMC05NmEwLWQzNjY1YWE0YzFmMwACKlszLCJkOGIzYzYyYi04ZjZhLTQ1Y2QtOGI0Yy04NjVkNTc3YzdiMzIiXQAABiCzHg3XIP-Fc19FHsOR-y7ODms4njBSo5IoiXTHJfzUaA\")"
+    ]
+  }
+}

{fastapi_alertengine-1.1.2 → fastapi_alertengine-1.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-alertengine
-Version: 1.1.2
+Version: 1.1.4
 Summary: Production-grade request metrics middleware and SLO alert engine for FastAPI + Redis Streams
 Project-URL: Homepage, https://anchorflow.com/tofamba
 Project-URL: Repository, https://github.com/Tandem-Media/Tandem_Hive_V1_Final

{fastapi_alertengine-1.1.2 → fastapi_alertengine-1.1.4}/examples/main.py

@@ -1,97 +1,79 @@
-# examples/main.py
-"""
-fastapi_alertengine — minimal demo app.
-
-Three endpoints:
-  GET /fast   — responds in ~5ms   (normal traffic)
-  GET /slow   — responds in ~600ms (triggers warning)
-  GET /error  — returns HTTP 500   (drives up error rate)
-
-Run:
-    pip install fastapi uvicorn redis fastapi-alertengine
-    redis-server &
-    uvicorn examples.main:app --reload
-
-Then hit the endpoints a few times and check:
-    curl http://localhost:8000/alerts
-"""
-
-import asyncio
-import os
-
-import redis
-from fastapi import FastAPI
-
-from fastapi_alertengine import (
-    AlertConfig,
-    AlertEngine,
-    RequestMetricsMiddleware,
-    aggregate,
-    get_alert_engine,
-)
-
-# ── Redis ─────────────────────────────────────────────────────────────────────
-
-REDIS_URL = os.getenv("REDIS_URL", "redis://localhost:6379")
-rdb = redis.Redis.from_url(REDIS_URL, decode_responses=True)
-
-# ── App ───────────────────────────────────────────────────────────────────────
-
-app = FastAPI(title="fastapi_alertengine demo", version="0.1.0")
-
-# Register metrics middleware — must come before any other middleware
-app.add_middleware(RequestMetricsMiddleware, redis=rdb)
-
-# ── Demo endpoints ────────────────────────────────────────────────────────────
-
-@app.get("/fast", tags=["demo"])
-async def fast_endpoint():
-    """Normal response — ~5ms latency."""
-    await asyncio.sleep(0.005)
-    return {"endpoint": "fast", "latency": "~5ms"}
-
-
-@app.get("/slow", tags=["demo"])
-async def slow_endpoint():
-    """Slow response — ~600ms latency, will push p95 into warning range."""
-    await asyncio.sleep(0.6)
-    return {"endpoint": "slow", "latency": "~600ms"}
-
-
-@app.get("/error", tags=["demo"])
-async def error_endpoint():
-    """Always returns 500 — drives up the error rate metric."""
-    from fastapi import HTTPException
-    raise HTTPException(status_code=500, detail="Intentional error for demo")
-
-
-# ── Alert status endpoint ─────────────────────────────────────────────────────
-
-@app.get("/alerts", tags=["observability"])
-def alert_status():
-    """
-    Evaluate current alert status from recent request metrics.
-
-    Returns the AlertEngine result plus a p95 breakdown by traffic type.
-    """
-    engine = get_alert_engine(redis_client=rdb)
-    event  = engine.evaluate()
-
-    return {
-        "status":  event.status,
-        "reason":  event.reason,
-        "metrics": {
-            "overall_p95_ms": event.metrics.overall_p95_ms,
-            "webhook_p95_ms": event.metrics.webhook_p95_ms,
-            "api_p95_ms":     event.metrics.api_p95_ms,
-            "error_rate":     event.metrics.error_rate,
-            "anomaly_score":  event.metrics.anomaly_score,
-            "sample_size":    event.metrics.sample_size,
-        },
-        "thresholds": {
-            "p95_warning_ms":      event.thresholds.p95_warning_ms,
-            "p95_critical_ms":     event.thresholds.p95_critical_ms,
-            "error_rate_critical": event.thresholds.error_rate_critical,
-        },
-        "aggregated": aggregate(rdb, AlertConfig()),
-    }
+# examples/main.py
+"""
+fastapi_alertengine — minimal demo app.
+
+Three endpoints:
+  GET /fast   — responds in ~5ms   (normal traffic)
+  GET /slow   — responds in ~600ms (triggers warning)
+  GET /error  — returns HTTP 500   (drives up error rate)
+
+Run:
+    pip install "fastapi[standard]" redis fastapi-alertengine
+    redis-server &
+    uvicorn examples.main:app --reload
+
+Then hit the endpoints a few times and check:
+    curl http://localhost:8000/alerts
+"""
+
+import asyncio
+import os
+
+import redis
+from fastapi import FastAPI, HTTPException
+
+from fastapi_alertengine import (
+    AlertConfig,
+    RequestMetricsMiddleware,
+    aggregate,
+    get_alert_engine,
+)
+
+# ── Redis + engine ────────────────────────────────────────────────────────────
+
+REDIS_URL = os.getenv("REDIS_URL", "redis://localhost:6379/0")
+rdb       = redis.Redis.from_url(REDIS_URL, decode_responses=True)
+engine    = get_alert_engine(redis_client=rdb)
+
+# ── App ───────────────────────────────────────────────────────────────────────
+
+app = FastAPI(title="fastapi_alertengine demo", version="1.1.4")
+
+# Register metrics middleware — must come before any other middleware
+app.add_middleware(RequestMetricsMiddleware, alert_engine=engine)
+
+# ── Demo endpoints ────────────────────────────────────────────────────────────
+
+@app.get("/fast", tags=["demo"])
+async def fast_endpoint():
+    """Normal response — ~5ms latency."""
+    await asyncio.sleep(0.005)
+    return {"endpoint": "fast", "latency": "~5ms"}
+
+
+@app.get("/slow", tags=["demo"])
+async def slow_endpoint():
+    """Slow response — ~600ms latency, will push p95 into warning range."""
+    await asyncio.sleep(0.6)
+    return {"endpoint": "slow", "latency": "~600ms"}
+
+
+@app.get("/error", tags=["demo"])
+async def error_endpoint():
+    """Always returns 500 — drives up the error rate metric."""
+    raise HTTPException(status_code=500, detail="Intentional error for demo")
+
+
+# ── Alert status endpoint ─────────────────────────────────────────────────────
+
+@app.get("/alerts", tags=["observability"])
+def alert_status():
+    """
+    Evaluate current alert status from recent request metrics.
+
+    Returns the AlertEngine result plus a p95 breakdown by traffic type.
+    """
+    return {
+        **engine.evaluate(window_size=200),
+        "aggregated": aggregate(rdb, engine.config),
+    }

{fastapi_alertengine-1.1.2 → fastapi_alertengine-1.1.4}/fastapi_alertengine/__init__.py

@@ -1,56 +1,53 @@
-# fastapi_alertengine/__init__.py
-"""
-fastapi_alertengine
-===================
-
-Production-grade request metrics middleware and SLO alert engine for
-FastAPI services.  Backed by Redis Streams.
-
-Quick start::
-
-    from fastapi import FastAPI
-    from fastapi_alertengine import RequestMetricsMiddleware, get_alert_engine
-    import redis
-
-    app = FastAPI()
-    rdb = redis.Redis.from_url("redis://localhost:6379", decode_responses=True)
-
-    app.add_middleware(RequestMetricsMiddleware, redis=rdb)
-
-    @app.get("/health/alerts")
-    def alert_status():
-        engine = get_alert_engine(redis_client=rdb)
-        event  = engine.evaluate()
-        return {"status": event.status, "metrics": event.metrics}
-"""
-
-from .client     import get_alert_engine
-from .config     import AlertConfig
-from .engine     import AlertDeduplicator, AlertEngine
-from .middleware  import RequestMetricsMiddleware
-from .schemas    import AlertEvent, AlertMetrics, AlertThresholds, RequestMetricEvent
-from .storage    import aggregate, read_metrics, write_metric
-
-__all__ = [
-    # Primary surface
-    "RequestMetricsMiddleware",
-    "AlertEngine",
-    "AlertDeduplicator",
-    "get_alert_engine",
-    # Config + schemas
-    "AlertConfig",
-    "AlertEvent",
-    "AlertMetrics",
-    "AlertThresholds",
-    "RequestMetricEvent",
-    # Storage helpers
-    "aggregate",
-    "read_metrics",
-    "write_metric",
-]
-
-try:
-    from importlib.metadata import version as _v
-    __version__ = _v("fastapi-alertengine")
-except Exception:
-    __version__ = "unknown"
+# fastapi_alertengine/__init__.py
+"""
+fastapi_alertengine
+===================
+
+Production-grade request metrics middleware and SLO alert engine for
+FastAPI services.  Backed by Redis Streams.
+
+Quick start::
+
+    from fastapi import FastAPI
+    from fastapi_alertengine import RequestMetricsMiddleware, get_alert_engine
+    import redis
+
+    app = FastAPI()
+    rdb = redis.Redis.from_url("redis://localhost:6379/0", decode_responses=True)
+
+    engine = get_alert_engine(redis_client=rdb)
+    app.add_middleware(RequestMetricsMiddleware, alert_engine=engine)
+
+    @app.get("/health/alerts")
+    def alert_status():
+        return engine.evaluate()
+"""
+
+from .client   import get_alert_engine
+from .config   import AlertConfig
+from .engine   import AlertDeduplicator, AlertEngine
+from .middleware import RequestMetricsMiddleware
+from .schemas  import RequestMetricEvent
+from .storage  import aggregate, p95, read_metrics, write_metric
+
+try:
+    from importlib.metadata import version as _v
+    __version__ = _v("fastapi-alertengine")
+except Exception:
+    __version__ = "unknown"
+
+__all__ = [
+    # Primary surface
+    "RequestMetricsMiddleware",
+    "AlertEngine",
+    "AlertDeduplicator",
+    "get_alert_engine",
+    # Config + schemas
+    "AlertConfig",
+    "RequestMetricEvent",
+    # Storage helpers
+    "aggregate",
+    "p95",
+    "read_metrics",
+    "write_metric",
+]

{fastapi_alertengine-1.1.2 → fastapi_alertengine-1.1.4}/fastapi_alertengine/client.py

@@ -1,65 +1,62 @@
-# fastapi_alertengine/client.py
-"""
-get_alert_engine() — process-level singleton factory.
-
-Lazily constructs one AlertEngine per (redis_url, config) pair and
-caches it for the lifetime of the process.  Safe to call from anywhere
-without worrying about duplicate Redis connections.
-
-Usage::
-
-    from fastapi_alertengine import get_alert_engine
-
-    engine = get_alert_engine(redis_url="redis://localhost:6379")
-    event  = engine.evaluate()
-"""
-
-import threading
-from typing import Optional
-
-import redis as _redis_lib
-
-from .config import AlertConfig
-from .engine import AlertEngine
-
-_lock     = threading.Lock()
-_registry: dict = {}
-
-
-def get_alert_engine(
-    redis_url: str                  = "redis://localhost:6379",
-    redis_client                    = None,
-    config:    Optional[AlertConfig] = None,
-) -> AlertEngine:
-    """
-    Return a cached :class:`~fastapi_alertengine.engine.AlertEngine`.
-
-    Pass either ``redis_url`` (a connection string) or an already-constructed
-    ``redis_client`` instance — not both.  If ``redis_client`` is supplied it
-    is used directly and ``redis_url`` is ignored.
-
-    Args:
-        redis_url:    Redis connection string (used if ``redis_client`` is None).
-        redis_client: Pre-built ``redis.Redis`` instance (optional).
-        config:       :class:`~fastapi_alertengine.config.AlertConfig`.
-                      Defaults to library defaults.
-
-    Returns:
-        A shared :class:`~fastapi_alertengine.engine.AlertEngine` instance.
-    """
-    cfg = config or AlertConfig()
-    key = id(redis_client) if redis_client is not None else redis_url
-
-    if key not in _registry:
-        with _lock:
-            if key not in _registry:
-                rdb = redis_client or _redis_lib.Redis.from_url(
-                    redis_url,
-                    decode_responses=True,
-                    socket_timeout=5,
-                    socket_connect_timeout=5,
-                    retry_on_timeout=True,
-                )
-                _registry[key] = AlertEngine(redis=rdb, config=cfg)
-
-    return _registry[key]
+# fastapi_alertengine/client.py
+"""
+get_alert_engine() — process-level singleton factory.
+
+Lazily constructs one AlertEngine per (redis_url, config) pair and caches it
+for the lifetime of the process.  Safe to call from anywhere without worrying
+about duplicate Redis connections.
+
+Usage::
+
+    from fastapi_alertengine import get_alert_engine
+
+    engine = get_alert_engine(redis_client=rdb)
+    result = engine.evaluate()
+"""
+
+import threading
+from typing import Optional
+
+import redis as _redis_lib
+
+from .config import AlertConfig
+from .engine import AlertEngine
+
+_lock:     threading.Lock = threading.Lock()
+_registry: dict           = {}
+
+
+def get_alert_engine(
+    config:       Optional[AlertConfig] = None,
+    redis_client                        = None,
+) -> AlertEngine:
+    """
+    Return a cached :class:`~fastapi_alertengine.engine.AlertEngine`.
+
+    Pass an already-constructed ``redis_client`` to reuse an existing
+    connection.  If omitted, a new client is created from
+    ``config.redis_url``.
+
+    Args:
+        config:       :class:`~fastapi_alertengine.config.AlertConfig`.
+                      Defaults to ``AlertConfig()`` (all library defaults).
+        redis_client: Pre-built ``redis.Redis`` instance (optional).
+
+    Returns:
+        A shared :class:`~fastapi_alertengine.engine.AlertEngine` instance.
+    """
+    cfg = config or AlertConfig()
+    key = id(redis_client) if redis_client is not None else cfg.redis_url
+
+    if key not in _registry:
+        with _lock:
+            if key not in _registry:
+                rdb = redis_client or _redis_lib.Redis.from_url(
+                    cfg.redis_url,
+                    decode_responses=True,
+                    socket_timeout=5,
+                    socket_connect_timeout=5,
+                )
+                _registry[key] = AlertEngine(redis=rdb, config=cfg)
+
+    return _registry[key]

{fastapi_alertengine-1.1.2 → fastapi_alertengine-1.1.4}/fastapi_alertengine/config.py

@@ -1,34 +1,37 @@
-# fastapi_alertengine/config.py
-from dataclasses import dataclass, field
-
-
-@dataclass
-class AlertConfig:
-    """
-    All tunable parameters for the alert engine in one place.
-
-    Pass a custom instance to RequestMetricsMiddleware and AlertEngine
-    to override any default without subclassing.
-    """
-
-    # ── Redis Stream ──────────────────────────────────────────────────────────
-    stream_key: str  = "fastapi_alertengine:request_metrics"
-    stream_maxlen: int = 10_000          # approximate cap (Redis MAXLEN ~)
-
-    # ── Latency thresholds (ms) ───────────────────────────────────────────────
-    p95_warning_ms: float  = 1_000.0
-    p95_critical_ms: float = 3_000.0
-
-    # ── Anomaly thresholds (ratio vs rolling mean) ────────────────────────────
-    anomaly_warning: float  = 1.0
-    anomaly_critical: float = 2.0
-
-    # ── Error-rate thresholds (fraction of 5xx responses) ────────────────────
-    error_rate_warning: float  = 0.10
-    error_rate_critical: float = 0.20
-
-    # ── Evaluation window ─────────────────────────────────────────────────────
-    window_size: int = 200               # events read per evaluate() call
-
-    # ── Deduplication ─────────────────────────────────────────────────────────
-    cooldown_seconds: int = 300          # min seconds between identical alerts
+# fastapi_alertengine/config.py
+from dataclasses import dataclass
+
+
+@dataclass
+class AlertConfig:
+    """
+    All tunable parameters for the alert engine in one place.
+
+    Pass a custom instance to get_alert_engine() or AlertEngine()
+    to override any default without subclassing.
+    """
+
+    # ── Redis connection ──────────────────────────────────────────────────────
+    redis_url:    str = "redis://localhost:6379/0"
+
+    # ── Redis Stream ──────────────────────────────────────────────────────────
+    stream_key:    str = "anchorflow:request_metrics"
+    stream_maxlen: int = 10_000          # approximate cap (Redis MAXLEN ~)
+
+    # ── Latency thresholds (ms) ───────────────────────────────────────────────
+    p95_warning_ms:  float = 1_000.0
+    p95_critical_ms: float = 3_000.0
+
+    # ── Anomaly thresholds (ratio vs rolling mean) ────────────────────────────
+    anomaly_warning:  float = 1.0
+    anomaly_critical: float = 2.0
+
+    # ── Error-rate thresholds (fraction of 5xx responses) ────────────────────
+    error_rate_warning:  float = 0.10
+    error_rate_critical: float = 0.20
+
+    # ── Evaluation window ─────────────────────────────────────────────────────
+    window_size: int = 200               # events read per evaluate() call
+
+    # ── Deduplication ─────────────────────────────────────────────────────────
+    cooldown_seconds: int = 300          # min seconds between identical alerts