cZPeg generates recursive descent parsers at compile-time in Zig using a functional API inspired by LPeg to declare and compose patterns. There is also an re module for generating parsers from more compact PEG-style pattern strings. The compiled parser can then be used to match strings at runtime or comptime!

Make sure you have a recent Zig, we're currently testing with 0.8.0-dev drops from early 2021.

Until Zig's package distribution infrastructure has evolved, it's probably easiest to simply clone the contents of the czpeg/src/ tree into your project somewhere, then from your build.zig, add:

// build.zig

// if this is your LibExeObjStep
const exe = b.addExecutable(...);

// add new package like this
exe.addPackagePath("czpeg", "lib/czpeg.zig");

Now you can import and use the package in your project:

const std = @import("std");
const re = @import("czpeg").re;
test "greeting" {
    const pat = re.compile("'Hello' %s+ {%w+}'!'", .{});
    std.testing.expectEqualStrings("world", p.matchLean("Hello world!").?);
}

From the cZPeg root, run all available tests using the usual chant:

$ zig build test

It's a good idea to run this regularly as Zig matures to make sure everything stays in sync.

A brief interface comparison for reference. p and q are other patterns, n is a non-negative integer: