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

{elven_logs_interceptor_python-0.1.8 → 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.8
+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
@@ -154,6 +154,7 @@ Transport:
 - `LOGS_WORKER_TIMEOUT`
 - `LOGS_CONNECTION_POOLING`
 - `LOGS_MAX_SOCKETS`
+- `LOGS_ENABLE_STRUCTURED_METADATA` (`false` by default; enable only when Loki allows `limits_config.allow_structured_metadata`)
 - `LOGS_TIMEOUT`
 - `LOGS_MAX_RETRIES`
 - `LOGS_RETRY_DELAY`

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.10}/README.md

@@ -93,6 +93,7 @@ Transport:
 - `LOGS_WORKER_TIMEOUT`
 - `LOGS_CONNECTION_POOLING`
 - `LOGS_MAX_SOCKETS`
+- `LOGS_ENABLE_STRUCTURED_METADATA` (`false` by default; enable only when Loki allows `limits_config.allow_structured_metadata`)
 - `LOGS_TIMEOUT`
 - `LOGS_MAX_RETRIES`
 - `LOGS_RETRY_DELAY`

{elven_logs_interceptor_python-0.1.8 → 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.8"
+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.8 → elven_logs_interceptor_python-0.1.10}/src/logs_interceptor/__init__.py

@@ -104,6 +104,9 @@ def _coerce_config(user_config: LogsInterceptorConfig | dict[str, Any] | None) -
                 transport_raw, "enable_connection_pooling", "enableConnectionPooling"
             ),
             max_sockets=_pick(transport_raw, "max_sockets", "maxSockets"),
+            enable_structured_metadata=_pick(
+                transport_raw, "enable_structured_metadata", "enableStructuredMetadata"
+            ),
         ),
         app_name=_pick(user_config, "app_name", "appName", ""),
         version=_pick(user_config, "version", "version"),

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.10}/src/logs_interceptor/application/config_service.py

@@ -170,6 +170,11 @@ class ConfigService:
                 True if transport.enable_connection_pooling is None else transport.enable_connection_pooling
             ),
             max_sockets=transport.max_sockets if transport.max_sockets is not None else 50,
+            enable_structured_metadata=(
+                False
+                if transport.enable_structured_metadata is None
+                else transport.enable_structured_metadata
+            ),
         )
 
     @staticmethod

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.10}/src/logs_interceptor/config.py

@@ -26,6 +26,7 @@ class TransportConfig:
     worker_timeout: int | None = None
     enable_connection_pooling: bool | None = None
     max_sockets: int | None = None
+    enable_structured_metadata: bool | None = None
 
 
 @dataclass(slots=True)
@@ -131,6 +132,7 @@ class ResolvedTransportConfig:
     worker_timeout: int
     enable_connection_pooling: bool
     max_sockets: int
+    enable_structured_metadata: bool = False
 
 
 @dataclass(slots=True)

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.10}/src/logs_interceptor/infrastructure/transport/loki_json_transport.py

@@ -210,9 +210,10 @@ class LokiJsonTransport:
 
             timestamp_ns = self._timestamp_to_ns(entry.timestamp)
             value: list[Any] = [str(timestamp_ns), self._dumps(payload).decode("utf-8")]
-            structured_metadata = self._format_structured_metadata(entry.metadata)
-            if structured_metadata:
-                value.append(structured_metadata)
+            if self._config.enable_structured_metadata:
+                structured_metadata = self._format_structured_metadata(entry.metadata)
+                if structured_metadata:
+                    value.append(structured_metadata)
             values_map[key].append(value)
             streams[key] = labels
 

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.10}/src/logs_interceptor/utils.py

@@ -530,6 +530,9 @@ def load_config_from_env() -> LogsInterceptorConfig:
             enable_connection_pooling=parse_bool(env.get("LOGS_CONNECTION_POOLING"), True),
             max_sockets=parse_int_range(env.get("LOGS_MAX_SOCKETS"), 50, 1, 1024),
             worker_timeout=parse_int_range(env.get("LOGS_WORKER_TIMEOUT"), 30_000, 1000, 300_000),
+            enable_structured_metadata=parse_bool(
+                env.get("LOGS_ENABLE_STRUCTURED_METADATA"), False
+            ),
         ),
         app_name=env.get("LOGS_APP_NAME", ""),
         version=env.get("LOGS_APP_VERSION", "1.0.0"),

elven_logs_interceptor_python-0.1.8/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.8/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.8/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.8/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.8/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.8/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.8/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.8/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`.