refactor(zig-cookbook): adopt Zig 0.16 I/O system (#122)

Refactor main entry points to accept std.process.Init. Migrate file I/O,
networking, and crypto operations to use the new std.Io interface.
Removes zigcli dependency and bumps minimum Zig version to 0.16.0.

Author: jiacai2050

.gitignore

@@ -1,6 +1,7 @@
 public/
 zig-out/
 zig-cache/
+zig-pkg/
 .zig-cache/
 .DS_Store
 .tool-versions

CLAUDE.md

@@ -0,0 +1 @@
+GEMINI.md

GEMINI.md

@@ -0,0 +1,47 @@
+# Zig Cookbook - Project Context
+
+## Project Overview
+`zig-cookbook` is a multilingual collection of Zig (0.16.x) programming recipes and examples. It demonstrates common programming tasks using Zig's standard library and specialized packages. The project generates a static documentation website using the [zine](https://zine-ssg.io) static site generator.
+
+## Key Technologies
+- **Zig (0.16.0)**: The primary programming language.
+- **Zine**: Static site generator for documentation.
+- **Docker**: Used for running databases (Postgres, MySQL) required by some examples.
+- **system dependencies**: Some examples link against C libraries like `libpq`, `mysqlclient`, and `sqlite3`.
+
+## Directory Structure
+- `assets/src/`: Contains all Zig example source files (e.g., `01-01.zig`).
+- `src/`: Contains localized documentation in Super Markdown (`.smd`) format, organized by language (`en-US`, `zh-CN`).
+- `lib/`: C header files and helper source code for C interop examples.
+- `layouts/`: Templates and UI components for the documentation website.
+- `i18n/`: Internationalization configuration files (`.ziggy`).
+
+## Building and Running
+The project uses the standard Zig build system.
+
+### Running Examples
+- **Specific Example**: `zig build run-{chapter}-{seq}` (e.g., `zig build run-01-01`).
+- **All Examples**: `zig build run-all`.
+- **Compile Check**: `zig build check`.
+
+### Local Documentation
+- **Preview Site**: `make serve` (starts `zine` on port 1313).
+- **Zine Preview**: Alternatively, use `zine` directly.
+
+### Dependencies & Environment
+- **Install System Libraries**: `make install-deps` (supports macOS via brew and Linux via apt).
+- **Databases**: `docker-compose up -d` to start the required Postgres and MySQL instances.
+- **Environment Variables**: `source env.sh` may be required on some systems to set `PKG_CONFIG_PATH` for database clients.
+
+## Development Conventions
+- **Zig Version**: Targets Zig 0.16.x. Adheres to modern Zig idioms like `std.Io` and `std.process.Init` entry points.
+- **Testing**: Many examples include `std.testing` assertions within their `main` or as helper blocks to verify correctness.
+- **C Interop**: Uses `b.addTranslateC` in `build.zig` to interface with C libraries.
+- **Formatting**: The project uses `prettier` for linting `.smd` files (via `make lint`).
+
+## Project-Specific Tips
+- When adding a new recipe:
+  1. Add the Zig code to `assets/src/`.
+  2. Create corresponding `.smd` files in `src/en-US/` and `src/zh-CN/`.
+  3. Update `build.zig` if the example has special library dependencies.
+- Use `std.debug.print` for output in examples as they are meant for learning.

README-zh.md

@@ -9,7 +9,7 @@
 
 [Zig Cookbook](https://github.com/zigcc/zig-cookbook) 是一系列简单的 Zig 示例程序合集，展示了完成常见编程任务的良好实践。
 
-> - 主分支跟踪 Zig 0.15.x，并通过 GitHub Actions 在 Linux 和 macOS 上进行测试。
+> - 主分支跟踪 Zig 0.16.x，并通过 GitHub Actions 在 Linux 和 macOS 上进行测试。
 > - 更早版本的 Zig 支持可以在[其他分支](https://github.com/zigcc/zig-cookbook/branches)中找到。
 
 # 如何使用

README.md

@@ -11,7 +11,7 @@
 
 [Zig cookbook](https://github.com/zigcc/zig-cookbook) is a collection of simple Zig programs that demonstrate good practices to accomplish common programming tasks.
 
-> - Main branch tracks Zig 0.15.x, and is tested on Linux and macOS via GitHub actions.
+> - Main branch tracks Zig 0.16.x, and is tested on Linux and macOS via GitHub actions.
 > - Earlier Zig support could be found in [other branches](https://github.com/zigcc/zig-cookbook/branches).
 
 # How to use

assets/src/01-01.zig

@@ -1,13 +1,14 @@
 const std = @import("std");
-const fs = std.fs;
 const print = std.debug.print;
 
-pub fn main() !void {
-    const file = try fs.cwd().openFile("tests/zig-zen.txt", .{});
-    defer file.close();
+pub fn main(init: std.process.Init) !void {
+    const io = init.io;
+
+    const file = try std.Io.Dir.cwd().openFile(io, "tests/zig-zen.txt", .{});
+    defer file.close(io);
 
     var file_buffer: [4096]u8 = undefined;
-    var reader = file.reader(&file_buffer);
+    var reader = file.reader(io, &file_buffer);
     var line_no: usize = 0;
     while (try reader.interface.takeDelimiter('\n')) |line| {
         line_no += 1;

assets/src/01-02.zig

@@ -1,33 +1,32 @@
 const std = @import("std");
-const fs = std.fs;
-const print = std.debug.print;
 
 const filename = "/tmp/zig-cookbook-01-02.txt";
 
-pub fn main() !void {
+pub fn main(init: std.process.Init) !void {
     if (.windows == @import("builtin").os.tag) {
         std.debug.print("MMap is not supported in Windows\n", .{});
         return;
     }
 
-    const file = try fs.cwd().createFile(filename, .{
+    const io = init.io;
+    const file = try std.Io.Dir.cwd().createFile(io, filename, .{
         .read = true,
         .truncate = true,
         .exclusive = false, // Set to true will ensure this file is created by us
     });
-    defer file.close();
+    defer file.close(io);
     const content_to_write = "hello zig cookbook";
 
     // Before mmap, we need to ensure file isn't empty
-    try file.setEndPos(content_to_write.len);
+    try file.setLength(io, content_to_write.len);
 
-    const md = try file.stat();
+    const md = try file.stat(io);
     try std.testing.expectEqual(md.size, content_to_write.len);
 
     const ptr = try std.posix.mmap(
         null,
         content_to_write.len,
-        std.posix.PROT.READ | std.posix.PROT.WRITE,
+        .{ .READ = true, .WRITE = true },
         .{ .TYPE = .SHARED },
         file.handle,
         0,

assets/src/01-03.zig

@@ -1,30 +1,27 @@
 //! Find files that have been modified in the last 24 hours
 
 const std = @import("std");
-const builtin = @import("builtin");
-const fs = std.fs;
 const print = std.debug.print;
 
-pub fn main() !void {
-    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
-    defer _ = gpa.deinit();
-    const allocator = gpa.allocator();
+pub fn main(init: std.process.Init) !void {
+    const gpa = init.gpa;
+    const io = init.io;
 
-    var iter_dir = try fs.cwd().openDir("src", .{ .iterate = true });
-    defer iter_dir.close();
+    var iter_dir = try std.Io.Dir.cwd().openDir(io, "src", .{ .iterate = true });
+    defer iter_dir.close(io);
 
-    var walker = try iter_dir.walk(allocator);
+    var walker = try iter_dir.walk(gpa);
     defer walker.deinit();
 
-    const now = std.time.nanoTimestamp();
-    while (try walker.next()) |entry| {
+    const now_ns = std.Io.Clock.real.now(io).nanoseconds;
+    while (try walker.next(io)) |entry| {
         if (entry.kind != .file) {
             continue;
         }
 
-        const stat = try iter_dir.statFile(entry.path);
-        const last_modified = stat.mtime;
-        const duration = now - last_modified;
+        const stat = try iter_dir.statFile(io, entry.path, .{});
+        const last_modified = stat.mtime.nanoseconds;
+        const duration = now_ns - last_modified;
         if (duration < std.time.ns_per_hour * 24) {
             print("Last modified: {d} seconds ago, size:{d} bytes, filename: {s}\n", .{
                 @divTrunc(duration, std.time.ns_per_s),

assets/src/01-04.zig

@@ -1,12 +1,12 @@
 //! Test file/directory existence
 
 const std = @import("std");
-const fs = std.fs;
 
-pub fn main() !void {
+pub fn main(init: std.process.Init) !void {
+    const io = init.io;
     const filename = "build.zig";
     var found = true;
-    fs.cwd().access(filename, .{}) catch |e| switch (e) {
+    std.Io.Dir.cwd().access(io, filename, .{}) catch |e| switch (e) {
         error.FileNotFound => found = false,
         else => return e,
     };

assets/src/01-05.zig

@@ -1,20 +1,18 @@
 const std = @import("std");
-const fs = std.fs;
 const print = std.debug.print;
 
-pub fn main() !void {
-    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
-    defer if (gpa.deinit() != .ok) @panic("leak");
-    const allocator = gpa.allocator();
+pub fn main(init: std.process.Init) !void {
+    const gpa = init.gpa;
+    const io = init.io;
 
     // In order to walk the directry, `iterate` must be set to true.
-    var dir = try fs.cwd().openDir("zig-out", .{ .iterate = true });
-    defer dir.close();
+    var dir = try std.Io.Dir.cwd().openDir(io, "zig-out", .{ .iterate = true });
+    defer dir.close(io);
 
-    var walker = try dir.walk(allocator);
+    var walker = try dir.walk(gpa);
     defer walker.deinit();
 
-    while (try walker.next()) |entry| {
+    while (try walker.next(io)) |entry| {
         print("path: {s}, basename:{s}, type:{s}\n", .{
             entry.path,
             entry.basename,