71 lines
2.4 KiB
V
71 lines
2.4 KiB
V
module os
|
|
|
|
// - ProcessState.not_started - the process has not yet started
|
|
// - ProcessState.running - the process is currently running
|
|
// - ProcessState.stopped - the process was running, but was stopped temporarily
|
|
// - ProcessState.exited - the process has finished/exited
|
|
// - ProcessState.aborted - the process was terminated by a signal
|
|
// - ProcessState.closed - the process resources like opened file descriptors were freed/discarded, final state.
|
|
pub enum ProcessState {
|
|
not_started
|
|
running
|
|
stopped
|
|
exited
|
|
aborted
|
|
closed
|
|
}
|
|
|
|
[heap]
|
|
pub struct Process {
|
|
pub:
|
|
filename string // the process's command file path
|
|
pub mut:
|
|
pid int // the PID of the process
|
|
code int = -1
|
|
// the exit code of the process, != -1 *only* when status is .exited *and* the process was not aborted
|
|
status ProcessState = .not_started
|
|
// the current status of the process
|
|
err string // if the process fails, contains the reason why
|
|
args []string // the arguments that the command takes
|
|
env_is_custom bool // true, when the environment was customized with .set_environment
|
|
env []string // the environment with which the process was started (list of 'var=val')
|
|
use_stdio_ctl bool // when true, then you can use p.stdin_write(), p.stdout_slurp() and p.stderr_slurp()
|
|
use_pgroup bool // when true, the process will create a new process group, enabling .signal_pgkill()
|
|
stdio_fd [3]int // the stdio file descriptors for the child process, used only by the nix implementation
|
|
wdata voidptr // the WProcess; used only by the windows implementation
|
|
}
|
|
|
|
// new_process - create a new process descriptor
|
|
// NB: new does NOT start the new process.
|
|
// That is done because you may want to customize it first,
|
|
// by calling different set_ methods on it.
|
|
// In order to start it, call p.run() or p.wait()
|
|
pub fn new_process(filename string) &Process {
|
|
return &Process{
|
|
filename: filename
|
|
stdio_fd: [-1, -1, -1]!
|
|
}
|
|
}
|
|
|
|
// set_args - set the arguments for the new process
|
|
pub fn (mut p Process) set_args(pargs []string) {
|
|
if p.status != .not_started {
|
|
return
|
|
}
|
|
p.args = pargs
|
|
return
|
|
}
|
|
|
|
// set_environment - set a custom environment variable mapping for the new process
|
|
pub fn (mut p Process) set_environment(envs map[string]string) {
|
|
if p.status != .not_started {
|
|
return
|
|
}
|
|
p.env_is_custom = true
|
|
p.env = []string{}
|
|
for k, v in envs {
|
|
p.env << '$k=$v'
|
|
}
|
|
return
|
|
}
|