Struct tauri::api::process::Command

source · [−]

pub struct Command { /* private fields */ }

Expand description

The type to spawn commands.

Implementations

source

impl Command

source

pub fn new<S: Into<String>>(program: S) -> Self

Available on crate feature process-command-api only.

Creates a new Command for launching the given program.

source

pub fn new_sidecar<S: Into<String>>(program: S) -> Result<Self>

Available on crate feature process-command-api only.

Creates a new Command for launching the given sidecar program.

A sidecar program is a embedded external binary in order to make your application work or to prevent users having to install additional dependencies (e.g. Node.js, Python, etc).

source

pub fn args<I, S>(self, args: I) -> Self where
I: IntoIterator<Item = S>,
S: AsRef<str>,

Available on crate feature process-command-api only.

Appends arguments to the command.

source

pub fn env_clear(self) -> Self

Available on crate feature process-command-api only.

Clears the entire environment map for the child process.

source

pub fn envs(self, env: HashMap<String, String>) -> Self

Available on crate feature process-command-api only.

Adds or updates multiple environment variable mappings.

source

pub fn current_dir(self, current_dir: PathBuf) -> Self

Available on crate feature process-command-api only.

Sets the working directory for the child process.

source

pub fn spawn(self) -> Result<(Receiver<CommandEvent>, CommandChild )>

Available on crate feature process-command-api only.

Spawns the command.

Examples

use tauri::api::process::{Command, CommandEvent};
tauri::async_runtime::spawn(async move {
  let (mut rx, mut child) = Command::new("cargo")
    .args(["tauri", "dev"])
    .spawn()
    .expect("Failed to spawn cargo");

  let mut i = 0;
  while let Some(event) = rx.recv().await {
    if let CommandEvent::Stdout(line) = event {
      println!("got: {}", line);
      i += 1;
      if i == 4 {
        child.write("message from Rust\n".as_bytes()).unwrap();
        i = 0;
      }
    }
  }
});

source

pub fn status(self) -> Result<ExitStatus>

Available on crate feature process-command-api only.

Executes a command as a child process, waiting for it to finish and collecting its exit status. Stdin, stdout and stderr are ignored.

Examples

use tauri::api::process::Command;
let status = Command::new("which").args(["ls"]).status().unwrap();
println!("`which` finished with status: {:?}", status.code());

source

pub fn output(self) -> Result<Output>

Available on crate feature process-command-api only.

Executes the command as a child process, waiting for it to finish and collecting all of its output. Stdin is ignored.

Examples

use tauri::api::process::Command;
let output = Command::new("echo").args(["TAURI"]).output().unwrap();
assert!(output.status.success());
assert_eq!(output.stdout, "TAURI");