simargs: A simple, opinionated, struct-based argument parser in Zig.

[jiacai2050]

• https://github.com/jiacai2050/simargs

特点

• 充分利用 comptime 特性
• 简洁

示例

const std = @import("std");
const simargs = @import("simargs");

pub const log_level: std.log.Level = .info;

pub fn main() !void {
    var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
    defer arena.deinit();
    const allocator = arena.allocator();

    var opt = try simargs.parse(allocator, struct {
        // Those fields declare arguments options
        // only `output` is required, others are all optional
        verbose: ?bool,
        @"user-agent": ?[]const u8,
        timeout: ?u16 = 30, // default value
        output: []const u8,

        // This declares option's short name
        pub const __shorts__ = .{
            .verbose = .v,
            .output = .o,
            .@"user-agent" = .A,
        };

        // This declares option's help message
        pub const __messages__ = .{
            .verbose = "Make the operation more talkative", //
            .output = "Write to file instead of stdout", //
            .timeout = "Max time this request can cost",
        };
    });
    defer opt.deinit();

    std.log.info("Program: {s}", .{opt.program});
    std.log.info("Arguments:-----------------", .{});
    inline for (std.meta.fields(@TypeOf(opt.args))) |fld| {
        std.log.info("option name:{s}, value:{any}", .{ fld.name, @field(opt.args, fld.name) });
    }
    std.log.info("Positional arguments: -----------------", .{});
    for (opt.positional_args.items) |arg| {
        std.log.info("{s}", .{arg});
    }

    // Provide a print_help util method
    std.log.info("A print_help() method is provided-----------------", .{});
    try opt.print_help();
}

输出

info: Program: ./zig-out/bin/demo
info: Arguments:-----------------
info: option name:verbose, value:null
info: option name:user-agent, value:null
info: option name:timeout, value:30
info: option name:output, value:{ 47, 116, 109, 112, 47, 97, 46, 111, 117, 116 }
info: Positional arguments: -----------------
info: hello
info: world
info: A print_help() method is provided-----------------
 USAGE:
     ./zig-out/bin/demo [OPTIONS] ...

 OPTIONS:
	-v, --verbose            Make the operation more talkative [type: bool]
	-A, --user-agent         [type: string]
	    --timeout            Max time this request can cost [type: integer]
	-o, --output             Write to file instead of stdout [type: string][REQUIRED]

[jiacai2050]

文章总结：

• https://en.liujiacai.net/2022/12/14/argparser-in-zig/