simple-cmd 0.0.22

command line utility for spawning commands
Documentation 
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

#![doc = include_str!("../README.md")]

use std::ffi::OsString;
use std::process::Stdio;
use std::time::Duration;

use crossbeam::channel::Receiver;
use thiserror::Error;

use crate::errors::CmdError;

pub mod debug;
pub mod errors;
mod impls;
pub mod prelude;
mod test;

pub type Result<T> = std::result::Result<T, Error>;

#[derive(Error, Debug)]
pub enum Error {
	#[error("cmd error: {0}")]
	CommandError(#[from] CmdError),

	#[error(transparent)]
	IoError(#[from] std::io::Error),
}

#[derive(Debug)]
pub struct Cmd {
	pub(crate) debug: bool,
	pub(crate) program: OsString,
	pub(crate) args: Vec<OsString>,
	pub(crate) cwd: Option<OsString>,
	pub(crate) stdin: Option<Stdio>,
	pub(crate) stdout: Option<Stdio>,
	pub(crate) stderr: Option<Stdio>,
	pub(crate) timeout: Option<Duration>,
	pub(crate) signal: Option<Receiver<()>>,
}

#[derive(Debug)]
pub struct CommandBuilder {
	pub(crate) debug: bool,
	pub(crate) program: OsString,
	pub(crate) cwd: Option<OsString>,
	pub(crate) args: Vec<OsString>,
	pub(crate) stdin: Option<Stdio>,
	pub(crate) stdout: Option<Stdio>,
	pub(crate) stderr: Option<Stdio>,
	pub(crate) timeout: Option<Duration>,
	pub(crate) signal: Option<Receiver<()>>,
}

pub(crate) trait OutputResult {
	fn to_result(&self) -> Result<Vec<u8>>;
	fn try_to_result(&self) -> Result<Vec<u8>>;
}

pub trait Vec8ToString {
	fn as_str(&self) -> Option<&str>;
}