% - `environment([])`
% - `stdin(std)`, `stdout(std)`, `stderr(std)`
%
-process_create(Exe, Args, Options) :-
+process_create(Exe, Args, Options) :- call_with_error_context(process_create_(Exe, Args, Options), predicate-process_create/3).
+
+process_create_(Exe, Args, Options) :-
must_be(chars, Exe),
must_be(list, Args),
maplist(must_be(chars), Args),
option([cwd], valid_cwd, cwd("."), cwd(Cwd))
],
Options,
- process_create_option,
- process_create/3
+ process_create_option
),
Stdin =.. Stdin1,
Stdout =.. Stdout1,
%% process_id(+Process, -Pid).
%
-process_id(Process, Pid) :-
- valid_process(Process, process_id/2),
+process_id(Process, Pid) :- call_with_error_context(process_id_(Process, Pid), predicate-process_id/2).
+
+process_id_(Process, Pid) :-
+ valid_process(Process),
must_be(var, Pid),
'$process_id'(Process, Pid).
%
% See `process_create/3` with `Options = []`
%
-process_wait(Process, Status) :- process_wait(Process, Status, []).
+process_wait(Process, Status) :- call_with_error_context(process_wait(Process, Status, []), predicate-process_wait/2).
%% process_wait(+Process, Status, Options).
%
% - timeout(infinite)
%
-process_wait(Process, Status, Options) :-
- valid_process(Process, process_wait/3),
+process_wait(Process, Status, Options) :- call_with_error_context(process_wait_(Process, Status, Options), predicate-process_wait/3).
+
+process_wait_(Process, Status, Options) :-
+ valid_process(Process),
check_options(
[
option([timeout], valid_timeout, timeout(infinite), timeout(Timeout))
],
Options,
- process_wait_option,
- process_wait/3
+ process_wait_option
),
'$process_wait'(Process, Exit, Timeout),
Exit = Status.
%
% Only works for processes spawned with `process_create/3` that have not yet been release with `process_release/1`
%
-process_kill(Process) :-
- valid_process(Process, process_kill/1),
+process_kill(Process) :- call_with_error_context(process_kill_(Process), predicate-process_kill/1).
+
+process_kill_(Process) :-
+ valid_process(Process),
'$process_kill'(Process).
%% process_release(+Process)
%
% It's an error if `Process` is not a valid process handle
%
-process_release(Process) :-
- valid_process(Process, process_release/1),
+process_release(Process) :- call_with_error_context(process_release_(Process), predicate-process_release/1).
+
+process_release_(Process) :-
+ valid_process(Process),
process_wait(Process, _),
'$process_release'(Process).
-must_be_known_options(Valid, Options, Domain, Context) :- must_be_known_options_(Valid, [], Options, Domain, Context).
+must_be_known_options(Valid, Options, Domain) :- call_with_error_context(must_be_known_options_(Valid, [], Options, Domain),predicate-must_be_known_options/3).
-must_be_known_options_(_, _, [], _, _).
-must_be_known_options_(Valid, Found, [X|XS], Domain, Context) :-
+must_be_known_options_(_, _, [], _).
+must_be_known_options_(Valid, Found, [X|XS], Domain) :-
( functor(X, Option, 1) -> true
- ; domain_error(Domain, X , Context)
+ ; domain_error(Domain, X, [])
) ,
- ( member(Option, Found) -> domain_error(non_duplicate_options, Option , Context)
+ ( member(Option, Found) -> domain_error(non_duplicate_options, Option , [])
; member(Option, Valid) -> true
- ; domain_error(Domain, Option, Context)
+ ; domain_error(Domain, Option, [])
),
- must_be_known_options_(Valid, [Option | Found], XS, Domain, Context).
+ must_be_known_options_(Valid, [Option | Found], XS, Domain).
+
+check_options(KnownOptions, Options, Domain) :- call_with_error_context(check_options_(KnownOptions, Options, Domain), predicate-check_options/3).
-check_options(KnownOptions, Options, Domain, Context) :-
+check_options_(KnownOptions, Options, Domain) :-
maplist(option_names, KnownOptions, Namess),
append(Namess, Names),
- must_be_known_options(Names, Options, Domain, Context),
- check_options_(KnownOptions, Options, Context).
+ must_be_known_options(Names, Options, Domain),
+ extract_options(KnownOptions, Options).
option_names(option(Names,_,_,_), Names).
-check_options_([], _, _).
-check_options_([X | XS], Options, Context) :-
+extract_options(KnownOptions, Options) :- call_with_error_context(extract_options_(KnownOptions, Options), predicate-extract_options/2).
+
+extract_options_([], _).
+extract_options_([X | XS], Options) :-
option(Kinds, Pred, Default, Choice) = X,
tfilter(find_option(Kinds), Options, Solutions),
( Solutions = [] -> Choice = Default
- ; Solutions = [Provided] -> call(Pred, Provided), Choice = Provided
- ; domain_error(non_conflicting_options, Solutions, Context)
+ ; Solutions = [Provided] -> functor(Pred, Name, Arity), ArityP1 is Arity+1, call_with_error_context(call(Pred, Provided),predicate-Name/ArityP1), Choice = Provided
+ ; domain_error(non_conflicting_options, Solutions, [])
),
- check_options_(XS, Options, Context).
+ extract_options_(XS, Options).
find_option(Names, Found, T) :-
functor(Found, Name, 1),
memberd_t(Name, Names, T).
valid_stdio(IO) :- arg(1, IO, Arg),
- ( var(Arg) -> instantiation_error(process_create/3)
+ ( var(Arg) -> instantiation_error([])
; valid_stdio_(Arg) -> true
- ; domain_error(stdio_spec, Arg, process_create/3)
+ ; domain_error(stdio_spec, Arg, [])
).
valid_stdio_(std).
valid_env(env(E)) :-
must_be(list, E),
( valid_env_(E) -> true
- ; domain_error(process_create_option, env(E), process_create/3)
+ ; domain_error(process_create_option, env(E), [])
).
valid_env(environment(E)) :-
must_be(list, E),
( valid_env_(E) -> true
- ; domain_error(process_create_option, environment(E), process_create/3)
+ ; domain_error(process_create_option, environment(E), [])
).
valid_env_([]).
valid_uninit_process(process(Process)) :- must_be(var, Process).
-valid_process(Process, Context) :- var(Process) -> instantiation_error(Context) ; true.
+valid_process(Process) :- var(Process) -> instantiation_error([]) ; true.
valid_cwd(cwd(Cwd)) :- must_be(chars, Cwd).
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_create("", [], [invalid, process(P)]), process_kill(P), halt'
-use_module(library(process)),process_create([],[],[invalid,process(P)]),process_kill(P),halt causes: error(domain_error(process_create_option,invalid),process_create/3)
+use_module(library(process)),process_create([],[],[invalid,process(P)]),process_kill(P),halt causes: error(domain_error(process_create_option,invalid),[predicate-process_create/3,predicate-check_options/3,predicate-must_be_known_options/3])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_create("", [], [invalid(_Var), process(P)]), process_kill(P), halt'
-use_module(library(process)),process_create([],[],[invalid(_Var),process(P)]),process_kill(P),halt causes: error(domain_error(process_create_option,invalid),process_create/3)
+use_module(library(process)),process_create([],[],[invalid(_Var),process(P)]),process_kill(P),halt causes: error(domain_error(process_create_option,invalid),[predicate-process_create/3,predicate-check_options/3,predicate-must_be_known_options/3])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_create("", [], [stdin(null), stdin(null), process(P)]), process_kill(P), halt'
-use_module(library(process)),process_create([],[],[stdin(null),stdin(null),process(P)]),process_kill(P),halt causes: error(domain_error(non_duplicate_options,stdin),process_create/3)
+use_module(library(process)),process_create([],[],[stdin(null),stdin(null),process(P)]),process_kill(P),halt causes: error(domain_error(non_duplicate_options,stdin),[predicate-process_create/3,predicate-check_options/3,predicate-must_be_known_options/3])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_create("", [], [env([]), environment([]), process(P)]), process_kill(P), halt'
-use_module(library(process)),process_create([],[],[env([]),environment([]),process(P)]),process_kill(P),halt causes: error(domain_error(non_conflicting_options,[env([]),environment([])]),process_create/3)
+use_module(library(process)),process_create([],[],[env([]),environment([]),process(P)]),process_kill(P),halt causes: error(domain_error(non_conflicting_options,[env([]),environment([])]),[predicate-process_create/3,predicate-check_options/3,predicate-extract_options/2])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_wait(pid, _Status, [invalid(_Var), timeout(0)]), halt'
-use_module(library(process)),process_wait(pid,_Status,[invalid(_Var),timeout(0)]),halt causes: error(domain_error(process_wait_option,invalid),process_wait/3)
+use_module(library(process)),process_wait(pid,_Status,[invalid(_Var),timeout(0)]),halt causes: error(domain_error(process_wait_option,invalid),[predicate-process_wait/3,predicate-check_options/3,predicate-must_be_known_options/3])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_create("", [], [stdin(invalid), process(P)]), process_kill(P), halt'
-use_module(library(process)),process_create([],[],[stdin(invalid),process(P)]),process_kill(P),halt causes: error(domain_error(stdio_spec,invalid),process_create/3)
+use_module(library(process)),process_create([],[],[stdin(invalid),process(P)]),process_kill(P),halt causes: error(domain_error(stdio_spec,invalid),[predicate-process_create/3,predicate-check_options/3,predicate-extract_options/2,predicate-valid_stdio/1])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_wait(50, _Status), halt'
-use_module(library(process)),process_wait(50,_Status),halt causes: error(type_error(process,50),process_wait/3)
+use_module(library(process)),process_wait(50,_Status),halt causes: error(type_error(process,50),[predicate-process_wait/2,predicate-process_wait/3|process_wait/3])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_kill(50), halt'
-use_module(library(process)),process_kill(50),halt causes: error(type_error(process,50),process_kill/1)
+use_module(library(process)),process_kill(50),halt causes: error(type_error(process,50),[predicate-process_kill/1|process_kill/1])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_id(50,_Pid), halt'
-use_module(library(process)),process_id(50,_Pid),halt causes: error(type_error(process,50),process_id/2)
+use_module(library(process)),process_id(50,_Pid),halt causes: error(type_error(process,50),[predicate-process_id/2|process_id/2])
```
```trycmd
$ scryer-prolog -f --no-add-history -g 'use_module(library(process)), process_release(50), halt'
-use_module(library(process)),process_release(50),halt causes: error(type_error(process,50),process_wait/3)
+use_module(library(process)),process_release(50),halt causes: error(type_error(process,50),[predicate-process_release/1,predicate-process_wait/2,predicate-process_wait/3|process_wait/3])
```