diff options
| -rw-r--r-- | docs/next-tests.md | 23 |
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. |
