3 releases

0.1.2 Mar 16, 2020
0.1.1 Mar 15, 2020
0.1.0 Mar 15, 2020

#18 in #getopt

MIT license

13KB
251 lines

urgeopts: standalone clap wrapper

urgeopts at crates.io urgeopts at docs.rs

urgeopts is a replacement for getopt based on clap.

urgeopts takes option descriptors as a YAML document from stdin, and parse arguments passed to it, and prints the result which can be eval'd. See example.sh for concrete usage.

Configurations look like

name: example
bin_name: $0
version: "1.0"
about: sample text
author: Fumiaki Kinoshita <fumiexcel@gmail.com>
# Flags take no arguments.
# Number of occurences will be reported (e.g. verbose=1)
flags:
  verbose:
    help: verbose output
    short: v
    long: verbose
# Options arguments are collected as newline-separated list of values.
opts:
  # usage syntax is also supported
  # cf. https://docs.rs/clap/2.33.0/clap/struct.Arg.html#syntax
  host: -h --host <HOST> 'host name'
  mode:
    long: mode
    help: option with a certain set of possible values
    possible_values: [ herbivore, carnivore, omnivore ]
# Positional arguments
args:
  - name: cmd
    help: command
    required: true
  - name: arg
    help: command arguments
    multiple: true
subcommands:
  ls: #The name will be assigned to $subcommand
    about: Display a list of entities
    args:
    - name: name
      multiple: true

Usually, you want to embed configurations in a heredoc, pass all arguments to urgeopts and eval its output:

eval "$(urgeopts "$@" <<EOT
...
EOT
)"

Notes

I intentionally didn't use clap::App::from_yaml because the YAML representation tend to be redundant, and hard to diagnose panics.

Dependencies

~1MB
~11K SLoC