diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-16 23:37:54 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-17 12:15:01 -0300 |
| commit | ca602943e3fc9faad24e51497eeafb0ae7856800 (patch) | |
| tree | dc35633094f5355d535587f388d6ffd3896dace1 /build.zig | |
| parent | c3b9938e9cb381bc7378fdca9073520ff1711ad6 (diff) | |
| download | sketchbook-ca602943e3fc9faad24e51497eeafb0ae7856800.tar.gz sketchbook-ca602943e3fc9faad24e51497eeafb0ae7856800.zip | |
Keep a sketch's files in .sketchbook/, a shipped game's in XDG
zig build run, probe and export pass --state .sketchbook/<name>.state. The
host makes that directory with a .gitignore of * (a sessions database
grows, and the jj snapshot build_info takes would commit it while under a
megabyte), and moves the state and store an older build kept beside it in
once, with renameat2(NOREPLACE): when both exist nothing moves and the
host says so. Without --state an interactive run keeps its files in
$XDG_DATA_HOME/<name>/ (~/.local/share without it), not the cwd; a script
or an export still uses sketch.state. test-paths checks all three cases.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'build.zig')
| -rw-r--r-- | build.zig | 39 |
1 files changed, 35 insertions, 4 deletions
@@ -386,6 +386,35 @@ pub fn build(b: *Build) void { test_step.dependOn(&past.step); b.step("test-past", "Replay past sessions, to a time and across a code change").dependOn(&past.step); + // Where files go. Without --state: the XDG data directory, state and + // sessions. In .sketchbook/ (`zig build run`'s): a .gitignore, and an + // older build's state moved in, once, never over a file there. + const paths = b.addSystemCommand(&.{ "sh", "-c", + \\set -e + \\exe=$(realpath "$0"); lib=$(realpath "$1"); mkdir -p "$2"; d=$(realpath "$2") + \\rm -rf "$d"/* "$d"/.sketchbook; cd "$d" + \\XDG_DATA_HOME="$d/data" "$exe" --headless --console quit "$lib" + \\test -s data/replay/replay.state; test -s data/replay/replay.xitdb + \\"$exe" --headless --state replay.state --console "set updates 7" --console quit "$lib" + \\"$exe" --headless --state .sketchbook/replay.state --console quit "$lib" 2>err + \\grep -q moved err; test ! -e replay.state; test ! -e replay.state.store; grep -qx '*' .sketchbook/.gitignore + \\printf 'expect updates 7\n' >check.script + \\"$exe" --headless --state .sketchbook/replay.state --script check.script "$lib" + \\"$exe" --headless --state replay.state --console quit "$lib" + \\"$exe" --headless --state .sketchbook/replay.state --console quit "$lib" 2>err + \\grep -q 'both exist' err; test -e replay.state + \\"$exe" --headless --state .sketchbook/replay.state --script check.script "$lib" + \\rm -rf "$d"/* "$d"/.sketchbook + }); + paths.setName("state and sessions paths"); + paths.addArtifactArg(host_exe); + paths.addArtifactArg(recorded); + _ = paths.addOutputDirectoryArg("paths"); + paths.has_side_effects = true; + paths.expectExitCode(0); + test_step.dependOn(&paths.step); + b.step("test-paths", "Check where state and sessions files go").dependOn(&paths.step); + // Recorded input replays to the same state: played, seeked, stepped, // and after a live pointer move (core host behaviour, not an API). const replay = b.addRunArtifact(host_exe); @@ -1293,7 +1322,9 @@ pub const App = struct { } pub const RunOptions = struct { - /// State file, relative to the working directory. + /// State file, relative to the working directory; + /// `.sketchbook/<name>.state` by default, where the host keeps the + /// sessions database beside it, all ignored by git and jj. state: ?[]const u8 = null, /// Where relative asset paths resolve; the project root by default. cwd: ?Build.LazyPath = null, @@ -1306,7 +1337,7 @@ pub const App = struct { const install = b.addInstallArtifact(library, .{}); const run = b.addRunArtifact(app.sb.host_exe); run.step.dependOn(&install.step); - run.addArgs(&.{ "--state", options.state orelse b.fmt("{s}.state", .{app.name}) }); + run.addArgs(&.{ "--state", options.state orelse b.fmt(".sketchbook/{s}.state", .{app.name}) }); run.addFileArg(b.graph.path(.install_lib, library.out_filename)); run.setCwd(options.cwd orelse b.path(".")); run.stdio = .inherit; @@ -1377,7 +1408,7 @@ pub const App = struct { pub fn addProbe(app: App, state: ?[]const u8) *Build.Step.Run { const b = app.sb.b; const run = b.addRunArtifact(app.sb.probe_exe); - run.addArg(state orelse b.fmt("{s}.state", .{app.name})); + run.addArg(state orelse b.fmt(".sketchbook/{s}.state", .{app.name})); run.setCwd(b.path(".")); run.stdio = .inherit; run.addPassthruArgs(); @@ -1651,7 +1682,7 @@ pub const App = struct { // `--export` takes the first argument after `--`. const exporting = b.addRunArtifact(exe); - exporting.addArgs(&.{ "--state", b.fmt("{s}.state", .{app.name}), "--export" }); + exporting.addArgs(&.{ "--state", b.fmt(".sketchbook/{s}.state", .{app.name}), "--export" }); exporting.addPassthruArgs(); exporting.setCwd(b.path(".")); exporting.stdio = .inherit; |
