Re-exports§
pub use builtin_env::BuiltinEnv;
Modules§
Structs§
- Child
Handle - Command
Builder - Builder wrapper that centralizes direct usages of
std::process::Command. - Command
Context - Context passed to process managers describing the current execution environment. Clones are cheap and explicit so background handles can own their working roots without juggling lifetimes.
- Command
Options - Command
Output - Command
Snapshot - OsPipe
Reader - Owned OS kernel pipe reader half behind a single use slot.
Cloneshares the slot;taketransfers the handle exactly once so no parent copy survives spawn to starve the consumer of EOF. Backed bystd::io::pipe(stable since Rust 1.87):pipeon Unix,CreatePipeon Windows. - OsPipe
Writer - Owned OS kernel pipe writer half behind a single use slot. See
OsPipeReaderfor the shared slot semantics. - Shell
Launcher - Shell
Process Manager - Default process manager that shells out using the system shell.
- Streaming
Expand - Streaming template expansion state machine.
- Test
EnvGuard
Enums§
Constants§
- INHERIT_
STDOUT_ ENV_ VAR - Host environment variable that forces spawned children to inherit the
parent’s stdout/stderr instead of using the executor’s stream routing.
Recognized values are
"1"and case-insensitive"true". Set on the script environment (anENVstep or host inherit), not the process environment: the executor reads it fromCommandContext::envs. - PROCESS_
DEBUG_ ENV_ VAR - Host process-environment variable enabling
eprintln!diagnostics for every spawned command (program plus argv/script). Read from the process environment at spawn time; any value (including empty) enables it.
Traits§
- Background
Handle - Handle for background processes spawned by a
ProcessManager. - Process
Manager - Abstraction for running shell commands both in the foreground and
background.
oxdock-corerelies on this trait to decouple the executor fromstd::process::Command, which in turn enables Miri-friendly test doubles.
Functions§
- create_
os_ pipe - Create a cross platform anonymous OS pipe pair for concurrent
ASYNCpipelines. The caller moves each half into a spawn and drops any other copies immediately after spawning, otherwise the reader never sees EOF. - default_
process_ manager - expand_
command_ env - expand_
script_ env - shell_
program - spawn_
interactive_ shell - Spawn an interactive shell rooted at
cwd, printingbannerbefore handing control to the user’s shell.