rldyour-sysinfo 0.2.0__tar.gz

rldyour_sysinfo-0.2.0/.gitignore

@@ -0,0 +1,5 @@
+/daemon/target/
+/extension/schemas/gschemas.compiled
+/python/dist/
+/python/.pytest_cache/
+/python/**/__pycache__/

rldyour_sysinfo-0.2.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.5
+Name: rldyour-sysinfo
+Version: 0.2.0
+Summary: Python client for the rldyour-sysinfo live metrics daemon
+Project-URL: Homepage, https://github.com/NDDev-OpenNetwork/rldyour-sysinfo
+Project-URL: Repository, https://github.com/NDDev-OpenNetwork/rldyour-sysinfo
+Project-URL: Issues, https://github.com/NDDev-OpenNetwork/rldyour-sysinfo/issues
+Author: NDDev OpenNetwork
+License-Expression: AGPL-3.0-or-later
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# rldyour-sysinfo Python client
+
+Typed, dependency-free client for the local JSON protocol exposed by the
+`rldyour-sysinfod` Rust daemon.
+
+```python
+from rldyour_sysinfo import samples
+
+for sample in samples(interval=2):
+    print(sample["gpu"])
+```
+
+The command `rldyour-sysinfo --once` prints one sample as JSON. Install the
+daemon from the [main repository](https://github.com/NDDev-OpenNetwork/rldyour-sysinfo).

rldyour_sysinfo-0.2.0/README.md

@@ -0,0 +1,14 @@
+# rldyour-sysinfo Python client
+
+Typed, dependency-free client for the local JSON protocol exposed by the
+`rldyour-sysinfod` Rust daemon.
+
+```python
+from rldyour_sysinfo import samples
+
+for sample in samples(interval=2):
+    print(sample["gpu"])
+```
+
+The command `rldyour-sysinfo --once` prints one sample as JSON. Install the
+daemon from the [main repository](https://github.com/NDDev-OpenNetwork/rldyour-sysinfo).

rldyour_sysinfo-0.2.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rldyour-sysinfo"
+version = "0.2.0"
+description = "Python client for the rldyour-sysinfo live metrics daemon"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "AGPL-3.0-or-later"
+authors = [{ name = "NDDev OpenNetwork" }]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows :: Windows 10",
+  "Operating System :: POSIX :: Linux",
+]
+
+[project.urls]
+Homepage = "https://github.com/NDDev-OpenNetwork/rldyour-sysinfo"
+Repository = "https://github.com/NDDev-OpenNetwork/rldyour-sysinfo"
+Issues = "https://github.com/NDDev-OpenNetwork/rldyour-sysinfo/issues"
+
+[project.scripts]
+rldyour-sysinfo = "rldyour_sysinfo:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rldyour_sysinfo"]

rldyour_sysinfo-0.2.0/src/rldyour_sysinfo/__init__.py

@@ -0,0 +1,74 @@
+"""Client for the rldyour-sysinfo local protocol."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import socket
+import sys
+from collections.abc import Iterator
+from pathlib import Path
+from typing import Any, TypedDict
+
+__version__ = "0.2.0"
+
+
+class Pair(TypedDict):
+    usage: float | None
+    temp: float | None
+
+
+class Sample(TypedDict):
+    v: int
+    cpu: dict[str, float | None]
+    memory: dict[str, float | None]
+    gpu: dict[str, float | None]
+    disk: dict[str, float | None]
+    net: dict[str, float | None]
+
+
+def socket_path() -> Path:
+    """Return the daemon socket used by the current platform."""
+    if sys.platform == "darwin":
+        return Path.home() / "Library/Caches/rldyour-sysinfo/rldyour-sysinfo.sock"
+    if os.name == "nt":
+        root = os.environ.get("LOCALAPPDATA") or os.environ.get("TEMP")
+        if not root:
+            raise RuntimeError("LOCALAPPDATA and TEMP are unset")
+        return Path(root) / "rldyour-sysinfo/rldyour-sysinfo.sock"
+    runtime = os.environ.get("XDG_RUNTIME_DIR")
+    if not runtime:
+        runtime = f"/run/user/{os.getuid()}"
+    return Path(runtime) / "rldyour-sysinfo.sock"
+
+
+def _decode(line: bytes) -> Sample:
+    value: Any = json.loads(line)
+    required = {"v", "cpu", "memory", "gpu", "disk", "net"}
+    if not isinstance(value, dict) or set(value) != required or value.get("v") != 1:
+        raise ValueError("unsupported rldyour-sysinfo sample")
+    return value
+
+
+def samples(interval: float = 5, path: str | os.PathLike[str] | None = None) -> Iterator[Sample]:
+    """Yield live samples until the connection closes."""
+    if not 1 <= interval <= 60:
+        raise ValueError("interval must be between 1 and 60 seconds")
+    with socket.socket(socket.AF_UNIX) as connection:
+        connection.connect(str(Path(path) if path is not None else socket_path()))
+        connection.sendall(json.dumps({"interval": interval}).encode() + b"\n")
+        with connection.makefile("rb") as stream:
+            for line in stream:
+                yield _decode(line)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Read live rldyour-sysinfo metrics")
+    parser.add_argument("--interval", type=float, default=5)
+    parser.add_argument("--once", action="store_true")
+    args = parser.parse_args()
+    for sample in samples(args.interval):
+        print(json.dumps(sample, separators=(",", ":")), flush=True)
+        if args.once:
+            break

rldyour_sysinfo-0.2.0/tests/test_client.py

@@ -0,0 +1,20 @@
+import json
+
+import pytest
+
+from rldyour_sysinfo import _decode, samples
+
+
+def test_decode_accepts_protocol_v1():
+    value = {"v": 1, "cpu": {}, "memory": {}, "gpu": {}, "disk": {}, "net": {}}
+    assert _decode(json.dumps(value).encode()) == value
+
+
+def test_decode_rejects_unknown_shape():
+    with pytest.raises(ValueError):
+        _decode(b'{"v":2}')
+
+
+def test_interval_is_bounded_before_connecting():
+    with pytest.raises(ValueError):
+        next(samples(0))