rsbash: run bash commands from rust. Simply.

There's as many ways to use rsbash as there are ways to use your beloved bash shell, but here are some examples anyway!

Some ways you can use rsbash ...

A simple command:

```rust use rsbash::{rash, RashError};

pub fn simple() -> Result<(), RashError> { let (retval, stdout) = rash!("echo -n 'Hello world!'")?; asserteq!(retval, 0); asserteq!(stdout, "Hello world!"); Ok(()) } ```

A less simple command:

```rust use rsbash::{rash, RashError};

pub fn lesssimple() -> Result<(), RashError> { let (retval, stdout) = rash!("echo -n 'Hello ' | cat - && printf '%s' $(echo -n 'world!')")?; asserteq!(retval, 0); assert_eq!(stdout, "Hello world!"); Ok(()) } ```

With a format!'d string:

```rust use rsbash::rash; use tempfile::TempDir;

pub fn format() -> anyhow::Result<()> { let dir = TempDir::new()?; let path = dir.path().to_str().unwrap(); let message = "Hi from within bar.txt!"; let script = format!("cd {}; echo -n '{}' > bar.txt; cat bar.txt;", path, message);

assert_eq!(rash!(script)?, (0, String::from(message)));

dir.close()?;
Ok(())

} ```

Execute a script:

```rust use rsbash::rash; use tempfile::TempDir;

pub fn script() -> anyhow::Result<()> { let dir = TempDir::new()?; let path = dir.path().to_str().unwrap(); let message = "Hi from within foo.sh!"; let script = format!( "cd {}; echo -n \"echo -n '{}'\" > foo.sh; chmod u+x foo.sh; ./foo.sh;", path, message );

assert_eq!(rash!(script)?, (0, String::from(message)));

dir.close()?;
Ok(())

} ```

Using a raw string script:

```rust use rsbash::{rash, RashError};

const SCRIPT: &'static str = r#" s="*" for i in {1..3}; do echo "$s" s="$s *" done; "#;

pub fn rawscript() -> Result<(), RashError> { // ... it prints a lovely triangle. let (retval, stdout) = rash!(SCRIPT)?; // * asserteq!(retval, 0); // * * assert_eq!(stdout, "\n \n * *\n"); // * * *
Ok(()) } ```

License

MIT License - Copyright (c) 2023 Luke Elliot