Add example test scripts and consumer documentation #5

New issue

Closed

opened 2026-05-14 04:47:39 +00:00 by Mark · 0 comments

Mark commented

2026-05-14 04:47:39 +00:00

Owner

The examples/ directory has shell scripts (test_binary.sh, test_apt.sh, etc.) but no actual Python test examples showing how to use the DesktopSession API.

Add:

examples/test_xclock.py — launch xclock, take screenshot, find "Quit" button
examples/test_gedit.py — open gedit, type text, save file
examples/test_firefox.py — launch Firefox, navigate to URL, take screenshot
examples/README.md — explain how to run each example

Also document:

How to mount host apps/binaries into the container
How to capture screenshots back to the host
How to stream action logs to the host

Why: New users need concrete, runnable examples to understand the API surface and container workflow.

The `examples/` directory has shell scripts (`test_binary.sh`, `test_apt.sh`, etc.) but no actual Python test examples showing how to use the `DesktopSession` API. Add: - `examples/test_xclock.py` — launch xclock, take screenshot, find "Quit" button - `examples/test_gedit.py` — open gedit, type text, save file - `examples/test_firefox.py` — launch Firefox, navigate to URL, take screenshot - `examples/README.md` — explain how to run each example Also document: - How to mount host apps/binaries into the container - How to capture screenshots back to the host - How to stream action logs to the host **Why:** New users need concrete, runnable examples to understand the API surface and container workflow.