reqly 0.1.0__tar.gz → 0.1.2__tar.gz

reqly-0.1.2/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: reqly
+Version: 0.1.2
+Summary: Auto-instrumentation SDK for FastAPI and Flask: zero-code latency, error rates, and status codes shipped to a Reqly collector.
+Author: reqly
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://reqly-sdk.vercel.app/
+Project-URL: Repository, https://github.com/tanisheesh/reqly
+Project-URL: Issues, https://github.com/tanisheesh/reqly/issues
+Project-URL: Documentation, https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md
+Project-URL: Live Demo, https://eventflow-g2h5.onrender.com
+Keywords: observability,apm,monitoring,fastapi,flask,telemetry,metrics,latency,tracing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Classifier: Framework :: FastAPI
+Classifier: Framework :: Flask
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1.0,>=0.27
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask>=2.3; extra == "flask"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: fastapi>=0.100; extra == "dev"
+Requires-Dist: flask>=2.3; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+
+# reqly
+
+**Open-source API observability SDK for FastAPI and Flask.**  
+Auto-instrument your app with 2 lines of code — get latency percentiles, error rates, status distribution, top routes, and weekly AI-generated anomaly reports.
+
+[![PyPI](https://img.shields.io/pypi/v/reqly?color=06b6d4&label=reqly)](https://pypi.org/project/reqly/)
+[![Python](https://img.shields.io/pypi/pyversions/reqly?color=06b6d4)](https://pypi.org/project/reqly/)
+[![License: GPL v3](https://img.shields.io/badge/license-GPL--3.0-06b6d4)](https://github.com/tanisheesh/reqly/blob/main/LICENSE)
+
+---
+
+## Install
+
+```bash
+pip install reqly
+```
+
+## Usage
+
+**FastAPI**
+
+```python
+import reqly
+from fastapi import FastAPI
+
+app = FastAPI()
+reqly.instrument(app, service_name="checkout-api")
+# Every route is now tracked — latency · error rate · status codes
+```
+
+**Flask**
+
+```python
+import reqly
+from flask import Flask
+
+app = Flask(__name__)
+reqly.instrument(app, service_name="checkout-api")
+```
+
+`instrument()` auto-detects FastAPI vs Flask — no other code changes needed.
+
+## What you get
+
+- **p50 / p95 / p99 latency** per route
+- **Error rates** and status code distribution (2xx / 3xx / 4xx / 5xx)
+- **Top routes** ranked by volume and error rate
+- **Live requests/min** tile, time windows 1h / 6h / 24h / 7d
+- **Weekly AI anomaly report** — z-score detection with Groq (Llama 3.3-70b) writing the narrative
+
+> "Your `/auth` endpoint degrades every Monday morning (08:00–10:00), with error rate at 18% vs. a 2% baseline and p95 latency at 1850ms vs. 320ms baseline."
+
+## Live Demo
+
+Reqly is running live against [EventFlow](https://eventflow-g2h5.onrender.com), a Flask event management app.
+
+- **Demo app** → [eventflow-g2h5.onrender.com](https://eventflow-g2h5.onrender.com)
+- **Metrics dashboard** → [reqly-eventflow-dashboard.onrender.com](https://reqly-eventflow-dashboard.onrender.com)
+
+> Login as **Administrator** (`admin@eventhub.com` / `Admin@123`) → click **Metrics** in the nav.
+
+## Configuration
+
+Every option can be passed as a kwarg to `instrument()` or set via environment variable.  
+Resolution order: **kwarg → env var → default**.
+
+| kwarg | env var | default |
+|---|---|---|
+| `service_name` | `REQLY_SERVICE_NAME` | `sys.argv[0]` basename |
+| `collector_url` | `REQLY_COLLECTOR_URL` | `http://localhost:8000` |
+| `api_key` | `REQLY_API_KEY` | `None` |
+| `sample_rate` | `REQLY_SAMPLE_RATE` | `1.0` |
+| `flush_interval_seconds` | `REQLY_FLUSH_INTERVAL_SECONDS` | `5.0` |
+| `max_batch_size` | `REQLY_MAX_BATCH_SIZE` | `200` |
+| `max_queue_size` | `REQLY_MAX_QUEUE_SIZE` | `2000` |
+| `ignore_routes` | `REQLY_IGNORE_ROUTES` (comma-separated) | `/health,/metrics` |
+| `capture_request_body` | `REQLY_CAPTURE_REQUEST_BODY` | `False` |
+
+## Design guarantees
+
+**Fail-open** — any internal SDK error is caught and logged once; instrumentation disables itself rather than raise into your app. A slow or unreachable collector never blocks request threads — all shipping happens on a background thread with strict HTTP timeouts.
+
+**Bounded cardinality** — routes are captured as the framework's matched template (`/users/{id}`), never the raw path (`/users/123`). Unmatched paths collapse into a single `__unmatched__` bucket.
+
+**Bounded memory** — events are held in a fixed-size in-memory queue; under backpressure, oldest events are dropped and counted rather than growing unbounded.
+
+## Self-hosting
+
+Reqly is fully self-hostable. Run the full stack (collector + TimescaleDB + dashboard) with Docker Compose:
+
+```bash
+git clone https://github.com/tanisheesh/reqly.git
+cd reqly
+docker compose up -d
+```
+
+See the [repository](https://github.com/tanisheesh/reqly) and [CONTRIBUTING.md](https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md) for full setup instructions.
+
+## License
+
+GPL-3.0-or-later — see [LICENSE](https://github.com/tanisheesh/reqly/blob/main/LICENSE).

reqly-0.1.2/README.md

@@ -0,0 +1,101 @@
+# reqly
+
+**Open-source API observability SDK for FastAPI and Flask.**  
+Auto-instrument your app with 2 lines of code — get latency percentiles, error rates, status distribution, top routes, and weekly AI-generated anomaly reports.
+
+[![PyPI](https://img.shields.io/pypi/v/reqly?color=06b6d4&label=reqly)](https://pypi.org/project/reqly/)
+[![Python](https://img.shields.io/pypi/pyversions/reqly?color=06b6d4)](https://pypi.org/project/reqly/)
+[![License: GPL v3](https://img.shields.io/badge/license-GPL--3.0-06b6d4)](https://github.com/tanisheesh/reqly/blob/main/LICENSE)
+
+---
+
+## Install
+
+```bash
+pip install reqly
+```
+
+## Usage
+
+**FastAPI**
+
+```python
+import reqly
+from fastapi import FastAPI
+
+app = FastAPI()
+reqly.instrument(app, service_name="checkout-api")
+# Every route is now tracked — latency · error rate · status codes
+```
+
+**Flask**
+
+```python
+import reqly
+from flask import Flask
+
+app = Flask(__name__)
+reqly.instrument(app, service_name="checkout-api")
+```
+
+`instrument()` auto-detects FastAPI vs Flask — no other code changes needed.
+
+## What you get
+
+- **p50 / p95 / p99 latency** per route
+- **Error rates** and status code distribution (2xx / 3xx / 4xx / 5xx)
+- **Top routes** ranked by volume and error rate
+- **Live requests/min** tile, time windows 1h / 6h / 24h / 7d
+- **Weekly AI anomaly report** — z-score detection with Groq (Llama 3.3-70b) writing the narrative
+
+> "Your `/auth` endpoint degrades every Monday morning (08:00–10:00), with error rate at 18% vs. a 2% baseline and p95 latency at 1850ms vs. 320ms baseline."
+
+## Live Demo
+
+Reqly is running live against [EventFlow](https://eventflow-g2h5.onrender.com), a Flask event management app.
+
+- **Demo app** → [eventflow-g2h5.onrender.com](https://eventflow-g2h5.onrender.com)
+- **Metrics dashboard** → [reqly-eventflow-dashboard.onrender.com](https://reqly-eventflow-dashboard.onrender.com)
+
+> Login as **Administrator** (`admin@eventhub.com` / `Admin@123`) → click **Metrics** in the nav.
+
+## Configuration
+
+Every option can be passed as a kwarg to `instrument()` or set via environment variable.  
+Resolution order: **kwarg → env var → default**.
+
+| kwarg | env var | default |
+|---|---|---|
+| `service_name` | `REQLY_SERVICE_NAME` | `sys.argv[0]` basename |
+| `collector_url` | `REQLY_COLLECTOR_URL` | `http://localhost:8000` |
+| `api_key` | `REQLY_API_KEY` | `None` |
+| `sample_rate` | `REQLY_SAMPLE_RATE` | `1.0` |
+| `flush_interval_seconds` | `REQLY_FLUSH_INTERVAL_SECONDS` | `5.0` |
+| `max_batch_size` | `REQLY_MAX_BATCH_SIZE` | `200` |
+| `max_queue_size` | `REQLY_MAX_QUEUE_SIZE` | `2000` |
+| `ignore_routes` | `REQLY_IGNORE_ROUTES` (comma-separated) | `/health,/metrics` |
+| `capture_request_body` | `REQLY_CAPTURE_REQUEST_BODY` | `False` |
+
+## Design guarantees
+
+**Fail-open** — any internal SDK error is caught and logged once; instrumentation disables itself rather than raise into your app. A slow or unreachable collector never blocks request threads — all shipping happens on a background thread with strict HTTP timeouts.
+
+**Bounded cardinality** — routes are captured as the framework's matched template (`/users/{id}`), never the raw path (`/users/123`). Unmatched paths collapse into a single `__unmatched__` bucket.
+
+**Bounded memory** — events are held in a fixed-size in-memory queue; under backpressure, oldest events are dropped and counted rather than growing unbounded.
+
+## Self-hosting
+
+Reqly is fully self-hostable. Run the full stack (collector + TimescaleDB + dashboard) with Docker Compose:
+
+```bash
+git clone https://github.com/tanisheesh/reqly.git
+cd reqly
+docker compose up -d
+```
+
+See the [repository](https://github.com/tanisheesh/reqly) and [CONTRIBUTING.md](https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md) for full setup instructions.
+
+## License
+
+GPL-3.0-or-later — see [LICENSE](https://github.com/tanisheesh/reqly/blob/main/LICENSE).

{reqly-0.1.0 → reqly-0.1.2}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reqly"
-version = "0.1.0"
+version = "0.1.2"
 description = "Auto-instrumentation SDK for FastAPI and Flask: zero-code latency, error rates, and status codes shipped to a Reqly collector."
 readme = "README.md"
 requires-python = ">=3.9"
-license = "MIT"
+license = "GPL-3.0-or-later"
 authors = [{ name = "reqly" }]
 keywords = [
     "observability", "apm", "monitoring", "fastapi", "flask",
@@ -32,10 +32,11 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/tanisheesh/reqly"
+Homepage = "https://reqly-sdk.vercel.app/"
 Repository = "https://github.com/tanisheesh/reqly"
 Issues = "https://github.com/tanisheesh/reqly/issues"
 Documentation = "https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md"
+"Live Demo" = "https://eventflow-g2h5.onrender.com"
 
 [project.optional-dependencies]
 fastapi = ["fastapi>=0.100"]

{reqly-0.1.0 → reqly-0.1.2}/reqly/core/shipper.py

@@ -59,12 +59,19 @@ class Shipper:
         for attempt in range(_MAX_RETRIES):
             try:
                 response = self._client.post("/v1/ingest", json=payload)
-                if response.status_code < 500:
+                if response.status_code < 400:
                     self.shipped_events += len(events)
                     return True
+                if response.status_code != 429:
+                    # permanent client error (auth failure, bad payload, etc.) — no point retrying
+                    logger.warning(
+                        "reqly: collector rejected batch with %s, dropping",
+                        response.status_code,
+                    )
+                    self.dropped_batches += 1
+                    return False
                 logger.debug(
-                    "reqly: collector returned %s, attempt %d/%d",
-                    response.status_code,
+                    "reqly: rate-limited (429), attempt %d/%d",
                     attempt + 1,
                     _MAX_RETRIES,
                 )

reqly-0.1.2/reqly.egg-info/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: reqly
+Version: 0.1.2
+Summary: Auto-instrumentation SDK for FastAPI and Flask: zero-code latency, error rates, and status codes shipped to a Reqly collector.
+Author: reqly
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://reqly-sdk.vercel.app/
+Project-URL: Repository, https://github.com/tanisheesh/reqly
+Project-URL: Issues, https://github.com/tanisheesh/reqly/issues
+Project-URL: Documentation, https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md
+Project-URL: Live Demo, https://eventflow-g2h5.onrender.com
+Keywords: observability,apm,monitoring,fastapi,flask,telemetry,metrics,latency,tracing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Classifier: Framework :: FastAPI
+Classifier: Framework :: Flask
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1.0,>=0.27
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask>=2.3; extra == "flask"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: fastapi>=0.100; extra == "dev"
+Requires-Dist: flask>=2.3; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+
+# reqly
+
+**Open-source API observability SDK for FastAPI and Flask.**  
+Auto-instrument your app with 2 lines of code — get latency percentiles, error rates, status distribution, top routes, and weekly AI-generated anomaly reports.
+
+[![PyPI](https://img.shields.io/pypi/v/reqly?color=06b6d4&label=reqly)](https://pypi.org/project/reqly/)
+[![Python](https://img.shields.io/pypi/pyversions/reqly?color=06b6d4)](https://pypi.org/project/reqly/)
+[![License: GPL v3](https://img.shields.io/badge/license-GPL--3.0-06b6d4)](https://github.com/tanisheesh/reqly/blob/main/LICENSE)
+
+---
+
+## Install
+
+```bash
+pip install reqly
+```
+
+## Usage
+
+**FastAPI**
+
+```python
+import reqly
+from fastapi import FastAPI
+
+app = FastAPI()
+reqly.instrument(app, service_name="checkout-api")
+# Every route is now tracked — latency · error rate · status codes
+```
+
+**Flask**
+
+```python
+import reqly
+from flask import Flask
+
+app = Flask(__name__)
+reqly.instrument(app, service_name="checkout-api")
+```
+
+`instrument()` auto-detects FastAPI vs Flask — no other code changes needed.
+
+## What you get
+
+- **p50 / p95 / p99 latency** per route
+- **Error rates** and status code distribution (2xx / 3xx / 4xx / 5xx)
+- **Top routes** ranked by volume and error rate
+- **Live requests/min** tile, time windows 1h / 6h / 24h / 7d
+- **Weekly AI anomaly report** — z-score detection with Groq (Llama 3.3-70b) writing the narrative
+
+> "Your `/auth` endpoint degrades every Monday morning (08:00–10:00), with error rate at 18% vs. a 2% baseline and p95 latency at 1850ms vs. 320ms baseline."
+
+## Live Demo
+
+Reqly is running live against [EventFlow](https://eventflow-g2h5.onrender.com), a Flask event management app.
+
+- **Demo app** → [eventflow-g2h5.onrender.com](https://eventflow-g2h5.onrender.com)
+- **Metrics dashboard** → [reqly-eventflow-dashboard.onrender.com](https://reqly-eventflow-dashboard.onrender.com)
+
+> Login as **Administrator** (`admin@eventhub.com` / `Admin@123`) → click **Metrics** in the nav.
+
+## Configuration
+
+Every option can be passed as a kwarg to `instrument()` or set via environment variable.  
+Resolution order: **kwarg → env var → default**.
+
+| kwarg | env var | default |
+|---|---|---|
+| `service_name` | `REQLY_SERVICE_NAME` | `sys.argv[0]` basename |
+| `collector_url` | `REQLY_COLLECTOR_URL` | `http://localhost:8000` |
+| `api_key` | `REQLY_API_KEY` | `None` |
+| `sample_rate` | `REQLY_SAMPLE_RATE` | `1.0` |
+| `flush_interval_seconds` | `REQLY_FLUSH_INTERVAL_SECONDS` | `5.0` |
+| `max_batch_size` | `REQLY_MAX_BATCH_SIZE` | `200` |
+| `max_queue_size` | `REQLY_MAX_QUEUE_SIZE` | `2000` |
+| `ignore_routes` | `REQLY_IGNORE_ROUTES` (comma-separated) | `/health,/metrics` |
+| `capture_request_body` | `REQLY_CAPTURE_REQUEST_BODY` | `False` |
+
+## Design guarantees
+
+**Fail-open** — any internal SDK error is caught and logged once; instrumentation disables itself rather than raise into your app. A slow or unreachable collector never blocks request threads — all shipping happens on a background thread with strict HTTP timeouts.
+
+**Bounded cardinality** — routes are captured as the framework's matched template (`/users/{id}`), never the raw path (`/users/123`). Unmatched paths collapse into a single `__unmatched__` bucket.
+
+**Bounded memory** — events are held in a fixed-size in-memory queue; under backpressure, oldest events are dropped and counted rather than growing unbounded.
+
+## Self-hosting
+
+Reqly is fully self-hostable. Run the full stack (collector + TimescaleDB + dashboard) with Docker Compose:
+
+```bash
+git clone https://github.com/tanisheesh/reqly.git
+cd reqly
+docker compose up -d
+```
+
+See the [repository](https://github.com/tanisheesh/reqly) and [CONTRIBUTING.md](https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md) for full setup instructions.
+
+## License
+
+GPL-3.0-or-later — see [LICENSE](https://github.com/tanisheesh/reqly/blob/main/LICENSE).

reqly-0.1.0/PKG-INFO

@@ -1,99 +0,0 @@
-Metadata-Version: 2.4
-Name: reqly
-Version: 0.1.0
-Summary: Auto-instrumentation SDK for FastAPI and Flask: zero-code latency, error rates, and status codes shipped to a Reqly collector.
-Author: reqly
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/tanisheesh/reqly
-Project-URL: Repository, https://github.com/tanisheesh/reqly
-Project-URL: Issues, https://github.com/tanisheesh/reqly/issues
-Project-URL: Documentation, https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md
-Keywords: observability,apm,monitoring,fastapi,flask,telemetry,metrics,latency,tracing
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Monitoring
-Classifier: Framework :: FastAPI
-Classifier: Framework :: Flask
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: httpx<1.0,>=0.27
-Provides-Extra: fastapi
-Requires-Dist: fastapi>=0.100; extra == "fastapi"
-Provides-Extra: flask
-Requires-Dist: flask>=2.3; extra == "flask"
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: fastapi>=0.100; extra == "dev"
-Requires-Dist: flask>=2.3; extra == "dev"
-Requires-Dist: httpx>=0.27; extra == "dev"
-
-# Reqly
-
-Auto-instrumentation SDK for FastAPI and Flask. One line captures latency, status codes, and error rates for every request and ships them to an [Reqly collector](../collector).
-
-## Install
-
-```bash
-pip install reqly
-```
-
-(For local development against this monorepo: `pip install -e ./sdk[dev]`.)
-
-## Usage
-
-```python
-from fastapi import FastAPI
-import reqly
-
-app = FastAPI()
-reqly.instrument(app, service_name="checkout-api")
-```
-
-```python
-from flask import Flask
-import reqly
-
-app = Flask(__name__)
-reqly.instrument(app, service_name="checkout-api")
-```
-
-`instrument()` auto-detects FastAPI vs Flask — no other code changes needed.
-
-## Configuration
-
-Every option can be passed as a kwarg to `instrument()` or set via environment variable. Resolution order: kwarg > env var > default.
-
-| kwarg | env var | default |
-|---|---|---|
-| `service_name` | `REQLY_SERVICE_NAME` | `sys.argv[0]` basename |
-| `collector_url` | `REQLY_COLLECTOR_URL` | `http://localhost:8000` |
-| `api_key` | `REQLY_API_KEY` | `None` |
-| `sample_rate` | `REQLY_SAMPLE_RATE` | `1.0` |
-| `flush_interval_seconds` | `REQLY_FLUSH_INTERVAL_SECONDS` | `5.0` |
-| `max_batch_size` | `REQLY_MAX_BATCH_SIZE` | `200` |
-| `max_queue_size` | `REQLY_MAX_QUEUE_SIZE` | `2000` |
-| `ignore_routes` | `REQLY_IGNORE_ROUTES` (comma-separated) | `/health,/metrics` |
-| `capture_request_body` | `REQLY_CAPTURE_REQUEST_BODY` | `False` |
-
-## Design guarantees
-
-- **Fails open.** Any internal SDK error is caught and logged once; instrumentation then disables itself rather than risk repeatedly raising into your app. A slow or unreachable collector never slows down your app — all shipping happens off a background thread with strict per-phase HTTP timeouts.
-- **Bounded cardinality.** Captured routes are the framework's matched route *template* (`/users/{id}`), never the raw path (`/users/123`). Unmatched paths (404s, scanners) collapse into a single `__unmatched__` bucket instead of blowing up cardinality.
-- **Bounded memory.** Events are held in a fixed-size in-memory queue; under sustained backpressure, the oldest events are dropped (and counted) rather than growing unbounded or blocking request threads.
-
-## Architecture
-
-See [`../ARCHITECTURE.md`](../ARCHITECTURE.md#2-sdk-design) for the full design rationale (why pure ASGI middleware over `BaseHTTPMiddleware`, why a background thread over `asyncio.create_task`, why `httpx` over `requests`, etc).
-
-## Running tests
-
-```bash
-pip install -e .[dev]
-pytest
-```

reqly-0.1.0/README.md

@@ -1,64 +0,0 @@
-# Reqly
-
-Auto-instrumentation SDK for FastAPI and Flask. One line captures latency, status codes, and error rates for every request and ships them to an [Reqly collector](../collector).
-
-## Install
-
-```bash
-pip install reqly
-```
-
-(For local development against this monorepo: `pip install -e ./sdk[dev]`.)
-
-## Usage
-
-```python
-from fastapi import FastAPI
-import reqly
-
-app = FastAPI()
-reqly.instrument(app, service_name="checkout-api")
-```
-
-```python
-from flask import Flask
-import reqly
-
-app = Flask(__name__)
-reqly.instrument(app, service_name="checkout-api")
-```
-
-`instrument()` auto-detects FastAPI vs Flask — no other code changes needed.
-
-## Configuration
-
-Every option can be passed as a kwarg to `instrument()` or set via environment variable. Resolution order: kwarg > env var > default.
-
-| kwarg | env var | default |
-|---|---|---|
-| `service_name` | `REQLY_SERVICE_NAME` | `sys.argv[0]` basename |
-| `collector_url` | `REQLY_COLLECTOR_URL` | `http://localhost:8000` |
-| `api_key` | `REQLY_API_KEY` | `None` |
-| `sample_rate` | `REQLY_SAMPLE_RATE` | `1.0` |
-| `flush_interval_seconds` | `REQLY_FLUSH_INTERVAL_SECONDS` | `5.0` |
-| `max_batch_size` | `REQLY_MAX_BATCH_SIZE` | `200` |
-| `max_queue_size` | `REQLY_MAX_QUEUE_SIZE` | `2000` |
-| `ignore_routes` | `REQLY_IGNORE_ROUTES` (comma-separated) | `/health,/metrics` |
-| `capture_request_body` | `REQLY_CAPTURE_REQUEST_BODY` | `False` |
-
-## Design guarantees
-
-- **Fails open.** Any internal SDK error is caught and logged once; instrumentation then disables itself rather than risk repeatedly raising into your app. A slow or unreachable collector never slows down your app — all shipping happens off a background thread with strict per-phase HTTP timeouts.
-- **Bounded cardinality.** Captured routes are the framework's matched route *template* (`/users/{id}`), never the raw path (`/users/123`). Unmatched paths (404s, scanners) collapse into a single `__unmatched__` bucket instead of blowing up cardinality.
-- **Bounded memory.** Events are held in a fixed-size in-memory queue; under sustained backpressure, the oldest events are dropped (and counted) rather than growing unbounded or blocking request threads.
-
-## Architecture
-
-See [`../ARCHITECTURE.md`](../ARCHITECTURE.md#2-sdk-design) for the full design rationale (why pure ASGI middleware over `BaseHTTPMiddleware`, why a background thread over `asyncio.create_task`, why `httpx` over `requests`, etc).
-
-## Running tests
-
-```bash
-pip install -e .[dev]
-pytest
-```

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

@@ -1,99 +0,0 @@
-Metadata-Version: 2.4
-Name: reqly
-Version: 0.1.0
-Summary: Auto-instrumentation SDK for FastAPI and Flask: zero-code latency, error rates, and status codes shipped to a Reqly collector.
-Author: reqly
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/tanisheesh/reqly
-Project-URL: Repository, https://github.com/tanisheesh/reqly
-Project-URL: Issues, https://github.com/tanisheesh/reqly/issues
-Project-URL: Documentation, https://github.com/tanisheesh/reqly/blob/main/CONTRIBUTING.md
-Keywords: observability,apm,monitoring,fastapi,flask,telemetry,metrics,latency,tracing
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Monitoring
-Classifier: Framework :: FastAPI
-Classifier: Framework :: Flask
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: httpx<1.0,>=0.27
-Provides-Extra: fastapi
-Requires-Dist: fastapi>=0.100; extra == "fastapi"
-Provides-Extra: flask
-Requires-Dist: flask>=2.3; extra == "flask"
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: fastapi>=0.100; extra == "dev"
-Requires-Dist: flask>=2.3; extra == "dev"
-Requires-Dist: httpx>=0.27; extra == "dev"
-
-# Reqly
-
-Auto-instrumentation SDK for FastAPI and Flask. One line captures latency, status codes, and error rates for every request and ships them to an [Reqly collector](../collector).
-
-## Install
-
-```bash
-pip install reqly
-```
-
-(For local development against this monorepo: `pip install -e ./sdk[dev]`.)
-
-## Usage
-
-```python
-from fastapi import FastAPI
-import reqly
-
-app = FastAPI()
-reqly.instrument(app, service_name="checkout-api")
-```
-
-```python
-from flask import Flask
-import reqly
-
-app = Flask(__name__)
-reqly.instrument(app, service_name="checkout-api")
-```
-
-`instrument()` auto-detects FastAPI vs Flask — no other code changes needed.
-
-## Configuration
-
-Every option can be passed as a kwarg to `instrument()` or set via environment variable. Resolution order: kwarg > env var > default.
-
-| kwarg | env var | default |
-|---|---|---|
-| `service_name` | `REQLY_SERVICE_NAME` | `sys.argv[0]` basename |
-| `collector_url` | `REQLY_COLLECTOR_URL` | `http://localhost:8000` |
-| `api_key` | `REQLY_API_KEY` | `None` |
-| `sample_rate` | `REQLY_SAMPLE_RATE` | `1.0` |
-| `flush_interval_seconds` | `REQLY_FLUSH_INTERVAL_SECONDS` | `5.0` |
-| `max_batch_size` | `REQLY_MAX_BATCH_SIZE` | `200` |
-| `max_queue_size` | `REQLY_MAX_QUEUE_SIZE` | `2000` |
-| `ignore_routes` | `REQLY_IGNORE_ROUTES` (comma-separated) | `/health,/metrics` |
-| `capture_request_body` | `REQLY_CAPTURE_REQUEST_BODY` | `False` |
-
-## Design guarantees
-
-- **Fails open.** Any internal SDK error is caught and logged once; instrumentation then disables itself rather than risk repeatedly raising into your app. A slow or unreachable collector never slows down your app — all shipping happens off a background thread with strict per-phase HTTP timeouts.
-- **Bounded cardinality.** Captured routes are the framework's matched route *template* (`/users/{id}`), never the raw path (`/users/123`). Unmatched paths (404s, scanners) collapse into a single `__unmatched__` bucket instead of blowing up cardinality.
-- **Bounded memory.** Events are held in a fixed-size in-memory queue; under sustained backpressure, the oldest events are dropped (and counted) rather than growing unbounded or blocking request threads.
-
-## Architecture
-
-See [`../ARCHITECTURE.md`](../ARCHITECTURE.md#2-sdk-design) for the full design rationale (why pure ASGI middleware over `BaseHTTPMiddleware`, why a background thread over `asyncio.create_task`, why `httpx` over `requests`, etc).
-
-## Running tests
-
-```bash
-pip install -e .[dev]
-pytest
-```