#quote #shell #split #unix #words

shell-words

Process command line according to parsing rules of UNIX shell

2 releases (1 stable)

Uses old Rust 2015

1.0.0 May 6, 2020
0.1.0 Mar 9, 2018

#7 in Unix APIs

Download history 9219/week @ 2020-06-27 7790/week @ 2020-07-04 7158/week @ 2020-07-11 8334/week @ 2020-07-18 7137/week @ 2020-07-25 13218/week @ 2020-08-01 9817/week @ 2020-08-08 8905/week @ 2020-08-15 10588/week @ 2020-08-22 9898/week @ 2020-08-29 11536/week @ 2020-09-05 14733/week @ 2020-09-12 14235/week @ 2020-09-19 19126/week @ 2020-09-26 21261/week @ 2020-10-03 14827/week @ 2020-10-10

42,761 downloads per month
Used in 106 crates (70 directly)

MIT/Apache

18KB
350 lines

shell-words

Process command line according to parsing rules of Unix shell.

Usage

Add this to Cargo.toml:

[dependencies]
shell-words = "1.0.0"

Add this to your crate:

extern crate shell_words;

Examples

Split

Compiling C source code into an executable as in default build rule found in GNU Make:

extern crate shell_words;

use std::env::var;
use std::process::Command;

fn main() {
    let cc = var("CC").unwrap_or_else(|_| "cc".to_owned());

    let cflags = var("CFLAGS").unwrap_or_else(|_| String::new());
    let cflags = shell_words::split(&cflags).expect("failed to parse CFLAGS");

    let cppflags = var("CPPFLAGS").unwrap_or_else(|_| String::new());
    let cppflags = shell_words::split(&cppflags).expect("failed to parse CPPFLAGS");

    Command::new(cc)
        .args(cflags)
        .args(cppflags)
        .args(&["-c", "a.c", "-o", "a.out"])
        .spawn()
        .expect("failed to start subprocess")
        .wait()
        .expect("failed to wait for subprocess");
}

Join

Logging executed commands in format that can be readily copied and pasted to a shell:

extern crate shell_words;

fn main() {
    let argv = &["python", "-c", "print('Hello world!')"];

    println!("Executing: {}", shell_words::join(argv));

    std::process::Command::new(&argv[0])
        .args(&argv[1..])
        .spawn()
        .expect("failed to start subprocess")
        .wait()
        .expect("failed to wait for subprocess");
}

Bugs

Please report any issues at https://github.com/tmiasko/shell-words/issues.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps