mini-parser

mini-parser is a very-minimal parser for the Zig language.

Example

const std = @import("std");
const mini_parser = @import("mini-parser");
const debug = std.debug;
const posix = std.posix;

const usage =
    \\Usage: example [OPTIONS]
    \\
    \\Options:
    \\  --help,       -h    Display help list
    \\  --text=TEXT,  -t    Print the text
    \\  --bool,       -b    Enable the boolean
    \\
;

pub fn main() !void {
    var i: usize = 0;
    while (std.os.argv.len > i) : (i += 1) {
        var args: usize = 1;

        blk: while (true) {
            const parser = try mini_parser.init(i, args, &.{
                .{ .long = "help", .short = 'h', .type = .boolean },
                .{ .long = "text", .short = 't', .type = .argument },
                .{ .long = "bool", .short = 'b', .type = .boolean },
            });

            switch (parser.arg) {
                0 => {
                    debug.print("no argument was given.\n", .{});
                    posix.exit(0);
                },
                1 => {
                    debug.print("argument '{s}' does not exist.\n", .{parser.val});
                    posix.exit(0);
                },
                'h' => {
                    debug.print("{s}\n", .{usage});
                    posix.exit(0);
                },
                't' => {
                    debug.print("Text: {s}\n", .{parser.val});
                },
                'b' => {
                    debug.print("Enabled boolean!\n", .{});
                },
                else => {},
            }

            if (args != parser.args) {
                args = parser.args;
                continue :blk;
            }

            break;
        }
    }
}

Installation

Fetch mini-parser package to build.zig.zon:

zig fetch --save git+https://github.com/Operachi061/mini-parser

Then add following to build.zig:

const mini_parser = b.dependency("mini_parser", .{});
exe.root_module.addImport("mini-parser", mini_parser.module("mini-parser"));

After building, test it via:

./example -tb foo --help

Unlicense

This project is based on the UNLICENSE.