runExternal

lsst.sconsUtils.utils.runExternal(cmd, fatal=False, msg=None)

Safe wrapper for running external programs, reading stdout, and sanitizing error messages.

Parameters
cmdstr or list or tuple

Command to execute. Shell usage is disabled if a sequence is given. Shell is used if a single command string is given.

fatalbool, optional

Control whether command failure is fatal or not.

msgstr

Message to report on command failure.

Returns
outputstr

Entire program output is returned, not just a single line.

Raises
RuntimeError

If the command fails and fatal is True.