summaryrefslogtreecommitdiff
path: root/build.zig
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-16 23:37:54 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commitca602943e3fc9faad24e51497eeafb0ae7856800 (patch)
treedc35633094f5355d535587f388d6ffd3896dace1 /build.zig
parentc3b9938e9cb381bc7378fdca9073520ff1711ad6 (diff)
downloadsketchbook-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.zig39
1 files changed, 35 insertions, 4 deletions
diff --git a/build.zig b/build.zig
index f7a1aa9..809ddb1 100644
--- a/build.zig
+++ b/build.zig
@@ -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;