summaryrefslogtreecommitdiff
path: root/docs/next-tests.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/next-tests.md')
-rw-r--r--docs/next-tests.md23
1 files changed, 18 insertions, 5 deletions
diff --git a/docs/next-tests.md b/docs/next-tests.md
index 3f85e030..4cf2c1fb 100644
--- a/docs/next-tests.md
+++ b/docs/next-tests.md
@@ -15,11 +15,24 @@ agent's survey. The `e2e` line (kbdin, mousein) is its first step.
- **T1, in-process 9P, is the main tier.** The core is driven only through
`serveFs` (src/ninep/testing.zig's `call`, `rd`, `wr`): as behavioural
as a client on a socket, and milliseconds a case.
-- **Process-level tests (T2) get a Zig runner, not Python:** test/snapshot.zig,
- the `.snap` runner, which already forks the app in a pty and has a 9P
- client (`snap9p`), grows 9P verbs (`9pwrite`, `9pexpect`, `signal`). The
- Python suites (test/fs.py and the rest) stay as examples of scripting a
- session and are not grown.
+- **One process runner, not Python (the user, 2026-11-04):** test/process.zig's
+ `Process` starts `pardes` detached (over its socket), in a pty, or as the
+ hidden window, in a throwaway root, and talks 9P to it with Session's
+ method names (`read`, `write`, `refused`, `keys`, `click`, `screen`,
+ `focused`), plus `signal`, the exit code, pty bytes and captured frames
+ by mode. It is mostly test/snapshot.zig's launching and 9P client moved
+ out:
+ - **the `.snap` scripts** become one user of it (the interpreter and the
+ goldens stay in snapshot.zig);
+ - **process tests (T2)** are plain Zig tests in test/process/<label>.zig,
+ under a `process-test` step;
+ - **the window's tests (T4)** are `Process` in its window mode.
+
+ The Python suites in the build (fs.py, monkey9p.py, gui_monkey.py,
+ v9fs*.py, agent_session_test.py) move onto it or onto Session, then
+ leave the build. The developer tools (ui_review, record_demos,
+ appearance_gallery…) stay Python, as examples. A real process performs
+ its effects, so tests that need one can land at T2.
- **Layout (from a ponytail review, 2026-11-03):**
- **test/session.zig is the T1 `Session`:** a 9P client's walk, open,
read or write, clunk, by path, with the core opaque.