prairielog-handler 0.1.0__tar.gz

prairielog_handler-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Sima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

prairielog_handler-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: prairielog-handler
+Version: 0.1.0
+Summary: Python logging handler for PrairieLog ingestion.
+Author: PrairieLog
+License-Expression: MIT
+Project-URL: Homepage, https://prairie-log-api.com
+Project-URL: Documentation, https://prairie-log-api.com/docs.html
+Project-URL: Repository, https://github.com/robertsima/log-stream-service
+Project-URL: Issues, https://github.com/robertsima/log-stream-service/issues
+Keywords: prairielog,logging,logs,observability
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PrairieLog Python Handler
+
+Small `logging.Handler` for Python services. It batches records through `POST /api/v1/log-events/batch`, maps Python log levels to PrairieLog levels, and flushes on demand.
+
+After registry publishing:
+
+```bash
+pip install prairielog-handler
+```
+
+Until then, install from this repo with `pip install ./frontend/sdk/python`.
+
+```python
+import logging
+from prairielog_handler import PrairieLogHandler
+
+handler = PrairieLogHandler(
+    api_url="https://log-stream-service.onrender.com",
+    ingestion_token="YOUR_INGESTION_TOKEN",
+    logger_name="checkout-worker",
+)
+
+logging.getLogger().addHandler(handler)
+logging.error("Payment failed", extra={"orderId": "ord_123"})
+```
+
+Call `handler.flush()` before process shutdown when you cannot rely on normal logging cleanup.

prairielog_handler-0.1.0/README.md

@@ -0,0 +1,27 @@
+# PrairieLog Python Handler
+
+Small `logging.Handler` for Python services. It batches records through `POST /api/v1/log-events/batch`, maps Python log levels to PrairieLog levels, and flushes on demand.
+
+After registry publishing:
+
+```bash
+pip install prairielog-handler
+```
+
+Until then, install from this repo with `pip install ./frontend/sdk/python`.
+
+```python
+import logging
+from prairielog_handler import PrairieLogHandler
+
+handler = PrairieLogHandler(
+    api_url="https://log-stream-service.onrender.com",
+    ingestion_token="YOUR_INGESTION_TOKEN",
+    logger_name="checkout-worker",
+)
+
+logging.getLogger().addHandler(handler)
+logging.error("Payment failed", extra={"orderId": "ord_123"})
+```
+
+Call `handler.flush()` before process shutdown when you cannot rely on normal logging cleanup.

prairielog_handler-0.1.0/prairielog_handler.egg-info/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: prairielog-handler
+Version: 0.1.0
+Summary: Python logging handler for PrairieLog ingestion.
+Author: PrairieLog
+License-Expression: MIT
+Project-URL: Homepage, https://prairie-log-api.com
+Project-URL: Documentation, https://prairie-log-api.com/docs.html
+Project-URL: Repository, https://github.com/robertsima/log-stream-service
+Project-URL: Issues, https://github.com/robertsima/log-stream-service/issues
+Keywords: prairielog,logging,logs,observability
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PrairieLog Python Handler
+
+Small `logging.Handler` for Python services. It batches records through `POST /api/v1/log-events/batch`, maps Python log levels to PrairieLog levels, and flushes on demand.
+
+After registry publishing:
+
+```bash
+pip install prairielog-handler
+```
+
+Until then, install from this repo with `pip install ./frontend/sdk/python`.
+
+```python
+import logging
+from prairielog_handler import PrairieLogHandler
+
+handler = PrairieLogHandler(
+    api_url="https://log-stream-service.onrender.com",
+    ingestion_token="YOUR_INGESTION_TOKEN",
+    logger_name="checkout-worker",
+)
+
+logging.getLogger().addHandler(handler)
+logging.error("Payment failed", extra={"orderId": "ord_123"})
+```
+
+Call `handler.flush()` before process shutdown when you cannot rely on normal logging cleanup.

prairielog_handler-0.1.0/prairielog_handler.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+prairielog_handler.py
+pyproject.toml
+prairielog_handler.egg-info/PKG-INFO
+prairielog_handler.egg-info/SOURCES.txt
+prairielog_handler.egg-info/dependency_links.txt
+prairielog_handler.egg-info/top_level.txt

prairielog_handler-0.1.0/prairielog_handler.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

prairielog_handler-0.1.0/prairielog_handler.egg-info/top_level.txt

@@ -0,0 +1 @@
+prairielog_handler

prairielog_handler-0.1.0/prairielog_handler.py

@@ -0,0 +1,97 @@
+import json
+import logging
+import traceback
+import urllib.request
+import uuid
+from datetime import datetime, timezone
+
+
+class PrairieLogHandler(logging.Handler):
+    def __init__(
+        self,
+        api_url,
+        ingestion_token,
+        logger_name=None,
+        batch_size=50,
+        timeout=5,
+    ):
+        super().__init__()
+        self.api_url = api_url.rstrip("/")
+        self.ingestion_token = ingestion_token
+        self.logger_name = logger_name
+        self.batch_size = min(max(int(batch_size), 1), 100)
+        self.timeout = timeout
+        self.buffer = []
+
+    def emit(self, record):
+        try:
+            self.buffer.append(self._to_event(record))
+            if len(self.buffer) >= self.batch_size:
+                self.flush()
+        except Exception:
+            self.handleError(record)
+
+    def flush(self):
+        if not self.buffer:
+            return
+        batch = self.buffer
+        self.buffer = []
+        try:
+            self._post(batch)
+        except Exception:
+            self.buffer = batch + self.buffer
+            raise
+
+    def close(self):
+        try:
+            self.flush()
+        finally:
+            super().close()
+
+    def _to_event(self, record):
+        metadata = {
+            "module": record.module,
+            "pathname": record.pathname,
+            "lineno": record.lineno,
+            "threadName": record.threadName,
+            "processName": record.processName,
+        }
+        if record.exc_info:
+            metadata["stack"] = "".join(traceback.format_exception(*record.exc_info))
+            metadata["errorName"] = record.exc_info[0].__name__
+
+        return {
+            "id": str(uuid.uuid4()),
+            "level": self._level(record.levelno),
+            "message": record.getMessage(),
+            "occurredAt": datetime.fromtimestamp(record.created, timezone.utc).isoformat(),
+            "logger": self.logger_name or record.name,
+            "metadata": metadata,
+        }
+
+    def _post(self, batch):
+        body = json.dumps(batch).encode("utf-8")
+        request = urllib.request.Request(
+            f"{self.api_url}/api/v1/log-events/batch",
+            data=body,
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "X-Ingestion-Token": self.ingestion_token,
+            },
+        )
+        with urllib.request.urlopen(request, timeout=self.timeout) as response:
+            if response.status >= 400:
+                raise RuntimeError(f"PrairieLog request failed with {response.status}")
+
+    @staticmethod
+    def _level(levelno):
+        if levelno >= logging.ERROR:
+            return "ERROR"
+        if levelno >= logging.WARNING:
+            return "WARN"
+        if levelno >= logging.INFO:
+            return "INFO"
+        if levelno >= logging.DEBUG:
+            return "DEBUG"
+        return "TRACE"

prairielog_handler-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "prairielog-handler"
+version = "0.1.0"
+description = "Python logging handler for PrairieLog ingestion."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "PrairieLog" }
+]
+keywords = ["prairielog", "logging", "logs", "observability"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: System :: Logging"
+]
+
+[project.urls]
+Homepage = "https://prairie-log-api.com"
+Documentation = "https://prairie-log-api.com/docs.html"
+Repository = "https://github.com/robertsima/log-stream-service"
+Issues = "https://github.com/robertsima/log-stream-service/issues"
+
+[tool.setuptools]
+py-modules = ["prairielog_handler"]

prairielog_handler-0.1.0/setup.cfg

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