require Zig 0.15.x or later

Author: Techatrix

.github/workflows/build.yml

@@ -12,20 +12,14 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        zig-version: [master]
         os: [ubuntu-latest, macos-latest, windows-latest]
-        include:
-          - zig-version: "0.14.1"
-            os: ubuntu-latest
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
       - name: Setup Zig
         uses: mlugg/setup-zig@v2
-        with:
-          version: master
 
       - name: Run zig fmt
         if: matrix.os == 'ubuntu-latest'

README.md

@@ -47,7 +47,7 @@ pub fn getPath(allocator: std.mem.Allocator, folder: KnownFolder) Error!?[]const
 ## Installation
 
 > [!NOTE]
-> The minimum supported Zig version is `0.14.0`.
+> The supported Zig version is `0.15.x`.
 
 Initialize a `zig build` project if you haven't already.
 

build.zig.zon

@@ -1,7 +1,7 @@
 .{
     .name = .known_folders,
     .version = "0.0.0",
-    .minimum_zig_version = "0.14.0",
+    .minimum_zig_version = "0.15.2",
     .dependencies = .{},
     .paths = .{
         "build.zig",

known-folders.zig

@@ -344,11 +344,7 @@ const TestingSystem = struct {
             if (std.mem.eql(u8, key, kv.key)) return kv.value;
         }
         system.deinit();
-        if (@hasDecl(std.zig, "fmtString")) {
-            std.debug.panic("the result of `getenv(\"{f}\")` must explicitly specified in the TestingSystem", .{std.zig.fmtString(key)});
-        } else {
-            std.debug.panic("the result of `getenv(\"{}\")` must explicitly specified in the TestingSystem", .{std.zig.fmtEscapes(key)});
-        }
+        std.debug.panic("the result of `getenv(\"{f}\")` must explicitly specified in the TestingSystem", .{std.zig.fmtString(key)});
     }
 
     /// Asserts that the file is specified in `TestingSystem.files`.
@@ -360,11 +356,7 @@ const TestingSystem = struct {
             if (std.mem.eql(u8, file_path, kv.path)) break kv;
         } else {
             system.deinit();
-            if (@hasDecl(std.zig, "fmtString")) {
-                std.debug.panic("`openFile(\"{0f}\", \"{1f}\")` has been called on an unexpected file", .{ std.zig.fmtString(dir_path), std.zig.fmtString(sub_path) });
-            } else {
-                std.debug.panic("`openFile(\"{0}\", \"{1}\")` has been called on an unexpected file", .{ std.zig.fmtEscapes(dir_path), std.zig.fmtEscapes(sub_path) });
-            }
+            std.debug.panic("`openFile(\"{0f}\", \"{1f}\")` has been called on an unexpected file", .{ std.zig.fmtString(dir_path), std.zig.fmtString(sub_path) });
         };
 
         const data = kv.data orelse return error.FileNotFound;
@@ -451,7 +443,7 @@ fn xdgUserDirLookup(
     defer file.close();
 
     var buffer: [xdg_user_dir_lookup_line_buffer_size + 1]u8 = undefined;
-    var line_it: if (@hasDecl(std.fs.File, "stdin")) LineIterator else OldLineIterator = .init(file);
+    var line_it: LineIterator = .init(file);
 
     var user_dir: ?[]u8 = null;
     while (try line_it.next(&buffer)) |line_capture| {
@@ -536,48 +528,6 @@ fn xdgUserDirLookup(
     return user_dir;
 }
 
-const OldLineIterator = struct {
-    fbr: std.io.BufferedReader(4096, std.fs.File.Reader),
-
-    fn init(file: std.fs.File) OldLineIterator {
-        return .{
-            .fbr = std.io.bufferedReader(file.reader()),
-        };
-    }
-
-    fn next(it: *OldLineIterator, buffer: []u8) std.posix.ReadError!?[:0]const u8 {
-        const reader = it.fbr.reader();
-
-        // Similar to `readUntilDelimiterOrEof` but also writes a null-terminator
-        for (buffer, 0..) |*out, index| {
-            const byte = reader.readByte() catch |err| switch (err) {
-                error.EndOfStream => if (index == 0) return null else '\n',
-                else => |e| return e,
-            };
-            if (byte == '\n') {
-                out.* = 0;
-                return buffer[0..index :0];
-            }
-            out.* = byte;
-        } else {
-            // This happens when the line is longer than 511 characters
-            // There are four possible ways to handle this:
-            //  - use dynamic allocation to acquire enough storage
-            //  - return an error
-            //  - skip the line
-            //  - truncate the line
-            //
-            // The xdg-user-dir implementation chooses to trunacte the line.
-            // See "getPath - user-dirs.dirs - very long line" test
-
-            try reader.skipUntilDelimiterOrEof('\n');
-
-            buffer[buffer.len - 1] = 0;
-            return buffer[0 .. buffer.len - 1 :0];
-        }
-    }
-};
-
 const LineIterator = struct {
     file_reader: std.fs.File.Reader,
     keep_reading: bool,