classstuds::Proc

sys::Obj
  studs::Proc

Proc manages spawning an external OS process. This class differs from sys::Process by optimizing the API for interaction with the child process over stdio.

cmd

Source

const Str[] cmd

Command argument list used to launch process. The first item is the executable itself, then rest are the parameters.

dir

Source

const File? dir := null

Working directory for child process.

env

Source

const Str:Str env := [Str:Str][:]

Environment variables to pass to child process. This map is initialized with the current process environment.

err

Source

InStream err()

Return InStream used to read process stderr.

exitCode

Source

Int? exitCode()

Return the exit code for child process, null if process has not started, or throws Err if process has not yet terminated.

in

Source

InStream in()

Return InStream used to read process stdout.

isRunning

Source

Bool isRunning()

Return true if child process is currently running or false if not started or terminated.

kill

Source

This kill()

Kill the child process. Use waitFor to block until the process has terminated.

make

Source

new make(|This f)

It-block constructor.

okOrThrow

Source

This okOrThrow()

Check the exit code the process returned. If the code was 0 return this. If the code was non-zero throws an IOErr. If the process is still running, the same semantics apply as exitCode.

out

Source

OutStream out()

Return OutStream used to write to process stdin.

redirectErr

Source

const Bool redirectErr := true

If true, then stderr is redirected to stdout.

run

Source

This run()

Spawn the child process. See waitFor to block until the process has terminated, and exitCode to retreive process exit code.

waitFor

Source

This waitFor()

Block the current thread until the child process has terminated. Use exitCode to retreive exit code.