lucarne 1.0.0__tar.gz

lucarne-1.0.0/.gitignore

@@ -0,0 +1 @@
+dist/

lucarne-1.0.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: lucarne
+Version: 1.0.0
+Summary: Python client for lucarne — self-hostable browser sessions you can drive, watch, and record.
+Project-URL: Homepage, https://github.com/volter-ai/lucarne
+Project-URL: Repository, https://github.com/volter-ai/lucarne
+Project-URL: Changelog, https://github.com/volter-ai/lucarne/blob/main/CHANGELOG.md
+Author: Aaron Volter
+License-Expression: MIT
+Keywords: agent,automation,browser,cdp,lucarne,playwright,remote-browser
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# lucarne (Python client)
+
+Python client for **[lucarne](https://github.com/volter-ai/lucarne)** — self-hostable
+browser sessions you can drive (CDP/Playwright), watch + control (porthole), and record,
+on your own machine and your own IP.
+
+This package is the **client**. The engine is a Node daemon — install and run it
+separately (`npm install -g lucarne && lucarne serve`); you talk to it over HTTP, and
+drive the browser over CDP with Playwright.
+
+```sh
+pip install lucarne playwright
+```
+
+```python
+from lucarne import LucarneClient
+from playwright.sync_api import sync_playwright
+
+luc = LucarneClient("http://127.0.0.1:7800")          # token="..." if the daemon needs one
+s = luc.create(profile="demo", backend="native")
+print("watch:", s["viewUrl"])
+
+with sync_playwright() as p:
+    page = p.chromium.connect_over_cdp(s["cdpUrl"]).contexts[0].pages[0]
+    page.goto("https://example.com", wait_until="domcontentloaded")
+    print(page.title())
+```
+
+The client is stdlib-only (no dependencies) and covers
+`health / create / list / get / destroy / act / content`. For the rest of the API, call
+the HTTP endpoints directly — see the [OpenAPI spec](https://github.com/volter-ai/lucarne)
+at `/openapi.json`. MIT © Aaron Volter.

lucarne-1.0.0/README.md

@@ -0,0 +1,32 @@
+# lucarne (Python client)
+
+Python client for **[lucarne](https://github.com/volter-ai/lucarne)** — self-hostable
+browser sessions you can drive (CDP/Playwright), watch + control (porthole), and record,
+on your own machine and your own IP.
+
+This package is the **client**. The engine is a Node daemon — install and run it
+separately (`npm install -g lucarne && lucarne serve`); you talk to it over HTTP, and
+drive the browser over CDP with Playwright.
+
+```sh
+pip install lucarne playwright
+```
+
+```python
+from lucarne import LucarneClient
+from playwright.sync_api import sync_playwright
+
+luc = LucarneClient("http://127.0.0.1:7800")          # token="..." if the daemon needs one
+s = luc.create(profile="demo", backend="native")
+print("watch:", s["viewUrl"])
+
+with sync_playwright() as p:
+    page = p.chromium.connect_over_cdp(s["cdpUrl"]).contexts[0].pages[0]
+    page.goto("https://example.com", wait_until="domcontentloaded")
+    print(page.title())
+```
+
+The client is stdlib-only (no dependencies) and covers
+`health / create / list / get / destroy / act / content`. For the rest of the API, call
+the HTTP endpoints directly — see the [OpenAPI spec](https://github.com/volter-ai/lucarne)
+at `/openapi.json`. MIT © Aaron Volter.

lucarne-1.0.0/lucarne.py

@@ -0,0 +1,52 @@
+"""Minimal Python client for the lucarne control API (stdlib only).
+
+The daemon is the source of truth; this is convenience sugar. The session's
+``cdpUrl`` is still driven with your CDP client of choice (e.g. Playwright).
+"""
+from __future__ import annotations
+
+import json
+import urllib.request
+from typing import Any
+
+__version__ = "1.0.0"
+
+
+class LucarneClient:
+    def __init__(self, base_url: str = "http://127.0.0.1:7800", token: str | None = None) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+
+    def _req(self, method: str, path: str, body: Any | None = None) -> Any:
+        data = json.dumps(body).encode() if body is not None else None
+        req = urllib.request.Request(self.base_url + path, data=data, method=method)
+        if self.token:
+            req.add_header("Authorization", f"Bearer {self.token}")
+        if data is not None:
+            req.add_header("Content-Type", "application/json")
+        with urllib.request.urlopen(req) as resp:
+            raw = resp.read()
+            ctype = resp.headers.get("content-type", "")
+            return json.loads(raw) if "application/json" in ctype else raw.decode()
+
+    def health(self) -> dict:
+        return self._req("GET", "/health")
+
+    def create(self, **opts: Any) -> dict:
+        return self._req("POST", "/sessions", opts)
+
+    def list(self, **meta: str) -> list:
+        q = "?" + "&".join(f"meta.{k}={v}" for k, v in meta.items()) if meta else ""
+        return self._req("GET", "/sessions" + q)
+
+    def get(self, session_id: str) -> dict:
+        return self._req("GET", f"/sessions/{session_id}")
+
+    def destroy(self, session_id: str) -> dict:
+        return self._req("DELETE", f"/sessions/{session_id}")
+
+    def act(self, session_id: str, **action: Any) -> dict:
+        return self._req("POST", f"/sessions/{session_id}/act", action)
+
+    def content(self, session_id: str) -> str:
+        return self._req("GET", f"/sessions/{session_id}/content")

lucarne-1.0.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lucarne"
+version = "1.0.0"
+description = "Python client for lucarne — self-hostable browser sessions you can drive, watch, and record."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [{ name = "Aaron Volter" }]
+keywords = ["browser", "playwright", "cdp", "automation", "remote-browser", "agent", "lucarne"]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Testing",
+  "Topic :: Internet :: WWW/HTTP :: Browsers",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/volter-ai/lucarne"
+Repository = "https://github.com/volter-ai/lucarne"
+Changelog = "https://github.com/volter-ai/lucarne/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+only-include = ["lucarne.py"]
+
+[tool.hatch.build.targets.sdist]
+include = ["lucarne.py", "README.md", "pyproject.toml"]