elven-logs-interceptor-python 0.1.2__tar.gz → 0.1.3__tar.gz

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elven-logs-interceptor-python
-Version: 0.1.2
+Version: 0.1.3
 Summary: Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations.
 Author: Elven Observability
 License: MIT

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elven-logs-interceptor-python"
-version = "0.1.2"
+version = "0.1.3"
 description = "Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations."
 readme = "README.md"
 requires-python = ">=3.10"

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/src/logs_interceptor/application/log_service.py

@@ -22,11 +22,11 @@ try:
 except Exception:  # pragma: no cover
     pass
 
-otel_trace: Any = None
 try:
-    from opentelemetry import trace as otel_trace
+    from opentelemetry import trace as _otel_trace  # type: ignore[import-not-found]
 except Exception:  # pragma: no cover - optional dependency
-    pass
+    _otel_trace = None
+otel_trace: Any = _otel_trace
 
 
 @dataclass(slots=True)

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/src/logs_interceptor/infrastructure/buffer/memory_buffer.py

@@ -165,12 +165,16 @@ class MemoryBuffer:
             return
 
         def _on_timer() -> None:
+            callback: Callable[[], None] | None = None
             with self._lock:
                 self._flush_timer = None
                 if self._destroyed:
                     return
                 if self._flush_callback and self._entries:
-                    self._flush_callback()
+                    callback = self._flush_callback
+
+            if callback is not None:
+                callback()
 
         self._flush_timer = threading.Timer(self._config.flush_interval / 1000, _on_timer)
         self._flush_timer.daemon = True

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/src/logs_interceptor/infrastructure/transport/loki_json_transport.py

@@ -88,7 +88,7 @@ class LokiJsonTransport:
             headers: dict[str, str] = {
                 "Content-Type": "application/json",
                 "X-Scope-OrgID": self._config.tenant_id,
-                "User-Agent": "elven-logs-interceptor-python/0.1.2",
+                "User-Agent": "elven-logs-interceptor-python/0.1.3",
                 **self._extra_headers,
             }
             if self._config.auth_token:

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/src/logs_interceptor/infrastructure/transport/loki_protobuf_transport.py

@@ -94,7 +94,7 @@ class LokiProtobufTransport:
                 "Content-Type": "application/x-protobuf",
                 "Content-Encoding": "snappy",
                 "X-Scope-OrgID": self._config.tenant_id,
-                "User-Agent": "elven-logs-interceptor-python/0.1.2",
+                "User-Agent": "elven-logs-interceptor-python/0.1.3",
                 **self._extra_headers,
             }
             if self._config.auth_token:

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/src/logs_interceptor/presentation/factory.py

@@ -15,11 +15,11 @@ from ..infrastructure.filter import LogFilter
 from ..infrastructure.interceptors import RuntimeInterceptor
 from ..infrastructure.transport import TransportFactory
 
-otel_trace: Any = None
 try:
-    from opentelemetry import trace as otel_trace
+    from opentelemetry import trace as _otel_trace  # type: ignore[import-not-found]
 except Exception:  # pragma: no cover - optional dependency
-    pass
+    _otel_trace = None
+otel_trace: Any = _otel_trace
 
 
 @dataclass(slots=True)

elven_logs_interceptor_python-0.1.3/test-apps/elven-live-demo/.env.example

@@ -0,0 +1,49 @@
+LOGS_URL=https://loki.elvenobservability.com/loki/api/v1/push
+LOGS_TENANT=elven
+LOGS_TOKEN=replace-with-your-token
+LOGS_APP_NAME=elven-live-demo
+LOGS_APP_VERSION=1.0.0
+LOGS_ENVIRONMENT=local
+
+LOGS_COMPRESSION=gzip
+LOGS_COMPRESSION_LEVEL=4
+LOGS_COMPRESSION_THRESHOLD=1024
+LOGS_CONNECTION_POOLING=true
+LOGS_MAX_SOCKETS=50
+LOGS_TIMEOUT=10000
+LOGS_MAX_RETRIES=3
+LOGS_RETRY_DELAY=1000
+
+LOGS_BUFFER_MAX_SIZE=25
+LOGS_BUFFER_FLUSH_INTERVAL=1500
+LOGS_BUFFER_MAX_MEMORY_MB=128
+LOGS_BUFFER_MAX_AGE=30000
+LOGS_BUFFER_AUTO_FLUSH=true
+
+LOGS_FILTER_LEVELS=debug,info,warn,error,fatal
+LOGS_FILTER_SAMPLING_RATE=1.0
+LOGS_FILTER_SANITIZE=true
+LOGS_FILTER_MAX_MESSAGE_LENGTH=8192
+
+LOGS_CIRCUIT_BREAKER_ENABLED=true
+LOGS_CIRCUIT_BREAKER_FAILURE_THRESHOLD=20
+LOGS_CIRCUIT_BREAKER_RESET_TIMEOUT=15000
+LOGS_CIRCUIT_BREAKER_HALF_OPEN_REQUESTS=3
+
+LOGS_DLQ_ENABLED=true
+LOGS_DLQ_TYPE=file
+LOGS_DLQ_MAX_SIZE=1000
+LOGS_DLQ_MAX_RETRIES=3
+LOGS_DLQ_BASE_PATH=./.logs-dlq
+
+LOGS_MAX_CONCURRENT_FLUSHES=5
+LOGS_INTERCEPT_CONSOLE=true
+LOGS_PRESERVE_ORIGINAL_CONSOLE=true
+LOGS_ENABLE_METRICS=true
+LOGS_ENABLE_HEALTH_CHECK=true
+LOGS_DEBUG=false
+LOGS_SILENT_ERRORS=false
+LOGS_ENABLED=true
+
+LOGS_LABEL_SERVICE=elven-live-demo
+LOGS_LABEL_ENVIRONMENT=local

elven_logs_interceptor_python-0.1.3/test-apps/elven-live-demo/README.md

@@ -0,0 +1,17 @@
+# Elven Live Demo
+
+Local Python app to exercise `elven-logs-interceptor-python` against the Elven Loki endpoint.
+
+## Run
+
+```bash
+cd /Users/leonardozwirtes/Documents/Projects/logs-interceptor-python
+chmod +x test-apps/elven-live-demo/run.sh
+./test-apps/elven-live-demo/run.sh
+```
+
+## Notes
+
+- The tracked config template is `.env.example`.
+- The real token lives only in local `.env`, which is ignored by Git.
+- The package import remains `logs_interceptor`.

elven_logs_interceptor_python-0.1.3/test-apps/elven-live-demo/app.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import asyncio
+import random
+import time
+
+from logs_interceptor import destroy, init, logger
+
+
+def emit_startup_logs() -> None:
+    logger.info("demo app started", {"component": "startup"})
+    logger.track_event("demo_started", {"source": "local-run", "at": time.time()})
+
+
+def emit_business_logs() -> None:
+    for idx in range(10):
+        logger.info(
+            "processing item",
+            {
+                "idx": idx,
+                "value": random.randint(100, 999),
+                "duration_ms": round(random.uniform(5, 30), 2),
+            },
+        )
+
+    logger.warn("slow dependency detected", {"dependency": "inventory-service", "latency_ms": 187})
+
+    try:
+        raise RuntimeError("simulated business exception")
+    except RuntimeError as exc:
+        logger.error(
+            "handled domain error",
+            {
+                "error": str(exc),
+                "kind": "business",
+            },
+        )
+
+
+def emit_sync_context_logs() -> None:
+    def _run() -> None:
+        logger.info("sync request started", {"method": "GET", "path": "/products"})
+        print("plain print still works and is intercepted")
+
+    logger.with_context(
+        {
+            "request_id": "demo-sync-request-1",
+            "trace_id": "demo-sync-trace-1",
+            "span_id": "demo-sync-span-1",
+        },
+        _run,
+    )
+
+
+async def emit_async_context_logs() -> None:
+    async def _run() -> None:
+        logger.info("async job started", {"job": "catalog-refresh"})
+        await asyncio.sleep(0.05)
+        logger.track_event("catalog_refresh_finished", {"ok": True})
+
+    await logger.with_context_async(
+        {
+            "request_id": "demo-async-request-1",
+            "trace_id": "demo-async-trace-1",
+            "span_id": "demo-async-span-1",
+        },
+        _run,
+    )
+
+
+def print_runtime_summary() -> None:
+    metrics = logger.get_metrics()
+    health = logger.get_health()
+    print(
+        {
+            "processed": metrics.get("logs_processed"),
+            "dropped": metrics.get("logs_dropped"),
+            "flush_count": metrics.get("flush_count"),
+            "error_count": metrics.get("error_count"),
+        }
+    )
+    print({"health": health})
+
+
+def main() -> None:
+    init()
+    emit_startup_logs()
+    emit_business_logs()
+    emit_sync_context_logs()
+    asyncio.run(emit_async_context_logs())
+    logger.flush()
+    print_runtime_summary()
+    destroy()
+
+
+if __name__ == "__main__":
+    main()

elven_logs_interceptor_python-0.1.3/test-apps/elven-observability-smoke/run.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+if [[ ! -f "${SCRIPT_DIR}/.env" ]]; then
+  echo "Missing .env at ${SCRIPT_DIR}/.env" >&2
+  if [[ -f "${SCRIPT_DIR}/.env.example" ]]; then
+    echo "Create it with: cp ${SCRIPT_DIR}/.env.example ${SCRIPT_DIR}/.env" >&2
+  fi
+  exit 1
+fi
+
+set -a
+source "${SCRIPT_DIR}/.env"
+set +a
+
+export PYTHONPATH="${ROOT_DIR}/src:${PYTHONPATH:-}"
+
+python3 "${SCRIPT_DIR}/app.py"

{elven_logs_interceptor_python-0.1.2 → elven_logs_interceptor_python-0.1.3}/tests/unit/test_memory_buffer_extra.py

@@ -106,6 +106,33 @@ def test_schedule_flush_callback_runs_with_entries() -> None:
     buffer.destroy()
 
 
+def test_schedule_flush_callback_does_not_hold_buffer_lock() -> None:
+    callback_started = threading.Event()
+    release_callback = threading.Event()
+    add_completed = threading.Event()
+    buffer = _buffer(flush_interval=5, auto_flush=True)
+
+    def flush_callback() -> None:
+        callback_started.set()
+        release_callback.wait(timeout=1)
+
+    buffer.set_flush_callback(flush_callback)
+    buffer.add(_entry("1", "2026-01-01T00:00:00+00:00"))
+    assert callback_started.wait(timeout=1)
+
+    def add_entry() -> None:
+        buffer.add(_entry("2", "2026-01-01T00:00:01+00:00"))
+        add_completed.set()
+
+    add_thread = threading.Thread(target=add_entry)
+    add_thread.start()
+    assert add_completed.wait(timeout=0.2)
+
+    release_callback.set()
+    add_thread.join(timeout=1)
+    buffer.destroy()
+
+
 def test_schedule_flush_destroyed_guard_inside_timer() -> None:
     event = threading.Event()
     buffer = _buffer(flush_interval=40, auto_flush=False)