devlite 0.1.2__tar.gz → 0.1.4__tar.gz

{devlite-0.1.2 → devlite-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlite
-Version: 0.1.2
+Version: 0.1.4
 Summary: DevLite Python SDK — AI-powered observability with a 2-line integration. Automatic error grouping, source context, user impact tracking, and sensitive-data scrubbing built in.
 License: MIT
 Project-URL: Homepage, https://devlite.io

{devlite-0.1.2 → devlite-0.1.4}/devlite/__init__.py

@@ -1,159 +1,167 @@
-"""DevLite Python SDK — AI-powered observability with a 2-line integration.
-
-    import devlite
-
-    devlite.init({api_key: "dl_live_xxxxx"})
-
-Automatic request tracking, error grouping, source context, user impact
-tracking, and sensitive-data scrubbing — mirroring the @devlite/nodejs npm
-SDK, with zero runtime dependencies.
-
-Public API (all Pythonic snake_case):
-    init, capture_error, capture_message, report_metric, capture_log,
-    start_span, report_span, report_deployment, add_breadcrumb, set_tag,
-    set_user, run_with_context, start_host_metrics, instrument_flask,
-    instrument_fastapi, instrument_django, flush, close
-"""
-
-from ._client import Client, HostMetricsHandle, Span
-from ._context import run_with_context
-
-__version__ = "0.1.1"
-
-_client = None
-
-
-def init(options=None):
-    """Initialize DevLite. The only required call.
-
-    Args:
-        options: dict with keys like api_key, environment, service_name,
-            release, sample_rate, gzip, debug, endpoint, on_error, ...
-            `api_key` is required (or set DEVLITE_API_KEY env var).
-    """
-    global _client
-    if _client is not None:
-        import warnings
-
-        warnings.warn("[DevLite] init() called more than once — ignoring subsequent call.")
-        return
-    _client = Client(options or {})
-
-
-def _require_client():
-    if _client is None:
-        raise RuntimeError("[DevLite] SDK not initialized. Call devlite.init(api_key=...) first.")
-    return _client
-
-
-def capture_error(error, extra=None):
-    """Capture a handled error with optional extra context."""
-    _require_client().capture_error(error, extra=extra)
-
-
-def capture_message(message, level="info", extra=None):
-    """Capture a non-error event, e.g. a business-logic message."""
-    _require_client().capture_message(message, level=level, extra=extra)
-
-
-def report_metric(name, value, unit=None, tags=None):
-    """Report a metric data point (feeds forecasting/anomaly detection)."""
-    _require_client().report_metric(name, value, unit=unit, tags=tags)
-
-
-def capture_log(message, level="info", fields=None):
-    """Capture a structured log line with arbitrary fields."""
-    _require_client().capture_log(message, level=level, fields=fields)
-
-
-def start_span(name, options=None):
-    """Start a trace span; returns an object with id/trace_id and end(status)."""
-    return _require_client().start_span(name, options=options)
-
-
-def report_span(name, trace_id=None, parent_id=None, tags=None, start_time=None, end_time=None, duration_ms=None, status="ok"):
-    """Report a finished span if you track timing yourself."""
-    _require_client().report_span(
-        name,
-        trace_id=trace_id,
-        parent_id=parent_id,
-        tags=tags,
-        start_time=start_time,
-        end_time=end_time,
-        duration_ms=duration_ms,
-        status=status,
-    )
-
-
-def report_deployment(version=None, commit_sha=None, notes=None):
-    """Report a deployment — powers performance before/after deployment views."""
-    _require_client().report_deployment(version=version, commit_sha=commit_sha, notes=notes)
-
-
-def add_breadcrumb(entry):
-    """Add a manual breadcrumb (e.g. 'user started checkout') for richer AI context."""
-    _require_client().add_breadcrumb(entry)
-
-
-def set_tag(key, value):
-    """Tag all subsequent events, e.g. set_tag('region', 'lagos')."""
-    _require_client().set_tag(key, value)
-
-
-def set_user(user):
-    """Identify the user for the CURRENT request (scoped to the request)."""
-    _require_client().set_user(user)
-
-
-def start_host_metrics(interval_ms=15000):
-    """Start sampling host CPU/memory (plus network/disk on Linux) as metrics."""
-    return _require_client().start_host_metrics(interval_ms=interval_ms)
-
-
-def instrument_flask(app):
-    """Wire automatic request/error/user tracking into a Flask app."""
-    return _require_client().instrument_flask(app)
-
-
-def instrument_fastapi(app):
-    """Wire automatic request/error/user tracking into a FastAPI app."""
-    return _require_client().instrument_fastapi(app)
-
-
-def instrument_django():
-    """Insert DevLite's middleware at the top of Django's MIDDLEWARE setting."""
-    return _require_client().instrument_django()
-
-
-def flush():
-    """Force-send whatever is currently queued (useful in serverless)."""
-    _require_client().flush()
-
-
-def close():
-    """Cleanly stop the SDK — flushes remaining events."""
-    if _client is not None:
-        _client.close()
-
-
-__all__ = [
-    "__version__",
-    "init",
-    "capture_error",
-    "capture_message",
-    "report_metric",
-    "capture_log",
-    "start_span",
-    "report_span",
-    "report_deployment",
-    "add_breadcrumb",
-    "set_tag",
-    "set_user",
-    "run_with_context",
-    "start_host_metrics",
-    "instrument_flask",
-    "instrument_fastapi",
-    "instrument_django",
-    "flush",
-    "close",
-]
+"""DevLite Python SDK — AI-powered observability with a 2-line integration.
+
+    import devlite
+
+    devlite.init(api_key="dl_live_xxxxx")
+
+Automatic request tracking, error grouping, source context, user impact
+tracking, and sensitive-data scrubbing — mirroring the @devlite/nodejs npm
+SDK, with zero runtime dependencies.
+
+Public API (all Pythonic snake_case):
+    init, capture_error, capture_message, report_metric, capture_log,
+    start_span, report_span, report_deployment, add_breadcrumb, set_tag,
+    set_user, run_with_context, start_host_metrics, instrument_flask,
+    instrument_fastapi, instrument_django, flush, close
+"""
+
+from ._client import Client, HostMetricsHandle, Span
+from ._context import run_with_context
+
+__version__ = "0.1.4"
+
+_client = None
+
+
+def init(options=None, **kwargs):
+    """Initialize DevLite. The only required call.
+
+    Accepts either a dict (`init({"api_key": "..."})`) or keyword
+    arguments (`init(api_key="...")`); kwargs take precedence when both
+    are passed.
+
+    Args:
+        options: dict with keys like api_key, environment, service_name,
+            release, sample_rate, gzip, debug, endpoint, on_error, ...
+        **kwargs: the same options passed as keyword arguments.
+            `api_key` is required (or set DEVLITE_API_KEY env var).
+    """
+    global _client
+    if _client is not None:
+        import warnings
+
+        warnings.warn("[DevLite] init() called more than once — ignoring subsequent call.")
+        return
+    opts = dict(options or {})
+    if kwargs:
+        opts.update(kwargs)
+    _client = Client(opts or {})
+
+
+def _require_client():
+    if _client is None:
+        raise RuntimeError("[DevLite] SDK not initialized. Call devlite.init(api_key=...) first.")
+    return _client
+
+
+def capture_error(error, extra=None):
+    """Capture a handled error with optional extra context."""
+    _require_client().capture_error(error, extra=extra)
+
+
+def capture_message(message, level="info", extra=None):
+    """Capture a non-error event, e.g. a business-logic message."""
+    _require_client().capture_message(message, level=level, extra=extra)
+
+
+def report_metric(name, value, unit=None, tags=None):
+    """Report a metric data point (feeds forecasting/anomaly detection)."""
+    _require_client().report_metric(name, value, unit=unit, tags=tags)
+
+
+def capture_log(message, level="info", fields=None):
+    """Capture a structured log line with arbitrary fields."""
+    _require_client().capture_log(message, level=level, fields=fields)
+
+
+def start_span(name, options=None):
+    """Start a trace span; returns an object with id/trace_id and end(status)."""
+    return _require_client().start_span(name, options=options)
+
+
+def report_span(name, trace_id=None, parent_id=None, tags=None, start_time=None, end_time=None, duration_ms=None, status="ok"):
+    """Report a finished span if you track timing yourself."""
+    _require_client().report_span(
+        name,
+        trace_id=trace_id,
+        parent_id=parent_id,
+        tags=tags,
+        start_time=start_time,
+        end_time=end_time,
+        duration_ms=duration_ms,
+        status=status,
+    )
+
+
+def report_deployment(version=None, commit_sha=None, notes=None):
+    """Report a deployment — powers performance before/after deployment views."""
+    _require_client().report_deployment(version=version, commit_sha=commit_sha, notes=notes)
+
+
+def add_breadcrumb(entry):
+    """Add a manual breadcrumb (e.g. 'user started checkout') for richer AI context."""
+    _require_client().add_breadcrumb(entry)
+
+
+def set_tag(key, value):
+    """Tag all subsequent events, e.g. set_tag('region', 'lagos')."""
+    _require_client().set_tag(key, value)
+
+
+def set_user(user):
+    """Identify the user for the CURRENT request (scoped to the request)."""
+    _require_client().set_user(user)
+
+
+def start_host_metrics(interval_ms=15000):
+    """Start sampling host CPU/memory (plus network/disk on Linux) as metrics."""
+    return _require_client().start_host_metrics(interval_ms=interval_ms)
+
+
+def instrument_flask(app):
+    """Wire automatic request/error/user tracking into a Flask app."""
+    return _require_client().instrument_flask(app)
+
+
+def instrument_fastapi(app):
+    """Wire automatic request/error/user tracking into a FastAPI app."""
+    return _require_client().instrument_fastapi(app)
+
+
+def instrument_django():
+    """Insert DevLite's middleware at the top of Django's MIDDLEWARE setting."""
+    return _require_client().instrument_django()
+
+
+def flush():
+    """Force-send whatever is currently queued (useful in serverless)."""
+    _require_client().flush()
+
+
+def close():
+    """Cleanly stop the SDK — flushes remaining events."""
+    if _client is not None:
+        _client.close()
+
+
+__all__ = [
+    "__version__",
+    "init",
+    "capture_error",
+    "capture_message",
+    "report_metric",
+    "capture_log",
+    "start_span",
+    "report_span",
+    "report_deployment",
+    "add_breadcrumb",
+    "set_tag",
+    "set_user",
+    "run_with_context",
+    "start_host_metrics",
+    "instrument_flask",
+    "instrument_fastapi",
+    "instrument_django",
+    "flush",
+    "close",
+]

{devlite-0.1.2 → devlite-0.1.4}/devlite/_context.py

@@ -14,6 +14,35 @@ MAX_BREADCRUMBS = 20
 _request_store = contextvars.ContextVar("devlite_request_store", default=None)
 
 
+class CoherentSampler:
+    """Bresenham-style coherent sampler for request telemetry.
+
+    Keeps almost exactly rate*N of N requests, evenly spaced, for any rate in
+    (0, 1). Each decision adds `rate` to a running accumulator and fires
+    "keep" whenever the accumulator crosses 1.0 (subtracting 1.0 afterward).
+    The previous `int(1.0 / rate)` counter+modulo scheme collapsed for any
+    rate in (0.5, 1.0) — 1.0/rate truncated to 1, so every request was kept.
+
+    Callers drive it from a single middleware/request path (not thread-safe).
+    """
+
+    def __init__(self, rate=1.0):
+        self.rate = rate
+        self._accum = 0.0
+
+    def decide(self):
+        rate = self.rate
+        if rate >= 1.0:
+            return True
+        if rate <= 0.0:
+            return False
+        self._accum += rate
+        if self._accum >= 1.0:
+            self._accum -= 1.0
+            return True
+        return False
+
+
 def new_trace_id():
     """A fresh 16-hex-char traceId (8 bytes), matching the Node SDK."""
     return secrets.token_hex(8)

{devlite-0.1.2 → devlite-0.1.4}/devlite/_django.py

@@ -14,7 +14,7 @@ this module never requires it — the import happens lazily in
 instrument_django().
 """
 
-from ._context import now_ms, reset_context
+from ._context import CoherentSampler, now_ms, reset_context
 
 SLOW_REQUEST_THRESHOLD_MS = 1000
 
@@ -42,22 +42,15 @@ class InstrumentDjangoMiddleware:
 
     def __init__(self, get_response):
         self.get_response = get_response
-        self.sample_rate = None
-        self.sample_every = None
-        self.counter = 0
+        self.sampler = None
 
     def _configure_sampling(self, config):
-        rate = float(config.get("sample_rate", 1.0))
-        self.sample_rate = rate
-        self.sample_every = 1.0 / rate if 0 < rate < 1.0 else None
+        self.sampler = CoherentSampler(float(config.get("sample_rate", 1.0)))
 
     def _sampled(self):
-        if self.sample_rate is None or self.sample_rate <= 0:
-            return False if self.sample_rate is not None else True
-        if self.sample_rate >= 1.0:
+        if self.sampler is None:
             return True
-        self.counter += 1
-        return self.counter % int(self.sample_every) == 0
+        return self.sampler.decide()
 
     def __call__(self, request):
         client = _active_client()
@@ -73,7 +66,7 @@ class InstrumentDjangoMiddleware:
 
         trace_id = new_trace_id()
         set_trace_id(trace_id)
-        if self.sample_rate is None:
+        if self.sampler is None:
             self._configure_sampling(config)
         set_sampled(self._sampled())
 

{devlite-0.1.2 → devlite-0.1.4}/devlite/_fastapi.py

@@ -13,7 +13,7 @@ importing this module never requires them — the import happens lazily in
 instrument_fastapi().
 """
 
-from ._context import now_ms, reset_context
+from ._context import CoherentSampler, now_ms, reset_context
 
 SLOW_REQUEST_THRESHOLD_MS = 1000
 
@@ -37,17 +37,10 @@ class _DevLiteASGIMiddleware:
         self.context = context
         self.config = config
         rate = float(config.get("sample_rate", 1.0))
-        self.sample_rate = rate
-        self.sample_every = 1.0 / rate if 0 < rate < 1.0 else None
-        self.counter = 0
+        self.sampler = CoherentSampler(rate)
 
     def _sampled(self):
-        if self.sample_rate <= 0:
-            return False
-        if self.sample_rate >= 1.0:
-            return True
-        self.counter += 1
-        return self.counter % int(self.sample_every) == 0
+        return self.sampler.decide()
 
     async def __call__(self, scope, receive, send):
         if scope["type"] != "http":

{devlite-0.1.2 → devlite-0.1.4}/devlite/_flask.py

@@ -15,7 +15,7 @@ instrument_flask().
 import time
 from contextvars import ContextVar
 
-from ._context import now_ms, reset_context
+from ._context import CoherentSampler, now_ms, reset_context
 
 _request_start = ContextVar("devlite_request_start", default=None)
 _request_meta = ContextVar("devlite_request_meta", default=None)
@@ -40,11 +40,7 @@ def instrument_flask(app, transport, context, config):
     redact_list = config.get("redact_headers", ["authorization", "cookie", "x-api-key"])
     capture_body = config.get("capture_body", False)
     sample_rate = float(config.get("sample_rate", 1.0))
-    sample_every = 1.0 / sample_rate if sample_rate > 0 else float("inf")
-
-    import random
-
-    counter = [0]
+    sampler = CoherentSampler(sample_rate)
 
     @app.before_request
     def _start():
@@ -53,9 +49,7 @@ def instrument_flask(app, transport, context, config):
 
         set_trace_id(new_trace_id())
         _record_start()
-        counter[0] += 1
-        sampled = sample_rate >= 1.0 or (counter[0] % int(sample_every) == 0)
-        set_sampled(sampled)
+        set_sampled(sampler.decide())
 
     @app.after_request
     def _finish(response):

{devlite-0.1.2 → devlite-0.1.4}/devlite/_transport.py

@@ -1,144 +1,144 @@
-"""Batch transport with retry/backoff and gzip — Python port of transport.js.
-
-Uses only the standard library (urllib), so the SDK has zero runtime
-dependencies. Batches events into {apiKey, service, environment, release,
-events[]} payloads and POSTs them to the DevLite ingest endpoint exactly
-like the Node SDK.
-"""
-
-import gzip
-import json
-import threading
-import time
-import urllib.error
-import urllib.request
-
-from ._queue import EventQueue
-
-COHERENT_SAMPLED_TYPES = {
-    "request",
-    "slow_request",
-    "error",
-    "message",
-    "metric",
-    "log",
-    "span",
-}
-
-
-def _json_default(obj):
-    return str(obj)
-
-
-class Transport:
-    def __init__(self, config):
-        self.config = config
-        self.queue = EventQueue(max_queue_size=config.get("max_queue_size", 5000))
-        self._lock = threading.Lock()
-        self._closed = False
-        self._flusher = None
-
-        if config.get("flush_interval_ms", 5000) > 0:
-            self._flusher = threading.Thread(
-                target=self._flusher_loop, daemon=True, name="devlite-transport"
-            )
-            self._flusher.start()
-
-    # --- public -----------------------------------------------------------
-
-    def enqueue(self, event):
-        if self._closed:
-            return
-        if event.get("type") in COHERENT_SAMPLED_TYPES:
-            from ._context import is_sampled_out
-
-            if is_sampled_out():
-                return
-        self.queue.push(event)
-        if self.queue.size >= self.config.get("max_batch_size", 100):
-            self.flush()
-
-    def flush(self):
-        if self._closed:
-            return
-        batch = self.queue.drain(self.config.get("max_batch_size", 100))
-        if not batch:
-            return
-        self._send_with_retry(batch)
-
-    def close(self):
-        self._closed = True
-        self.flush()
-
-    def _flusher_loop(self):
-        interval = self.config.get("flush_interval_ms", 5000) / 1000.0
-        while not self._closed:
-            time.sleep(interval)
-            try:
-                self.flush()
-            except Exception:
-                # never let background delivery kill the host process
-                pass
-
-    # --- internals --------------------------------------------------------
-
-    def _payload(self, batch):
-        return {
-            "apiKey": self.config["api_key"],
-            "service": self.config.get("service_name"),
-            "environment": self.config.get("environment"),
-            "release": self.config.get("release"),
-            "events": batch,
-        }
-
-    def _send_with_retry(self, batch, attempt=1):
-        try:
-            self._send(batch)
-        except Exception as err:  # noqa: BLE001
-            if attempt < self.config.get("max_retries", 3):
-                delay = self.config.get("retry_base_delay_ms", 500) * (2 ** (attempt - 1)) / 1000.0
-                time.sleep(delay)
-                self._send_with_retry(batch, attempt + 1)
-                return
-            self._handle_error(err, batch)
-
-    def _send(self, batch):
-        body = json.dumps(self._payload(batch), default=_json_default).encode("utf-8")
-        headers = {
-            "Content-Type": "application/json",
-            "User-Agent": self.config.get("user_agent", "devlite-python/0.1.1"),
-        }
-
-        # Marks this request as the SDK's own delivery so an instrumented
-        # ingest server never records it as app telemetry (feedback loop).
-        headers["X-DevLite-Transport"] = "1"
-
-        if self.config.get("gzip", True):
-            body = gzip.compress(body)
-            headers["Content-Encoding"] = "gzip"
-
-        req = urllib.request.Request(
-            self.config.get("endpoint"),
-            data=body,
-            headers=headers,
-            method="POST",
-        )
-        timeout = self.config.get("request_timeout_ms", 10000) / 1000.0
-        with urllib.request.urlopen(req, timeout=timeout) as resp:
-            if resp.status >= 400:
-                raise RuntimeError("DevLite ingest responded with status {}".format(resp.status))
-
-    def _handle_error(self, err, batch):
-        if self.config.get("debug"):
-            print(
-                "[DevLite] failed to send {} event(s) after {} attempts: {}".format(
-                    len(batch), self.config.get("max_retries", 3), err
-                )
-            )
-        on_error = self.config.get("on_error")
-        if callable(on_error):
-            try:
-                on_error(err)
-            except Exception:
-                # never let a user callback crash the SDK
-                pass
+"""Batch transport with retry/backoff and gzip — Python port of transport.js.
+
+Uses only the standard library (urllib), so the SDK has zero runtime
+dependencies. Batches events into {apiKey, service, environment, release,
+events[]} payloads and POSTs them to the DevLite ingest endpoint exactly
+like the Node SDK.
+"""
+
+import gzip
+import json
+import threading
+import time
+import urllib.error
+import urllib.request
+
+from ._queue import EventQueue
+
+COHERENT_SAMPLED_TYPES = {
+    "request",
+    "slow_request",
+    "error",
+    "message",
+    "metric",
+    "log",
+    "span",
+}
+
+
+def _json_default(obj):
+    return str(obj)
+
+
+class Transport:
+    def __init__(self, config):
+        self.config = config
+        self.queue = EventQueue(max_queue_size=config.get("max_queue_size", 5000))
+        self._lock = threading.Lock()
+        self._closed = False
+        self._flusher = None
+
+        if config.get("flush_interval_ms", 5000) > 0:
+            self._flusher = threading.Thread(
+                target=self._flusher_loop, daemon=True, name="devlite-transport"
+            )
+            self._flusher.start()
+
+    # --- public -----------------------------------------------------------
+
+    def enqueue(self, event):
+        if self._closed:
+            return
+        if event.get("type") in COHERENT_SAMPLED_TYPES:
+            from ._context import is_sampled_out
+
+            if is_sampled_out():
+                return
+        self.queue.push(event)
+        if self.queue.size >= self.config.get("max_batch_size", 100):
+            self.flush()
+
+    def flush(self):
+        if self._closed:
+            return
+        batch = self.queue.drain(self.config.get("max_batch_size", 100))
+        if not batch:
+            return
+        self._send_with_retry(batch)
+
+    def close(self):
+        self._closed = True
+        self.flush()
+
+    def _flusher_loop(self):
+        interval = self.config.get("flush_interval_ms", 5000) / 1000.0
+        while not self._closed:
+            time.sleep(interval)
+            try:
+                self.flush()
+            except Exception:
+                # never let background delivery kill the host process
+                pass
+
+    # --- internals --------------------------------------------------------
+
+    def _payload(self, batch):
+        return {
+            "apiKey": self.config["api_key"],
+            "service": self.config.get("service_name"),
+            "environment": self.config.get("environment"),
+            "release": self.config.get("release"),
+            "events": batch,
+        }
+
+    def _send_with_retry(self, batch, attempt=1):
+        try:
+            self._send(batch)
+        except Exception as err:  # noqa: BLE001
+            if attempt < self.config.get("max_retries", 3):
+                delay = self.config.get("retry_base_delay_ms", 500) * (2 ** (attempt - 1)) / 1000.0
+                time.sleep(delay)
+                self._send_with_retry(batch, attempt + 1)
+                return
+            self._handle_error(err, batch)
+
+    def _send(self, batch):
+        body = json.dumps(self._payload(batch), default=_json_default).encode("utf-8")
+        headers = {
+            "Content-Type": "application/json",
+            "User-Agent": self.config.get("user_agent", "devlite-python/0.1.4"),
+        }
+
+        # Marks this request as the SDK's own delivery so an instrumented
+        # ingest server never records it as app telemetry (feedback loop).
+        headers["X-DevLite-Transport"] = "1"
+
+        if self.config.get("gzip", True):
+            body = gzip.compress(body)
+            headers["Content-Encoding"] = "gzip"
+
+        req = urllib.request.Request(
+            self.config.get("endpoint"),
+            data=body,
+            headers=headers,
+            method="POST",
+        )
+        timeout = self.config.get("request_timeout_ms", 10000) / 1000.0
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            if resp.status >= 400:
+                raise RuntimeError("DevLite ingest responded with status {}".format(resp.status))
+
+    def _handle_error(self, err, batch):
+        if self.config.get("debug"):
+            print(
+                "[DevLite] failed to send {} event(s) after {} attempts: {}".format(
+                    len(batch), self.config.get("max_retries", 3), err
+                )
+            )
+        on_error = self.config.get("on_error")
+        if callable(on_error):
+            try:
+                on_error(err)
+            except Exception:
+                # never let a user callback crash the SDK
+                pass

{devlite-0.1.2 → devlite-0.1.4}/devlite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlite
-Version: 0.1.2
+Version: 0.1.4
 Summary: DevLite Python SDK — AI-powered observability with a 2-line integration. Automatic error grouping, source context, user impact tracking, and sensitive-data scrubbing built in.
 License: MIT
 Project-URL: Homepage, https://devlite.io

{devlite-0.1.2 → devlite-0.1.4}/devlite.egg-info/SOURCES.txt

@@ -23,5 +23,6 @@ tests/test_django.py
 tests/test_errors.py
 tests/test_fastapi.py
 tests/test_queue.py
+tests/test_sampling.py
 tests/test_scrub.py
 tests/test_transport.py

{devlite-0.1.2 → devlite-0.1.4}/pyproject.toml

@@ -1,37 +1,37 @@
-[build-system]
-requires = ["setuptools>=68"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "devlite"
-version = "0.1.2"
-description = "DevLite Python SDK — AI-powered observability with a 2-line integration. Automatic error grouping, source context, user impact tracking, and sensitive-data scrubbing built in."
-readme = "README.md"
-license = { text = "MIT" }
-requires-python = ">=3.9"
-keywords = ["observability", "monitoring", "apm", "error-tracking", "error-monitoring", "logging", "ai", "devlite"]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Topic :: Software Development :: Debuggers",
-    "Topic :: System :: Monitoring",
-]
-
-[project.urls]
-Homepage = "https://devlite.io"
-Repository = "https://github.com/Ishimwe-Kevin/devlite-app"
-
-[project.optional-dependencies]
-flask = ["flask>=2.0"]
-fastapi = ["fastapi>=0.100"]
-django = ["django>=4.0"]
-test = ["pytest", "flask>=2.0", "fastapi>=0.100", "django>=4.0", "httpx>=0.27"]
-
-[tool.setuptools]
-packages = ["devlite"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devlite"
+version = "0.1.4"
+description = "DevLite Python SDK — AI-powered observability with a 2-line integration. Automatic error grouping, source context, user impact tracking, and sensitive-data scrubbing built in."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+keywords = ["observability", "monitoring", "apm", "error-tracking", "error-monitoring", "logging", "ai", "devlite"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Debuggers",
+    "Topic :: System :: Monitoring",
+]
+
+[project.urls]
+Homepage = "https://devlite.io"
+Repository = "https://github.com/Ishimwe-Kevin/devlite-app"
+
+[project.optional-dependencies]
+flask = ["flask>=2.0"]
+fastapi = ["fastapi>=0.100"]
+django = ["django>=4.0"]
+test = ["pytest", "flask>=2.0", "fastapi>=0.100", "django>=4.0", "httpx>=0.27"]
+
+[tool.setuptools]
+packages = ["devlite"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

devlite-0.1.4/tests/test_sampling.py

@@ -0,0 +1,31 @@
+"""Coherent sampler accuracy tests.
+
+Regression for the collapse above 0.5: the old `int(1.0 / rate)` counter +
+modulo kept every request for any rate in (0.5, 1.0). The accumulator keeps
+~rate*N of N, evenly spaced, with error < 1 sample.
+"""
+
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from devlite._context import CoherentSampler  # noqa: E402
+
+
+def test_coherent_sampler_accuracy():
+    n = 100_000
+    rates = (0.1, 0.25, 0.5, 0.6, 0.7, 0.8, 0.9, 0.95, 0.99)
+    for rate in rates:
+        sampler = CoherentSampler(rate)
+        kept = sum(1 for _ in range(n) if sampler.decide())
+        want = n * rate
+        tol = n * 0.0001  # far looser than the true <1-sample error
+        assert abs(kept - want) <= tol, f"rate {rate}: kept {kept}/{n}, want ~{want:.1f}"
+
+
+def test_coherent_sampler_boundaries():
+    assert not CoherentSampler(0.0).decide()
+    assert not CoherentSampler(-0.5).decide()
+    assert CoherentSampler(1.0).decide()
+    assert CoherentSampler(2.0).decide()