Crate kawauso_process 

kawauso-process

External programs for Kawauso applications

This crate runs the external programs of a Kawauso application. Every application starts a program in the same way. The caller names the program and its arguments. The crate collects the output of the program, and it reports how the program ended.

Asynchronous Runtime

The crate runs a command asynchronously, and it needs a Tokio runtime. A run starts the program, reads both of its streams, and waits for the end of the command, and the runtime drives that work. A run that no Tokio runtime drives panics.

An application that already has a runtime, because it starts one in its own entry point, calls the crate from a task of that runtime. An application without one starts a runtime for the runs that it makes.

A stop gives a command a time to end before it kills the command, and the timer of the runtime measures that time. A stop on a runtime that has no timer panics.

Windows

A program whose name ends in .cmd or .bat starts through cmd.exe. A tool that npm installs arrives in this form. Rust escapes the arguments for that interpreter, and it refuses an argument that it cannot pass safely. An argument therefore reaches the program as the caller wrote it, or the run fails and says so.

Windows has no signal that asks a program to end its work. A stop therefore kills the command at once on this platform, and a program that holds a lock file leaves that file behind.

License

Copyright (c) 2026 Aonyx B.V.

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (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.

Re-exports

pub use self::execution::Execution;

pub use self::invocation::Invocation;

pub use self::process_id::ProcessId;

pub use self::run::Run;

Modules

error

Errors for the run of an external command

execution

The result of one run of an external command

invocation

The description of one external command

process_id

The identifier that the operating system gives a command

run

The run of a command that the caller observes while it runs