Commit 3f9fe9e28f83119f8ecf2fdafcd12967417634e9 | zig

author	Andrew Kelley <andrew@ziglang.org> 2026-09-18 22:02:45+02:00
committer	Andrew Kelley <andrew@ziglang.org> 2026-09-18 22:02:45+02:00
log	3f9fe9e28f83119f8ecf2fdafcd12967417634e9
tree	0027863d7bf1aa63d959eb39082e74a1adaf68b4
parent	80fe9b2b7fc981166cbfe98165e17dad6107cb34
parent	c106e2759578e787e5be235c8f6b227623ff2c3b

Merge pull request 'std.Build.Step.Options: add addOptionPathDirectory' (#36876) from std.Build.Step.Options into master

Reviewed-on: https://codeberg.org/ziglang/zig/pulls/36876

5 files changed, 78 insertions(+), 32 deletions(-)

lib
- compiler
  - Maker
    Step
    Options.zig
- std
  - Build
    Cache.zig
    Configuration.zig
    Serialize.zig
    Step
    Options.zig

lib/compiler/Maker/Step/Options.zig+16-3

 @@ -30,7 +30,7 @@ pub fn make(
     // generated zig file are observable by dependant steps.
     // Pathnames added to Options.args are assumed to be generated files whose
     // contents are also observable, while pathnames added to
-    // Options.args_untracked are treated as pure path string data with no
+    // Options.untracked_paths are treated as pure path string data with no
     // tracking of the path's state or contents.
     step.clearWatchInputs(maker);
 @@ -40,7 +40,7 @@ pub fn make(
     var args_bytes: std.ArrayList(u8) = .empty;
-    for (conf_options.args.slice) |arg| {
+    for (conf_options.files.slice) |arg| {
         const name = arg.name.slice(conf);
         const lazy_path = arg.path.get(conf);
         try step.addWatchInput(maker, arena, lazy_path);
 @@ -51,7 +51,20 @@ pub fn make(
         });
     }
-    for (conf_options.args_untracked.slice) |arg| {
+    for (conf_options.directories.slice) |arg| {
+        const name = arg.name.slice(conf);
+        const lazy_path = arg.path.get(conf);
+        _ = try step.addDirectoryWatchInput(maker, lazy_path);
+        const arg_path = try maker.resolveLazyPath(arena, lazy_path, step_index);
+        _ = try man.addInputPath(arg_path, .{
+            .handle = .{ .dir = null },
+        });
+        try args_bytes.print(arena, "pub const {f}: []const u8 = \"{f}\";\n", .{
+            std.zig.fmtId(name), arg_path.fmtEscapeString(),
+        });
+    }
+    for (conf_options.untracked_paths.slice) |arg| {
         const name = arg.name.slice(conf);
         const lazy_path = arg.path.get(conf);
         const arg_path = try maker.resolveLazyPath(arena, lazy_path, step_index);

lib/std/Build/Cache.zig+8-3

lib/std/Build/Configuration.zig+8-6

 @@ -1378,19 +1378,21 @@ pub const Step = extern struct {
         flags: @This().Flags,
         generated_file: GeneratedFileIndex,
         contents: Bytes,
-        args: Storage.FlagLengthPrefixedList(.flags, .args, Arg),
+        files: Storage.FlagLengthPrefixedList(.flags, .files, NamedPath),
-        args_untracked: Storage.FlagLengthPrefixedList(.flags, .args_untracked, Arg),
+        directories: Storage.FlagLengthPrefixedList(.flags, .directories, NamedPath),
+        untracked_paths: Storage.FlagLengthPrefixedList(.flags, .untracked_paths, NamedPath),
-        pub const Arg = extern struct {
+        pub const NamedPath = extern struct {
             name: String,
             path: LazyPath.Index,
         };
         pub const Flags = packed struct(u32) {
             tag: Tag = .options,
-            args: bool,
+            files: bool,
-            args_untracked: bool,
+            directories: bool,
-            _: u25 = 0,
+            untracked_paths: bool,
+            _: u24 = 0,
         };
     };

lib/std/Build/Serialize.zig+16-8

 @@ -648,27 +648,35 @@ pub fn write(b: *std.Build, wc: *Configuration.Wip, writer: *std.Io.Writer) !voi
                     .options => e: {
                         const so: *Step.Options = @fieldParentPtr("step", step);
-                        const args = try arena.alloc(Configuration.Step.Options.Arg, so.args.items.len);
+                        const files = try arena.alloc(Configuration.Step.Options.NamedPath, so.files.items.len);
-                        for (args, so.args.items) |*dest, src| dest.* = .{
+                        for (files, so.files.items) |*dest, src| dest.* = .{
                             .name = src.name,
                             .path = try s.addLazyPath(src.path),
                         };
-                        const args_untracked = try arena.alloc(Configuration.Step.Options.Arg, so.args_untracked.items.len);
+                        const directories = try arena.alloc(Configuration.Step.Options.NamedPath, so.directories.items.len);
-                        for (args_untracked, so.args_untracked.items) |*dest, src| dest.* = .{
+                        for (directories, so.directories.items) |*dest, src| dest.* = .{
+                            .name = src.name,
+                            .path = try s.addLazyPath(src.path),
+                        };
+                        const untracked_paths = try arena.alloc(Configuration.Step.Options.NamedPath, so.untracked_paths.items.len);
+                        for (untracked_paths, so.untracked_paths.items) |*dest, src| dest.* = .{
                             .name = src.name,
                             .path = try s.addLazyPath(src.path),
                         };
                         break :e try wc.addExtraErased(Configuration.Step.Options, .{
                             .flags = .{
-                                .args = so.args.items.len != 0,
+                                .files = so.files.items.len != 0,
-                                .args_untracked = so.args_untracked.items.len != 0,
+                                .directories = so.directories.items.len != 0,
+                                .untracked_paths = so.untracked_paths.items.len != 0,
                             },
                             .generated_file = so.generated_file,
                             .contents = try wc.addBytes(so.contents.items),
-                            .args = .{ .slice = args },
+                            .files = .{ .slice = files },
-                            .args_untracked = .{ .slice = args_untracked },
+                            .directories = .{ .slice = directories },
+                            .untracked_paths = .{ .slice = untracked_paths },
                         });
                     },
                 })),

lib/std/Build/Step/Options.zig+30-12

 @@ -12,13 +12,14 @@ const Configuration = std.Build.Configuration;
 step: Step,
 generated_file: Configuration.GeneratedFileIndex,
 contents: std.ArrayList(u8) = .empty,
-args: std.ArrayList(Arg) = .empty,
+files: std.ArrayList(NamedPath) = .empty,
-args_untracked: std.ArrayList(Arg) = .empty,
+directories: std.ArrayList(NamedPath) = .empty,
+untracked_paths: std.ArrayList(NamedPath) = .empty,
 encountered_types: std.StringHashMapUnmanaged(void),
 pub const base_tag: Step.Tag = .options;
-pub const Arg = struct {
+pub const NamedPath = struct {
     name: Configuration.String,
     path: LazyPath,
 };
 @@ -421,28 +422,45 @@ fn printStructValue(
     }
 }
-/// The added option has type `[]const u8` and value of the provided path.
+/// The added option has type `[]const u8` and value of the provided file path. If the provided path is a
-/// This interface assumes the provided path is a generated file, and causes a
+/// generated file, causes a transitive dependency on the file's contents.
-/// transitive dependency through Options on the file's contents.
 ///
 /// See also:
+/// * `addOptionPathDirectory`
 /// * `addOptionPathUntracked`
 pub fn addOptionPath(options: *Options, name: []const u8, path: LazyPath) void {
     const graph = options.step.owner.graph;
     const arena = graph.arena;
     const wc = &graph.wip_configuration;
-    options.args.append(arena, .{
+    options.files.append(arena, .{
         .name = wc.addString(name) catch @panic("OOM"),
         .path = path.dupe(options.step.owner.graph),
     }) catch @panic("OOM");
     path.addStepDependencies(&options.step);
 }
-/// The added option has type `[]const u8` and value of the provided path.
+/// The added option has type `[]const u8` and value of the provided directory path. Causes a transitive
-/// This interface treats the resolved path string as pure data, meaning it
+/// dependency through Options on the directory's contents.
-/// does not track anything about the meaning or contents of this path, and
+///
-/// therefore also does not create any related dependencies.
+/// See also:
+/// * `addOptionPath`
+/// * `addOptionPathUntracked`
+pub fn addOptionPathDirectory(options: *Options, name: []const u8, path: LazyPath) void {
+    const graph = options.step.owner.graph;
+    const arena = graph.arena;
+    const wc = &graph.wip_configuration;
+    options.directories.append(arena, .{
+        .name = wc.addString(name) catch @panic("OOM"),
+        .path = path.dupe(options.step.owner.graph),
+    }) catch @panic("OOM");
+    path.addStepDependencies(&options.step);
+}
+/// The added option has type `[]const u8` and value of the provided path. The resolved path is interpreted as
+/// a string without tracking anything about the meaning or contents, and therefore may be a file, directory,
+/// not exist, or even be an invalid path, and likewise does not create any file system or `Step` dependencies.
 ///
 /// See also:
 /// * `addOptionPath`
 @@ -451,7 +469,7 @@ pub fn addOptionPathUntracked(options: *Options, name: []const u8, path: LazyPat
     const arena = graph.arena;
     const wc = &graph.wip_configuration;
-    options.args_untracked.append(arena, .{
+    options.untracked_paths.append(arena, .{
         .name = wc.addString(name) catch @panic("OOM"),
         .path = path.dupe(options.step.owner.graph),
     }) catch @panic("OOM");

...	@@ -514,6 +514,11 @@ pub const Manifest = struct {	...	@@ -514,6 +514,11 @@ pub const Manifest = struct {
514	pub fn path(off: File.Offset, contents: []const u8) [:0]const u8 {	514	pub fn path(off: File.Offset, contents: []const u8) [:0]const u8 {
515	return pathFallible(off, contents) catch unreachable;	515	return pathFallible(off, contents) catch unreachable;
516	}	516	}
		517
		518	pub fn pathOrDot(off: File.Offset, contents: []const u8) [:0]const u8 {
		519	const p = pathFallible(off, contents) catch unreachable;
		520	return if (p.len == 0) "." else p;
		521	}
517	};	522	};
518		523
519	/// Intentionally matches if the files are different only by flags other than prefix.	524	/// Intentionally matches if the files are different only by flags other than prefix.
...	@@ -1176,7 +1181,7 @@ pub const Manifest = struct {	...	@@ -1176,7 +1181,7 @@ pub const Manifest = struct {
1176	const io = cache.io;	1181	const io = cache.io;
1177	const input_file = file_off.get(contents);	1182	const input_file = file_off.get(contents);
1178	const parent_dir = cache.prefixes()[input_file.flags.prefix].handle;	1183	const parent_dir = cache.prefixes()[input_file.flags.prefix].handle;
1179	const file_path = file_off.path(contents);	1184	const file_path = file_off.pathOrDot(contents);
1180	const gpa = cache.gpa;	1185	const gpa = cache.gpa;
1181		1186
1182	if (input_path.have_digest) return;	1187	if (input_path.have_digest) return;
...	@@ -1352,7 +1357,7 @@ pub const Manifest = struct {	...	@@ -1352,7 +1357,7 @@ pub const Manifest = struct {
1352	const disk_file = file_off.get(disk_contents);	1357	const disk_file = file_off.get(disk_contents);
1353	const input_file = file_off.get(input_contents);	1358	const input_file = file_off.get(input_contents);
1354	const parent_dir = cache.prefixes()[disk_file.flags.prefix].handle;	1359	const parent_dir = cache.prefixes()[disk_file.flags.prefix].handle;
1355	const file_path = file_off.path(disk_contents);	1360	const file_path = file_off.pathOrDot(disk_contents);
1356		1361
1357	assert(disk_file.flags == input_file.flags);	1362	assert(disk_file.flags == input_file.flags);
1358		1363
...	@@ -1536,7 +1541,7 @@ pub const Manifest = struct {	...	@@ -1536,7 +1541,7 @@ pub const Manifest = struct {
1536	const gpa = cache.gpa;	1541	const gpa = cache.gpa;
1537	const io = cache.io;	1542	const io = cache.io;
1538	const parent_dir = cache.prefixes()[file.flags.prefix].handle;	1543	const parent_dir = cache.prefixes()[file.flags.prefix].handle;
1539	const file_path = file_off.path(contents);	1544	const file_path = file_off.pathOrDot(contents);
1540		1545
1541	if (file.flags.metadata_only) {	1546	if (file.flags.metadata_only) {
1542	const actual_stat = parent_dir.statFile(io, file_path, .{}) catch \|err\| switch (err) {	1547	const actual_stat = parent_dir.statFile(io, file_path, .{}) catch \|err\| switch (err) {