n0s4/flags

An effortless command-line argument parser for Zig.

flags

An effortless command-line argument parser for Zig.

Features

• Zero allocations.
• Declaratively define your command as a plain Zig type.
• Single-function API.
• Multi-level subcommands.
• Automatic help message generation at comptime.

Getting Started

See the examples for basic usage.

Check out the import guide to get set up using flags in your project.

flags's Issues

Proposal: add descriptor for positional arguments

...just for the help message. So that a user knows upfront that they need to provide n arguments which mean x, y, z etc. So this could basically be just another text ([]const u8) field with a specific name I guess.

Here's a crude example, so you get the idea:

Usage: flags_demo <args> [options]

Args: 
    arg1 description
    ...

Options:
  -f, --force Use the force
....

The positional arguments could also be commands, so this might require some more thought.

Define required positional arguments

Currently, positional arguments are just a list of strings and it's up to the user to deal with those. It would be nice to be able to define required positional arguments with names and types.