upstream-sdk-python 0.0.3__tar.gz

upstream_sdk_python-0.0.3/.gitignore

@@ -0,0 +1,2 @@
+venv
+upstream_sdk/__pycache__/

upstream_sdk_python-0.0.3/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: upstream-sdk-python
+Version: 0.0.3
+Summary: Simple and open logging for your projects
+Project-URL: Homepage, https://up.linus.my
+Project-URL: Documentation, https://docs.linus.my/upstream
+Project-URL: Repository, https://github.com/linusdotmy/upstream
+License: CC BY-NC 4.0
+Keywords: events,logging,logs,sdk,upstream
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# upstream-sdk
+
+Simple and open logging for your projects.
+
+## Installation
+
+```bash
+pip install upstream-sdk
+```
+
+## Quick Start
+
+```python
+from upstream_sdk import Upstream, EventProps
+
+up = Upstream("YOUR_API_KEY")
+
+up.events.ingest(EventProps(
+    title="Project Deployed",
+    icon="😁",
+))
+```
+
+That's just scratching the surface. You can log complex events with JSON, timeline events, descriptions, fields, and even add action buttons.
+
+## License
+
+MIT

upstream_sdk_python-0.0.3/README.md

@@ -0,0 +1,28 @@
+# upstream-sdk
+
+Simple and open logging for your projects.
+
+## Installation
+
+```bash
+pip install upstream-sdk
+```
+
+## Quick Start
+
+```python
+from upstream_sdk import Upstream, EventProps
+
+up = Upstream("YOUR_API_KEY")
+
+up.events.ingest(EventProps(
+    title="Project Deployed",
+    icon="😁",
+))
+```
+
+That's just scratching the surface. You can log complex events with JSON, timeline events, descriptions, fields, and even add action buttons.
+
+## License
+
+MIT

upstream_sdk_python-0.0.3/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "upstream-sdk-python"
+version = "0.0.3"
+description = "Simple and open logging for your projects"
+readme = "README.md"
+license = {text = "CC BY-NC 4.0"}
+requires-python = ">=3.8"
+keywords = ["upstream", "logging", "sdk", "events", "logs"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://up.linus.my"
+Documentation = "https://docs.linus.my/upstream"
+Repository = "https://github.com/linusdotmy/upstream"
+
+[tool.hatch.build.targets.wheel]
+packages = ["upstream_sdk"]
+

upstream_sdk_python-0.0.3/upstream_sdk/__init__.py

@@ -0,0 +1,4 @@
+from .client import Upstream
+from .types import Action, EventProps, Field, TimelineEvent
+
+__all__ = ["Action", "EventProps", "Field", "TimelineEvent", "Upstream"]

upstream_sdk_python-0.0.3/upstream_sdk/client.py

@@ -0,0 +1,47 @@
+import json
+import urllib.request
+from dataclasses import asdict
+from typing import Optional
+
+from .types import EventProps
+
+
+class _EventsAPI:
+    def __init__(self, api_key: str, host: str):
+        self._api_key = api_key
+        self._host = host.rstrip("/")
+
+    def ingest(self, payload: EventProps) -> dict:
+        url = f"{self._host}/api/events/ingest"
+        data = asdict(payload)
+
+        # Convert snake_case to camelCase for API compatibility
+        if "created_at" in data:
+            data["createdAt"] = data.pop("created_at")
+
+        # Remove None values to keep payload clean
+        data = {k: v for k, v in data.items() if v is not None}
+
+        req = urllib.request.Request(
+            url,
+            data=json.dumps(data, default=str).encode("utf-8"),
+            headers={
+                "Content-Type": "application/json",
+                "x-api-key": self._api_key,
+            },
+            method="POST",
+        )
+
+        try:
+            with urllib.request.urlopen(req) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            body = e.read().decode("utf-8")
+            raise Exception(f"Upstream API error ({e.code}): {body}") from e
+
+
+class Upstream:
+    def __init__(self, api_key: str, host: Optional[str] = None):
+        self._api_key = api_key
+        self._host = host or "https://up.linus.my"
+        self.events = _EventsAPI(self._api_key, self._host)

upstream_sdk_python-0.0.3/upstream_sdk/types.py

@@ -0,0 +1,35 @@
+from dataclasses import dataclass
+from typing import Any, List, Literal, Optional
+
+
+@dataclass
+class Field:
+    name: str
+    value: str
+
+
+@dataclass
+class TimelineEvent:
+    icon: str
+    time: str
+    content: str
+
+
+@dataclass
+class Action:
+    title: str
+    type: Literal["default", "secondary", "ghost"]
+    url: str
+
+
+@dataclass
+class EventProps:
+    title: str
+    icon: str
+    created_at: Optional[str] = None
+    content: Optional[str] = None
+    category: Optional[str] = None
+    fields: Optional[List[Field]] = None
+    events: Optional[List[TimelineEvent]] = None
+    data: Optional[Any] = None
+    actions: Optional[List[Action]] = None