Struct workflow_node::process::Process

pub struct Process { /* private fields */ }

The Process class facilitating execution of a Child Process in Node.js or NWJS environments. This wrapper runs the child process as a daemon, restarting it if it fails. The process provides stdout and stderr output as channel Receiver channels, allowing for a passive capture of the process console output.

Implementations

impl Process

pub fn new(options: &Options) -> Process

Create new process instance

pub fn stdout(&self) -> Receiver<String>

Obtain a clone of the channel Receiver that captures stdout output of the underlying process.

pub fn stderr(&self) -> Receiver<String>

Obtain a clone of the Receiver that captures stderr output of the underlying process.

pub fn run(&self) -> Result<()>

Run the process in the background. Spawns an async task that monitors the process, capturing its output and restarting the process if it exits prematurely.

pub fn kill(&self) -> Result<()>

Issue a SIGKILL signal, terminating the process immediately.

pub fn restart(&self) -> Result<()>

Issue a SIGTERM signal causing the process to exit. The process will be restarted by the monitoring task.

pub fn stop(&self) -> Result<()>

Stop the process by disabling auto-restart and issuing a SIGTERM signal.

pub async fn join(&self) -> Result<()>

Join the process like you would a thread - this async function blocks until the process exits.

pub async fn stop_and_join(&self) -> Result<()>

Stop the process and block until it exits.

pub async fn exec_with_args(
    &self,
    args: &[&str],
    cwd: Option<PathBuf>
) -> Result<ExecutionResult>

Execute the process single time with custom command-line arguments. Useful to obtain a verion via --version or perform single-task executions - not as a daemon.

pub async fn get_version(&self) -> Result<Version>

Obtain the process version information by running it with --version argument.

Trait Implementations

impl Clone for Process

fn clone(&self) -> Process

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.