envzn
0.8 · beta · not released

Library / System / Runtime / Process

CLASS

Process

Process — kernel singleton for synchronous shell-out.

Methods 2

METHOD run(REFERENCE String command, REFERENCE String[] args) RETURNS ProcessResult
reads

Run command with args, capturing stdout, stderr, and the exit code into a ProcessResult.

Blocks until the child process exits. PATH lookup follows the standard execvp rules — passing a bare program name (e.g. "tar") searches $PATH; an absolute or directory-relative path (e.g. "/bin/sh", "./build") is used directly.

Failure surfaces as exitCode == -1 (signal-killed); a pipe() / fork() / waitpid() failure PANICs an Error. execvp failure inside the child writes "execvp failed: ..." to stderr and exits with code 127.

METHOD id() RETURNS int32
reads

The ID of the running process — unique among the processes alive at the same moment, so it names a temporary file two concurrent runs of the same program will not share (epm's staging does exactly this). Not unique over time: the operating system reuses an ID once its process has exited.