blob: 9b9e563404f7f83f3035219b13c615a974fe3cc8 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
# shell-words
Process command line according to parsing rules of Unix shell.
## Usage
Add this to Cargo.toml:
```toml
[dependencies]
shell-words = "1.0.0"
```
Add this to your crate:
```rust
extern crate shell_words;
```
## Examples
### Split
Compiling C source code into an executable as in default build rule found in GNU Make:
```rust
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:
```rust
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
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
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.
|
