z-toml Is Stable and Passing

z-toml has reached the point where I am comfortable calling it stable for my own use. That does not mean finished forever. It means the main shape is there, the important pieces are tested, and I can start depending on it without feeling like every small change may break the whole design.

const src =
    \\title = "My App"
    \\[server]
    \\port = 8080
;
const root = try toml.parseSlice(gpa, src, null);
defer toml.deinit(root, gpa);

const port = root.get("server").?.table.get("port").?.integer.value;

I started z-toml because I wanted a TOML library I could understand, maintain, and use inside other Zig projects. I did not want configuration parsing to become a fragile side problem every time I worked on something that needed config files.

The main milestones: it parses TOML v1.1, writes TOML back out, supports typed parsing into Zig structs, and has an in-place rewriter for changing values without rebuilding the whole file ◆ The in-place rewriter is the feature I use most. It preserves comments and formatting for the parts of the file it does not touch, which means I can update a config value programmatically without blowing away the hand-written annotations around it. . It also passes the toml-test validation suite ◆ toml-test is the official TOML validation corpus maintained by the TOML project. Passing it means the parser handles edge cases like inline tables, array-of-tables, dotted keys, and the various datetime formats correctly. It is the closest thing to a conformance guarantee a TOML library can have. .

The library is starting to feel boring in the good way. I can parse a file, map it into a struct, write it back out, or rewrite one value by path. The tests pass. The behavior is documented enough that future me should not have to rediscover the whole project from scratch.

The project is small and it should stay small. It is not trying to become a full configuration framework. It parses, writes, preserves enough formatting for practical edits, and reports useful errors with line and column information. That is enough for now.