Skip to content

sam701/zig-toml

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

zig-toml

Zig TOML v1.0.0 parser.

This is a top-down LL parser that parses directly into Zig structs.

Features

  • TOML Syntax
    • Integers, hexadecimal, octal, and binary numbers
    • Floats
    • Booleans
    • Comments
    • Arrays
    • Tables
    • Array of Tables
    • Inline Table
    • Single-line strings
    • String escapes (also unicode)
    • Multi-line strings
    • Multi-line string leading space trimming
    • Trailing backslash in multi-line strings
    • Date, time, date-time, time offset
  • Struct mapping
    • Mapping to structs
    • Mapping to enums
    • Mapping to slices
    • Mapping to arrays
    • Mapping to pointers
    • Mapping to integer and floats with lower bit number than defined by TOML, i.e. i16, f32.
    • Mapping to optional fields
    • Mapping to HashMaps

Example

See example1.zig for the complete code that parses example.toml

Run it with zig build examples

// .... 

const Address = struct {
    port: i64,
    host: []const u8,
};

const Config = struct {
    master: bool,
    expires_at: toml.DateTime,
    description: []const u8,

    local: *Address,
    peers: []const Address,
};

pub fn main() anyerror!void {
    var parser = toml.Parser(Config).init(allocator);
    defer parser.deinit();

    var result = try parser.parseFile("./examples/example1.toml");
    defer result.deinit();

    const config = result.value;
    std.debug.print("{s}\nlocal address: {s}:{}\n", .{ config.description, config.local.host, config.local.port });
    std.debug.print("peer0: {s}:{}\n", .{ config.peers[0].host, config.peers[0].port });
}

Error Handling

TODO

License

MIT