27 releases

Uses old Rust 2015

0.2.21 Aug 19, 2019
0.2.19 May 2, 2019
0.2.18 Jul 5, 2018
0.2.17 Jan 25, 2018
0.1.0 Dec 13, 2014

#176 in Command-line interface

Download history 242363/week @ 2024-06-16 249562/week @ 2024-06-23 233124/week @ 2024-06-30 239166/week @ 2024-07-07 253570/week @ 2024-07-14 262911/week @ 2024-07-21 257824/week @ 2024-07-28 272056/week @ 2024-08-04 286306/week @ 2024-08-11 271590/week @ 2024-08-18 290711/week @ 2024-08-25 289313/week @ 2024-09-01 289748/week @ 2024-09-08 304228/week @ 2024-09-15 319079/week @ 2024-09-22 289975/week @ 2024-09-29

1,225,776 downloads per month
Used in 1,490 crates (480 directly)

MIT/Apache

72KB
2K SLoC

getopts

A Rust library for option parsing for CLI utilities.

Documentation

Usage

Add this to your Cargo.toml:

[dependencies]
getopts = "0.2"

lib.rs:

Simple getopt alternative.

Construct a vector of options, either by using reqopt, optopt, and optflag or by building them from components yourself, and pass them to getopts, along with a vector of actual arguments (not including argv[0]). You'll either get a failure code back, or a match. You'll have to verify whether the amount of 'free' arguments in the match is what you expect. Use opt_* accessors to get argument values out of the matches object.

Single-character options are expected to appear on the command line with a single preceding dash; multiple-character options are expected to be proceeded by two dashes. Options that expect an argument accept their argument following either a space or an equals sign. Single-character options don't require the space.

Usage

This crate is on crates.io and can be used by adding getopts to the dependencies in your project's Cargo.toml.

[dependencies]
getopts = "0.2"

and this to your crate root:

extern crate getopts;

Example

The following example shows simple command line parsing for an application that requires an input file to be specified, accepts an optional output file name following -o, and accepts both -h and --help as optional flags.

extern crate getopts;
use getopts::Options;
use std::env;

fn do_work(inp: &str, out: Option<String>) {
    println!("{}", inp);
    match out {
        Some(x) => println!("{}", x),
        None => println!("No Output"),
    }
}

fn print_usage(program: &str, opts: Options) {
    let brief = format!("Usage: {} FILE [options]", program);
    print!("{}", opts.usage(&brief));
}

fn main() {
    let args: Vec<String> = env::args().collect();
    let program = args[0].clone();

    let mut opts = Options::new();
    opts.optopt("o", "", "set output file name", "NAME");
    opts.optflag("h", "help", "print this help menu");
    let matches = match opts.parse(&args[1..]) {
        Ok(m) => { m }
        Err(f) => { panic!(f.to_string()) }
    };
    if matches.opt_present("h") {
        print_usage(&program, opts);
        return;
    }
    let output = matches.opt_str("o");
    let input = if !matches.free.is_empty() {
        matches.free[0].clone()
    } else {
        print_usage(&program, opts);
        return;
    };
    do_work(&input, output);
}

Dependencies

~1–1.4MB
~21K SLoC