mirror of
https://github.com/jamesstringer90/appsandbox.git
synced 2026-10-22 02:52:49 -05:00
James Stringer
4087baa4bf
Headless mode: `appsandbox.exe --headless` runs a single-owner daemon that hosts the core over a loopback HTTP/JSON API (http.sys) with a host.json discovery file. A dependency-free Python SDK, examples, and a self-contained regression suite live under tools/headless-api/ (PLAN.md = design rationale). The API mirrors the GUI: create/start/shutdown/stop/delete/edit, snapshots and branches (incl. base branches via the new asb_snap_base_branch_count), templates, sshInfo, an SSE /v1/events stream, GUI-mirrored input validation, a startup fail-fast (admin / Win11 build / VirtualMachinePlatform), and a single-instance mutex shared with the GUI so only one of GUI/headless runs at a time. SSH key deploy: sshDeployKey (requires sshEnabled) has the core generate an AppSandbox ed25519 keypair once and the guest agent write the public key into authorized_keys -- Windows administrators_authorized_keys (+ ACL), Linux/macOS ~/.ssh -- reporting a new ssh_key_deployed status (sshState 4). The GUI SSH button and the SDK use the key for password-less login. Verified end-to-end on Windows. The Linux guest builds its agent/driver source from this branch's GitHub repo; asb_core.c points the prefetch at "headless-api" (revert to "main" before merge, see PLAN.md).
26 lines
909 B
Python
26 lines
909 B
Python
"""
|
|
Stream daemon events (Server-Sent Events) and print them as they arrive. The
|
|
daemon pushes a small JSON object per event (vmStateChanged, agentOnline, build
|
|
progress, etc.). This blocks forever -- Ctrl-C to stop.
|
|
|
|
python examples/stream_events.py
|
|
|
|
Events are a convenience for live UIs. For control flow, poll status()/wait():
|
|
they read the current state each call, so a dropped connection never loses a
|
|
transition.
|
|
"""
|
|
import sys, os
|
|
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
import asb
|
|
|
|
c = asb.connect()
|
|
print("streaming events (Ctrl-C to stop)...")
|
|
try:
|
|
for ev in c.events():
|
|
name = ev.get("name", "")
|
|
kind = ev.get("event", ev.get("raw", "?"))
|
|
print(" %-18s %-14s %s" % (kind, name, {k: v for k, v in ev.items()
|
|
if k not in ("event", "name")}))
|
|
except KeyboardInterrupt:
|
|
pass
|