owlpane 0.1.1__tar.gz

owlpane-0.1.1/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: owlpane
+Version: 0.1.1
+Summary: Thin OpenTelemetry bootstrap for Owlpane ingest
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: opentelemetry-api>=1.28.0
+Requires-Dist: opentelemetry-sdk>=1.28.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# owlpane (Python)
+
+Thin SDK: resolves env like `@owlpane/node`, exports traces via OpenTelemetry.
+
+```bash
+pip install -e .
+export OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.example.com
+export OWLPANE_INGEST_KEY=owl_ing_…
+export OTEL_SERVICE_NAME=my-api
+```
+
+```python
+from owlpane import shutdown, start
+
+start()
+# … application …
+shutdown()
+```

owlpane-0.1.1/README.md

@@ -0,0 +1,18 @@
+# owlpane (Python)
+
+Thin SDK: resolves env like `@owlpane/node`, exports traces via OpenTelemetry.
+
+```bash
+pip install -e .
+export OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.example.com
+export OWLPANE_INGEST_KEY=owl_ing_…
+export OTEL_SERVICE_NAME=my-api
+```
+
+```python
+from owlpane import shutdown, start
+
+start()
+# … application …
+shutdown()
+```

owlpane-0.1.1/owlpane/__init__.py

@@ -0,0 +1,70 @@
+"""Owlpane thin Python SDK — configures OpenTelemetry export from environment."""
+
+from __future__ import annotations
+
+from typing import Callable, Optional
+
+from opentelemetry import trace
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+from opentelemetry.sdk.resources import Resource
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from opentelemetry.sdk.trace.sampling import ParentBasedTraceIdRatio
+
+from owlpane._generated_config import Config, resolve_config_from_env
+
+_provider: Optional[TracerProvider] = None
+_enabled = False
+
+
+def start(cfg: Optional[Config] = None) -> Optional[Callable[[], None]]:
+    """Start OTLP export. Returns shutdown callable, or None when unconfigured."""
+    global _provider, _enabled
+    if cfg is None:
+        cfg = resolve_config_from_env()
+    if cfg is None:
+        return None
+    if _provider is not None:
+        return shutdown
+
+    headers = {}
+    if cfg.authorization:
+        headers["Authorization"] = cfg.authorization
+
+    exporter = OTLPSpanExporter(
+        endpoint=f"{cfg.base_url}/v1/traces",
+        headers=headers,
+    )
+    resource = Resource.create(
+        {
+            "service.name": cfg.service_name,
+            "service.version": cfg.version,
+            "deployment.environment.name": cfg.environment,
+        }
+    )
+    sampler = ParentBasedTraceIdRatio(cfg.sample_ratio)
+    _provider = TracerProvider(resource=resource, sampler=sampler)
+    _provider.add_span_processor(BatchSpanProcessor(exporter))
+    trace.set_tracer_provider(_provider)
+    _enabled = True
+    return shutdown
+
+
+def shutdown() -> None:
+    global _provider, _enabled
+    if _provider is not None:
+        _provider.shutdown()
+        _provider = None
+    _enabled = False
+
+
+def is_enabled() -> bool:
+    return _enabled
+
+
+def emit_test_span(name: str) -> None:
+    if not _enabled:
+        raise RuntimeError("owlpane not enabled")
+    tracer = trace.get_tracer("owlpane")
+    with tracer.start_as_current_span(name):
+        pass

owlpane-0.1.1/owlpane/_generated_config.py

@@ -0,0 +1,55 @@
+# Code generated by codegen/generate.ts; DO NOT EDIT.
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class Config:
+    base_url: str
+    authorization: str
+    service_name: str
+    version: str
+    environment: str
+    sample_ratio: float
+    trace_user_profile: bool
+
+
+def _env(k: str) -> str:
+    return (os.environ.get(k) or "").strip()
+
+
+def resolve_config_from_env() -> Optional[Config]:
+    if _env("OTEL_SDK_DISABLED") == "true":
+        return None
+    endpoint = _env("OTEL_EXPORTER_OTLP_ENDPOINT") or _env("OWLPANE_INGEST_URL")
+    if not endpoint:
+        return None
+    endpoint = endpoint.rstrip("/")
+    service = _env("OTEL_SERVICE_NAME") or "python-app"
+    version = _env("OWLPANE_RELEASE") or "0.0.0"
+    environment = _env("OWLPANE_ENVIRONMENT") or _env("NODE_ENV") or "development"
+    key = _env("OWLPANE_INGEST_KEY")
+    auth = f"Bearer {key}" if key else ""
+    ratio = 1.0
+    if _env("NODE_ENV") == "production":
+        ratio = 0.1
+    raw = _env("OTEL_TRACES_SAMPLER_ARG")
+    if raw:
+        try:
+            f = float(raw)
+            ratio = f if 0 <= f <= 1 else 0.1
+        except ValueError:
+            ratio = 0.1
+    tup = _env("OWLPANE_TRACE_USER_PROFILE").lower() in ("1", "true", "yes")
+    return Config(
+        base_url=endpoint,
+        authorization=auth,
+        service_name=service,
+        version=version,
+        environment=environment,
+        sample_ratio=ratio,
+        trace_user_profile=tup,
+    )

owlpane-0.1.1/owlpane.egg-info/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: owlpane
+Version: 0.1.1
+Summary: Thin OpenTelemetry bootstrap for Owlpane ingest
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: opentelemetry-api>=1.28.0
+Requires-Dist: opentelemetry-sdk>=1.28.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# owlpane (Python)
+
+Thin SDK: resolves env like `@owlpane/node`, exports traces via OpenTelemetry.
+
+```bash
+pip install -e .
+export OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.example.com
+export OWLPANE_INGEST_KEY=owl_ing_…
+export OTEL_SERVICE_NAME=my-api
+```
+
+```python
+from owlpane import shutdown, start
+
+start()
+# … application …
+shutdown()
+```

owlpane-0.1.1/owlpane.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+owlpane/__init__.py
+owlpane/_generated_config.py
+owlpane.egg-info/PKG-INFO
+owlpane.egg-info/SOURCES.txt
+owlpane.egg-info/dependency_links.txt
+owlpane.egg-info/requires.txt
+owlpane.egg-info/top_level.txt
+tests/test_config.py

owlpane-0.1.1/owlpane.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

owlpane-0.1.1/owlpane.egg-info/requires.txt

@@ -0,0 +1,6 @@
+opentelemetry-api>=1.28.0
+opentelemetry-sdk>=1.28.0
+opentelemetry-exporter-otlp-proto-http>=1.28.0
+
+[dev]
+pytest>=8.0.0

owlpane-0.1.1/owlpane.egg-info/top_level.txt

@@ -0,0 +1 @@
+owlpane

owlpane-0.1.1/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "owlpane"
+version = "0.1.1"
+description = "Thin OpenTelemetry bootstrap for Owlpane ingest"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "opentelemetry-api>=1.28.0",
+  "opentelemetry-sdk>=1.28.0",
+  "opentelemetry-exporter-otlp-proto-http>=1.28.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0.0"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["owlpane*"]

owlpane-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

owlpane-0.1.1/tests/test_config.py

@@ -0,0 +1,20 @@
+import os
+
+from owlpane._generated_config import resolve_config_from_env
+
+
+def test_missing_endpoint():
+    os.environ.clear()
+    assert resolve_config_from_env() is None
+
+
+def test_basic():
+    os.environ.clear()
+    os.environ["OTEL_EXPORTER_OTLP_ENDPOINT"] = "https://ingest.test"
+    os.environ["OWLPANE_INGEST_KEY"] = "owl_ing_" + "a" * 48
+    os.environ["OTEL_SERVICE_NAME"] = "api"
+    cfg = resolve_config_from_env()
+    assert cfg is not None
+    assert cfg.base_url == "https://ingest.test"
+    assert cfg.service_name == "api"
+    assert cfg.authorization.startswith("Bearer ")