wirelog 0.1.0__py3-none-any.whl

wirelog/__init__.py

@@ -0,0 +1,6 @@
+"""WireLog analytics client — zero dependencies."""
+
+from wirelog.client import WireLog
+
+__all__ = ["WireLog"]
+__version__ = "0.1.0"

wirelog/client.py

@@ -0,0 +1,138 @@
+"""WireLog analytics client. Zero external dependencies — stdlib only."""
+
+from __future__ import annotations
+
+import json
+import os
+import time
+import uuid
+from typing import Any
+from urllib.error import HTTPError
+from urllib.request import Request, urlopen
+
+
+class WireLogError(Exception):
+    """Raised when the WireLog API returns an error."""
+
+    def __init__(self, status: int, message: str) -> None:
+        super().__init__(f"WireLog API {status}: {message}")
+        self.status = status
+
+
+class WireLog:
+    """WireLog analytics client.
+
+    Zero external dependencies. Uses only the Python standard library.
+
+    Args:
+        api_key: API key (pk_, sk_, or aat_). Falls back to WIRELOG_API_KEY env var.
+        host: API base URL. Falls back to WIRELOG_HOST env var or https://api.wirelog.ai.
+        timeout: HTTP timeout in seconds. Default 30.
+    """
+
+    def __init__(
+        self,
+        api_key: str | None = None,
+        host: str | None = None,
+        timeout: int = 30,
+    ) -> None:
+        self.api_key = api_key or os.environ.get("WIRELOG_API_KEY", "")
+        self.host = (
+            host or os.environ.get("WIRELOG_HOST", "https://api.wirelog.ai")
+        ).rstrip("/")
+        self.timeout = timeout
+
+    def track(
+        self,
+        event_type: str,
+        *,
+        user_id: str | None = None,
+        device_id: str | None = None,
+        session_id: str | None = None,
+        event_properties: dict[str, Any] | None = None,
+        user_properties: dict[str, Any] | None = None,
+        insert_id: str | None = None,
+    ) -> dict[str, Any]:
+        """Track a single event. Returns {"accepted": N}."""
+        body: dict[str, Any] = {"event_type": event_type}
+        if user_id is not None:
+            body["user_id"] = user_id
+        if device_id is not None:
+            body["device_id"] = device_id
+        if session_id is not None:
+            body["session_id"] = session_id
+        if event_properties is not None:
+            body["event_properties"] = event_properties
+        if user_properties is not None:
+            body["user_properties"] = user_properties
+        if insert_id is not None:
+            body["insert_id"] = insert_id
+        else:
+            body["insert_id"] = uuid.uuid4().hex
+        body["time"] = _iso_now()
+        return self._post("/track", body)
+
+    def track_batch(self, events: list[dict[str, Any]]) -> dict[str, Any]:
+        """Track multiple events. Returns {"accepted": N}."""
+        return self._post("/track", {"events": events})
+
+    def query(
+        self,
+        q: str,
+        *,
+        format: str = "llm",
+        limit: int = 100,
+        offset: int = 0,
+    ) -> Any:
+        """Run a pipe DSL query. Returns Markdown (default), JSON, or CSV."""
+        return self._post(
+            "/query",
+            {"q": q, "format": format, "limit": limit, "offset": offset},
+        )
+
+    def identify(
+        self,
+        user_id: str,
+        *,
+        device_id: str | None = None,
+        user_properties: dict[str, Any] | None = None,
+        user_property_ops: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Bind device to user and/or set profile properties."""
+        body: dict[str, Any] = {"user_id": user_id}
+        if device_id is not None:
+            body["device_id"] = device_id
+        if user_properties is not None:
+            body["user_properties"] = user_properties
+        if user_property_ops is not None:
+            body["user_property_ops"] = user_property_ops
+        return self._post("/identify", body)
+
+    def _post(self, path: str, body: dict[str, Any]) -> Any:
+        """Send a POST request to the WireLog API."""
+        url = f"{self.host}{path}"
+        data = json.dumps(body).encode("utf-8")
+        req = Request(
+            url,
+            data=data,
+            headers={
+                "Content-Type": "application/json",
+                "X-API-Key": self.api_key,
+            },
+            method="POST",
+        )
+        try:
+            with urlopen(req, timeout=self.timeout) as resp:
+                raw = resp.read()
+                content_type = resp.headers.get("Content-Type", "")
+                if "application/json" in content_type:
+                    return json.loads(raw)
+                return raw.decode("utf-8")
+        except HTTPError as e:
+            msg = e.read().decode("utf-8", errors="replace")
+            raise WireLogError(e.code, msg) from e
+
+
+def _iso_now() -> str:
+    """Current UTC time in ISO 8601 format."""
+    return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())

wirelog-0.1.0.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: wirelog
+Version: 0.1.0
+Summary: WireLog analytics client — zero dependencies
+Project-URL: Homepage, https://wirelog.ai
+Project-URL: Repository, https://github.com/wirelogai/wirelog-python
+Project-URL: Documentation, https://docs.wirelog.ai
+Author-email: WireLog <hello@wirelog.ai>
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,analytics,events,tracking,wirelog
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# wirelog
+
+[WireLog](https://wirelog.ai) analytics client for Python. **Zero dependencies** — stdlib only.
+
+## Install
+
+```bash
+pip install wirelog
+```
+
+## Quick Start
+
+```python
+from wirelog import WireLog
+
+wl = WireLog(api_key="sk_your_secret_key")
+
+# Track an event
+wl.track("signup", user_id="u_123", event_properties={"plan": "free"})
+
+# Query analytics (returns Markdown by default)
+result = wl.query("signup | last 7d | count by day")
+print(result)
+
+# Identify a user (bind device → user, set profile)
+wl.identify("alice@acme.org", device_id="dev_abc", user_properties={"plan": "pro"})
+```
+
+## Configuration
+
+```python
+wl = WireLog(
+    api_key="sk_...",         # or set WIRELOG_API_KEY env var
+    host="https://api.wirelog.ai", # or set WIRELOG_HOST env var
+    timeout=30,                # HTTP timeout in seconds
+)
+```
+
+## API
+
+### `wl.track(event_type, *, user_id, device_id, session_id, event_properties, user_properties, insert_id)`
+
+Track a single event. Auto-generates `insert_id` and `time` if not provided.
+
+### `wl.track_batch(events)`
+
+Track multiple events in one request (up to 2000).
+
+### `wl.query(q, *, format="llm", limit=100, offset=0)`
+
+Run a pipe DSL query. Format: `"llm"` (Markdown), `"json"`, or `"csv"`.
+
+### `wl.identify(user_id, *, device_id, user_properties, user_property_ops)`
+
+Bind a device to a user and/or update profile properties.
+
+## Zero Dependencies
+
+This library uses only the Python standard library (`urllib.request`, `json`, `time`, `uuid`, `os`). No `requests`, no `httpx`, no `urllib3`. It works out of the box on any Python 3.9+ installation.
+
+## Learn More
+
+- [WireLog](https://wirelog.ai) — headless analytics for agents and LLMs
+- [Query language docs](https://docs.wirelog.ai/query-language)
+- [API reference](https://docs.wirelog.ai/reference/api)

wirelog-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+wirelog/__init__.py,sha256=lV8DGI-ueFdmlfgrJ2NngapSiWXG0rs6vD8vudbQfiU,135
+wirelog/client.py,sha256=5BlkJUnau1pAf6WevCsT6HR0ARs1vL2GoTon_9BIxbs,4595
+wirelog-0.1.0.dist-info/METADATA,sha256=g4hqtzepgoZ6Zunl2UovpYPraDb8a7wY1lJ6kgcmDAg,2773
+wirelog-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+wirelog-0.1.0.dist-info/licenses/LICENSE,sha256=Xp6_oelz4Jy_uERw5PFQdkeeAO9XdAfJCgjBeg0F1L0,1064
+wirelog-0.1.0.dist-info/RECORD,,

wirelog-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

wirelog-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WireLog
+
+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.