elven-logs-interceptor-python 0.1.9__tar.gz → 0.1.10__tar.gz

{elven_logs_interceptor_python-0.1.9 → elven_logs_interceptor_python-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elven-logs-interceptor-python
-Version: 0.1.9
+Version: 0.1.10
 Summary: Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations.
 Author: Elven Observability
 License: MIT
@@ -14,20 +14,20 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: System :: Logging
 Requires-Python: >=3.10
-Requires-Dist: httpx>=0.27.0
+Requires-Dist: httpx<0.29.0,>=0.24.1
 Requires-Dist: typing-extensions>=4.12.0
 Provides-Extra: all
 Requires-Dist: brotli>=1.1.0; extra == 'all'
 Requires-Dist: celery>=5.4.0; extra == 'all'
 Requires-Dist: django>=4.2; extra == 'all'
-Requires-Dist: fastapi>=0.111.0; extra == 'all'
+Requires-Dist: fastapi>=0.100.0; extra == 'all'
 Requires-Dist: flask>=3.0.0; extra == 'all'
 Requires-Dist: loguru>=0.7.2; extra == 'all'
 Requires-Dist: opentelemetry-api>=1.24.0; extra == 'all'
 Requires-Dist: orjson>=3.10.0; extra == 'all'
 Requires-Dist: protobuf>=5.0.0; extra == 'all'
 Requires-Dist: python-snappy>=0.7.1; extra == 'all'
-Requires-Dist: starlette>=0.37.0; extra == 'all'
+Requires-Dist: starlette>=0.27.0; extra == 'all'
 Requires-Dist: structlog>=24.0.0; extra == 'all'
 Provides-Extra: celery
 Requires-Dist: celery>=5.4.0; extra == 'celery'
@@ -42,8 +42,8 @@ Requires-Dist: twine>=5.1.1; extra == 'dev'
 Provides-Extra: django
 Requires-Dist: django>=4.2; extra == 'django'
 Provides-Extra: fastapi
-Requires-Dist: fastapi>=0.111.0; extra == 'fastapi'
-Requires-Dist: starlette>=0.37.0; extra == 'fastapi'
+Requires-Dist: fastapi>=0.100.0; extra == 'fastapi'
+Requires-Dist: starlette>=0.27.0; extra == 'fastapi'
 Provides-Extra: flask
 Requires-Dist: flask>=3.0.0; extra == 'flask'
 Provides-Extra: loguru

{elven_logs_interceptor_python-0.1.9 → elven_logs_interceptor_python-0.1.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elven-logs-interceptor-python"
-version = "0.1.9"
+version = "0.1.10"
 description = "Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -32,7 +32,7 @@ classifiers = [
   "Topic :: System :: Logging",
 ]
 dependencies = [
-  "httpx>=0.27.0",
+  "httpx>=0.24.1,<0.29.0",
   "typing-extensions>=4.12.0",
 ]
 
@@ -47,8 +47,8 @@ otel = [
   "opentelemetry-api>=1.24.0",
 ]
 fastapi = [
-  "fastapi>=0.111.0",
-  "starlette>=0.37.0",
+  "fastapi>=0.100.0",
+  "starlette>=0.27.0",
 ]
 django = [
   "django>=4.2",
@@ -71,8 +71,8 @@ all = [
   "python-snappy>=0.7.1",
   "brotli>=1.1.0",
   "opentelemetry-api>=1.24.0",
-  "fastapi>=0.111.0",
-  "starlette>=0.37.0",
+  "fastapi>=0.100.0",
+  "starlette>=0.27.0",
   "django>=4.2",
   "flask>=3.0.0",
   "celery>=5.4.0",
@@ -93,22 +93,22 @@ dev = [
 packages = ["src/logs_interceptor"]
 
 [tool.hatch.build.targets.sdist]
-include = [
+only-include = [
   "/ARCHITECTURE.md",
   "/README.md",
-  "/examples",
   "/pyproject.toml",
-  "/scripts",
   "/src",
-  "/test-apps",
-  "/tests",
 ]
 exclude = [
+  "/.mypy_cache",
+  "/.pytest_cache",
+  "/.ruff_cache",
   "/.venv*",
   "/.logs-dlq",
   "/build",
   "/collector",
   "/dist",
+  "/test-apps",
 ]
 
 [tool.pytest.ini_options]

elven_logs_interceptor_python-0.1.9/examples/basic_app.py

@@ -1,18 +0,0 @@
-from logs_interceptor import init
-
-init(
-    {
-        "appName": "my-service",
-        "interceptConsole": True,
-        "transport": {
-            "url": "http://localhost:3100/loki/api/v1/push",
-            "tenantId": "my-tenant",
-            "compression": "gzip",
-            "enableConnectionPooling": True,
-        },
-        "deadLetterQueue": {"enabled": True, "type": "file"},
-        "circuitBreaker": {"enabled": True},
-    }
-)
-
-print("service started")

elven_logs_interceptor_python-0.1.9/examples/fastapi_integration.py

@@ -1,26 +0,0 @@
-from fastapi import FastAPI
-
-from logs_interceptor import init, logger
-from logs_interceptor.integrations import FastAPIMiddleware
-
-init(
-    {
-        "transport": {
-            "url": "http://localhost:3100/loki/api/v1/push",
-            "tenantId": "my-tenant",
-            "compression": "brotli",
-        },
-        "appName": "my-api",
-        "interceptConsole": True,
-        "deadLetterQueue": {"enabled": True, "type": "file"},
-    }
-)
-
-app = FastAPI()
-app.add_middleware(FastAPIMiddleware, logger=logger)
-
-
-@app.get("/ping")
-def ping() -> dict[str, str]:
-    logger.info("ping called")
-    return {"message": "pong"}

elven_logs_interceptor_python-0.1.9/examples/full_config_reference.py

@@ -1,67 +0,0 @@
-from logs_interceptor import init
-
-init(
-    {
-        "appName": "my-service-name",
-        "version": "1.2.0",
-        "environment": "production",
-        "interceptConsole": True,
-        "preserveOriginalConsole": True,
-        "silentErrors": False,
-        "debug": False,
-        "labels": {"region": "us-east-1", "tier": "gold"},
-        "dynamicLabels": {
-            "pod_id": lambda: "unknown",
-        },
-        "transport": {
-            "url": "http://localhost:3100/loki/api/v1/push",
-            "tenantId": "my-tenant-id",
-            "timeout": 10000,
-            "maxRetries": 3,
-            "retryDelay": 1000,
-            "enableConnectionPooling": True,
-            "maxSockets": 50,
-            "compression": "snappy",
-            "compressionLevel": 6,
-            "compressionThreshold": 1024,
-            "useWorkers": True,
-            "maxWorkers": 2,
-            "workerTimeout": 30000,
-        },
-        "buffer": {
-            "maxSize": 1000,
-            "flushInterval": 5000,
-            "maxMemoryMB": 50,
-            "maxAge": 30000,
-            "autoFlush": True,
-        },
-        "filter": {
-            "levels": ["info", "warn", "error", "fatal"],
-            "patterns": ["health/check"],
-            "samplingRate": 1.0,
-            "sanitize": True,
-            "sensitivePatterns": ["password", "token", "secret"],
-            "maxMessageLength": 8192,
-        },
-        "circuitBreaker": {
-            "enabled": True,
-            "failureThreshold": 20,
-            "resetTimeout": 30000,
-            "halfOpenRequests": 3,
-        },
-        "deadLetterQueue": {
-            "enabled": True,
-            "type": "file",
-            "basePath": "./.logs-dlq",
-            "maxSize": 1000,
-            "maxRetries": 10,
-        },
-        "performance": {
-            "useWorkers": True,
-            "maxConcurrentFlushes": 5,
-            "workerTimeout": 30000,
-        },
-        "enableMetrics": True,
-        "enableHealthCheck": True,
-    }
-)

elven_logs_interceptor_python-0.1.9/examples/high_volume.py

@@ -1,30 +0,0 @@
-from logs_interceptor import init, logger
-
-init(
-    {
-        "appName": "high-volume-service",
-        "interceptConsole": True,
-        "transport": {
-            "url": "http://localhost:3100/loki/api/v1/push",
-            "tenantId": "production",
-            "compression": "snappy",
-            "maxSockets": 100,
-            "timeout": 10000,
-            "useWorkers": True,
-            "maxWorkers": 4,
-            "compressionThreshold": 4096,
-            "compressionLevel": 6,
-        },
-        "buffer": {
-            "maxSize": 2000,
-            "flushInterval": 2000,
-            "maxMemoryMB": 512,
-        },
-        "performance": {
-            "maxConcurrentFlushes": 10,
-        },
-    }
-)
-
-for i in range(10000):
-    logger.info("High volume event", {"index": i})

elven_logs_interceptor_python-0.1.9/examples/tracking_usage.py

@@ -1,14 +0,0 @@
-from logs_interceptor import init, logger
-
-init(
-    {
-        "appName": "analytics-service",
-        "transport": {
-            "url": "http://localhost:3100/loki/api/v1/push",
-            "tenantId": "analytics",
-        },
-    }
-)
-
-logger.track_event("user_signup", {"user_id": "u_123", "plan": "pro"})
-logger.track_event("api_request", {"endpoint": "/users", "status_code": 200})

elven_logs_interceptor_python-0.1.9/scripts/publish.sh

@@ -1,180 +0,0 @@
-#!/usr/bin/env bash
-set -Eeuo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "${ROOT_DIR}"
-
-PYTHON_BIN="${PYTHON_BIN:-python3}"
-REPOSITORY="testpypi"
-TOKEN_ENV=""
-SKIP_CHECKS=0
-SKIP_BUILD=0
-DRY_RUN=0
-SKIP_EXISTING=1
-
-TEST_PYPI_URL="https://test.pypi.org/legacy/"
-PYPI_URL="https://upload.pypi.org/legacy/"
-
-usage() {
-  cat <<'EOF'
-Usage:
-  ./scripts/publish.sh [options]
-
-Options:
-  --repository {testpypi|pypi}  Publish target (default: testpypi)
-  --token-env NAME              Env var with API token
-  --skip-checks                 Skip ruff + mypy + pytest
-  --skip-build                  Skip build and twine check steps
-  --no-skip-existing            Do not pass --skip-existing to twine upload
-  --dry-run                     Run validations/build but do not upload
-  -h, --help                    Show this message
-
-Env:
-  PYTHON_BIN                    Python executable (default: python3)
-  TEST_PYPI_API_TOKEN           Default token env for --repository testpypi
-  PYPI_API_TOKEN                Default token env for --repository pypi
-EOF
-}
-
-require_python_module() {
-  local module_name="$1"
-  if ! "${PYTHON_BIN}" -c "import ${module_name}" >/dev/null 2>&1; then
-    echo "Missing Python module: ${module_name}" >&2
-    echo "Install dependencies with: ${PYTHON_BIN} -m pip install -e \".[dev]\"" >&2
-    exit 1
-  fi
-}
-
-run_checks() {
-  echo "[publish] running quality gates..."
-  "${PYTHON_BIN}" -m ruff check .
-  "${PYTHON_BIN}" -m mypy src
-  "${PYTHON_BIN}" -m pytest -q
-}
-
-clean_artifacts() {
-  rm -rf build dist
-  find . -maxdepth 1 -type d -name "*.egg-info" -exec rm -rf {} +
-}
-
-build_artifacts() {
-  echo "[publish] building distribution artifacts..."
-  clean_artifacts
-  "${PYTHON_BIN}" -m build
-  "${PYTHON_BIN}" -m twine check dist/*
-}
-
-resolve_repository_url() {
-  if [[ "${REPOSITORY}" == "testpypi" ]]; then
-    echo "${TEST_PYPI_URL}"
-    return
-  fi
-  echo "${PYPI_URL}"
-}
-
-resolve_token_env() {
-  if [[ -n "${TOKEN_ENV}" ]]; then
-    echo "${TOKEN_ENV}"
-    return
-  fi
-  if [[ "${REPOSITORY}" == "testpypi" ]]; then
-    echo "TEST_PYPI_API_TOKEN"
-    return
-  fi
-  echo "PYPI_API_TOKEN"
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --repository)
-      REPOSITORY="$2"
-      shift 2
-      ;;
-    --token-env)
-      TOKEN_ENV="$2"
-      shift 2
-      ;;
-    --skip-checks)
-      SKIP_CHECKS=1
-      shift
-      ;;
-    --skip-build)
-      SKIP_BUILD=1
-      shift
-      ;;
-    --no-skip-existing)
-      SKIP_EXISTING=0
-      shift
-      ;;
-    --dry-run)
-      DRY_RUN=1
-      shift
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      echo "Unknown option: $1" >&2
-      usage
-      exit 1
-      ;;
-  esac
-done
-
-if [[ "${REPOSITORY}" != "testpypi" && "${REPOSITORY}" != "pypi" ]]; then
-  echo "Invalid --repository value: ${REPOSITORY}" >&2
-  exit 1
-fi
-
-if [[ "${SKIP_CHECKS}" -eq 0 ]]; then
-  require_python_module "ruff"
-  require_python_module "mypy"
-  require_python_module "pytest"
-fi
-
-if [[ "${SKIP_BUILD}" -eq 0 ]]; then
-  require_python_module "build"
-  require_python_module "twine"
-elif [[ "${DRY_RUN}" -eq 0 ]]; then
-  require_python_module "twine"
-fi
-
-if [[ "${SKIP_CHECKS}" -eq 0 ]]; then
-  run_checks
-fi
-
-if [[ "${SKIP_BUILD}" -eq 0 ]]; then
-  build_artifacts
-fi
-
-if [[ "${DRY_RUN}" -eq 1 ]]; then
-  echo "[publish] dry-run enabled, upload skipped."
-  echo "[publish] built files:"
-  ls -1 dist/* 2>/dev/null || true
-  exit 0
-fi
-
-repository_url="$(resolve_repository_url)"
-token_env_name="$(resolve_token_env)"
-token_value="${!token_env_name-}"
-
-if [[ -z "${token_value}" ]]; then
-  echo "Missing publish token in env var: ${token_env_name}" >&2
-  exit 1
-fi
-
-twine_args=(
-  upload
-  --repository-url "${repository_url}"
-  --non-interactive
-)
-if [[ "${SKIP_EXISTING}" -eq 1 ]]; then
-  twine_args+=(--skip-existing)
-fi
-twine_args+=(dist/*)
-
-echo "[publish] uploading to ${REPOSITORY} (${repository_url})..."
-TWINE_USERNAME="__token__" TWINE_PASSWORD="${token_value}" "${PYTHON_BIN}" -m twine "${twine_args[@]}"
-
-echo "[publish] done."

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

@@ -1,49 +0,0 @@
-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.9/test-apps/elven-live-demo/README.md

@@ -1,17 +0,0 @@
-# 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.9/test-apps/elven-live-demo/app.py

@@ -1,97 +0,0 @@
-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.9/test-apps/elven-live-demo/run.sh

@@ -1,21 +0,0 @@
-#!/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"