forest-cli 0.1.0__py3-none-any.whl

forest/__init__.py

@@ -0,0 +1,16 @@
+"""forest — git-like data management for arbitrary data trees.
+
+Forest is a self-contained, domain-agnostic data-sync engine: workspace
+initialization, named checkouts (focus), remotes, local bindings,
+push/pull/status/ls, and sync state. It knows nothing about what the data
+means — it syncs and inspects whatever files live in a unit.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("forest")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

forest/analytics.py

@@ -0,0 +1,29 @@
+"""Opt-in local usage analytics for forest commands.
+
+No-op unless ``FOREST_ANALYTICS_FILE`` is set; events are appended as JSON
+lines to that local file only — nothing leaves the machine. Eager options
+(``--help``/``--version``) exit during parsing and are not recorded.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+from forest import __version__
+from forest.logger import get_run_id
+from forest.metrics import append_jsonl
+
+
+def record_command(command: str, *, duration_seconds: float, status: str) -> None:
+    """Append one command-usage event. Never raises."""
+    append_jsonl(
+        "FOREST_ANALYTICS_FILE",
+        {
+            "ts": datetime.now(tz=timezone.utc).isoformat(),
+            "command": command,
+            "duration_seconds": round(duration_seconds, 3),
+            "status": status,  # "success" | "error"
+            "run_id": get_run_id(),
+            "version": __version__,
+        },
+    )