Process type
Methods
- $()(p:Process) Source: stdlib.ngs:6243
Run a process
- ExitCode(p:Process) Source: stdlib.ngs:6097
Convert Process to exit code. Waits for the process to finish and uses its exit code. To be used for NGS process exit such as in "ngs -e 'my_code(); $(ls)'".
- finished(p:Process) Source: stdlib.ngs:6038
Undocumented
- finished_ok(p:Process) Source: stdlib.ngs:5928
Decide whether process finished normally: exit code must be 0. Note that processes terminated by a signal will have .exit_code null. Parameters
p any process Returns
bool
- finished_ok(p:Process, field_name:Str, ok:NumRange)internal Source: stdlib.ngs:5935
Decide whether a process finished normally. Example
$(ok:0..10 ls no-such-file)
- finished_ok(p:Process, field_name:Str, ok:Arr)internal Source: stdlib.ngs:5941
Decide whether a process finished normally. Example
$(ok:[0,1,2] ls no-such-file)
- finished_ok(p:Process, field_name:Str, ok:Int)internal Source: stdlib.ngs:5949
Decide whether a process finished normally. Example
$(ok:1 ls no-such-file) # No exception $(ok:10 ls no-such-file) # ProcessFail exception
- finished_ok(p:Process, field_name:Str, ok:Bool)internal Source: stdlib.ngs:5955
Decide whether a process finished normally. Example
# 'ok' option is set to true when the value is missing after ':' $(ok: ls no-such-file)
- finished_ok(p:Process)internal Source: stdlib.ngs:5965
Decide whether a process with 'ok' option finished normally. Example
$(ok:0..10 ls no-such-file) $(ok:[0,1,2] ls no-such-file) $(ok:1 ls no-such-file) # No exception $(ok:10 ls no-such-file) # ProcessFail exception $(ok: ls no-such-file)
- finished_ok(p:Process) Source: stdlib.ngs:5980
Decide whether a process with 'ok_sig' option finished normally. Example
p=$(sleep 10 &); p.kill(); p.wait() # ProcessFail exception in wait() p=$(ok_sig:SIGNALS.TERM sleep 10 &); p.kill(); p.wait() # No exception
- finished_ok(p:Process) Source: stdlib.ngs:5994
Decide whether a process finished normally for known programs that return also non-zero exit codes which do not signal a failure. Example
$(test -f my_file_that_might_be_present) $(fuser my_file) # On Linux, exit code 1 means file is not used
- init(p:Process, c:Command) Source: stdlib.ngs:6019
Process constructor. Initializes fields.
- init(pf:ProcessFail, process:Process)
Undocumented
- kill(p:Process, sig:Int=15) Source: stdlib.ngs:6552
Send signal to a Process. Uses KILL(2). Throws InvalidArgument if Process does not have "pid". Throws KillFail on error. Parameters
sig Signal to send. Defaults to SIGNALS.TERM Returns
unspecified at this time, do not count on it
- lines(p:Process) Source: stdlib.ngs:6664
Wait for the process and return lines of its stdout. Returns
Arr of StrExample
$(seq 10 2 20).lines().map(Int) # [10,12,14,16,18,20]
- lines(p:Process, cb:Fun) Source: stdlib.ngs:6670
Iterate lines of Process' stdout, calling cb with successive lines. Warning: current implementation waits for the process to finish, accumulates all its stdout, and only then starts calling cb for each line.
- Str(p:Process) Source: stdlib.ngs:6116
Wait for the process to finish and return its standard output. Returns
Str
- wait(p:Process) Source: stdlib.ngs:6045
Wait for a process. Waits for reading and writing threads to finish. Waits for the process to finish. Checks whether to throw ProcessFail using finished_ok(). Returns
p