Logged processes

Author(s): Jose F. Morales.

A wrapper on top of process_call/3 with some logging facilities. If the process does not exit with error status 0, some special action is taken.

When logbase(Base) is specified, the standard output and error of the process is stored in files. The option show_logs(ShowLogs) indicates how logs are handled:

silent: do not show any log (default).
always: always show logs (whether success or error).
note_always: always show a note indicating where logs are stored, but do not show contents (whether success or error).
on_error: show the logs if there is an error.
note_on_error: on error, show a note indicating where logs are stored, but do not show contents.
on_error_stderr: like on_error but show the logs from standard error and a note indicating where the standard output log is.

Usage and interface

Library usage:
:- use_module(library(logged_process)).
Exports:
- Predicates:
  logged_process_call/3, quoted_process_call/3.

Documentation on exports

PREDICATElogged_process_call/3

Usage:logged_process_call(Cmd,Args,Opts)

Like process_call/3, but saves logs of standard input and output, controlled by additonal Opts.

The following properties should hold at call time:
(process:process_cmd/1)Command for process_call/3
(basic_props:list/2)Args is a list of process_args.
(basic_props:list/2)Opts is a list of process_options.

PREDICATEquoted_process_call/3

No further documentation available for this predicate.

Documentation on imports

This module has the following direct dependencies:

System library modules:
stream_utils, messages, lists, process.
Packages:
prelude, initial, condcomp, assertions, assertions/assertions_basic, regtypes, basicmodes, fsyntax.