pico_args - Rust (original) (raw)

Expand description

An ultra simple CLI arguments parser.

If you think that this library doesn’t support some feature, it’s probably intentional.

• No help generation
• Only flags, options, free arguments and subcommands are supported
• No combined flags (like -vvv or -abc)
• Options can be separated by a space, = or nothing. See build features
• Arguments can be in any order
• Non UTF-8 arguments are supported

§Build features

• eq-separator
  Allows parsing arguments separated by =
  This feature adds about 1KiB to the resulting binary
• short-space-opt
  Makes the space between short keys and their values optional (e.g. -w10)
  If eq-separator is enabled, then it takes precedence and the ‘=’ is not included.
  If eq-separator is disabled, then -K=value gives an error instead of returning "=value".
  The optional space is only applicable for short keys because --keyvalue would be ambiguous
• combined-flagsAllows combination of flags, e.g. -abc instead of -a -b -c.
  If short-space-opt or eq-separator are enabled, you must parse flags after values, to prevent ambiguities.

Arguments

An arguments parser.

Error

A list of possible errors.