BuildBox.Command.System

Running system commands. On some platforms this may cause the command to be executed directly, so shell tricks won't work. The Build monad can be made to log commands executed with all versions of system by setting buildConfigLogSystem in the BuildConfig passed to runBuildPrintWithConfig.

We define a lot of wrappers because executing system commands is the bread-and-butter of buildbots, and we usually need all the versions...

Documentation

module System.Exit

Wrappers

system :: String -> Build (ExitCode, String, String)

Run a system command, returning its exit code and what it wrote to stdout and stderr.

systemq :: String -> Build (ExitCode, String, String)

Quietly run a system command, returning its exit code and what it wrote to stdout and stderr.

ssystem :: String -> Build (String, String)

Run a successful system command, returning what it wrote to stdout and stderr. If the exit code is ExitFailure then throw an error in the Build monad.

ssystemq :: String -> Build (String, String)

Quietly run a successful system command, returning what it wrote to stdout and stderr. If the exit code is ExitFailure then throw an error in the Build monad.

sesystem :: String -> Build String

Run a successful system command, returning what it wrote to its stdout. If anything was written to stderr then treat that as failure. If it fails due to writing to stderr or returning ExitFailure then throw an error in the Build monad.

sesystemq :: String -> Build String

Quietly run a successful system command, returning what it wrote to its stdout. If anything was written to stderr then treat that as failure. If it fails due to writing to stderr or returning ExitFailure then throw an error in the Build monad.

systemTee :: Bool -> String -> String -> Build (ExitCode, String, String)

Like systemTeeIO, but in the Build monad.

systemTeeLog :: Bool -> String -> Log -> Build (ExitCode, Log, Log)

Like systemTeeLogIO, but in the Build monad.

ssystemTee :: Bool -> String -> String -> Build ()

Like systemTeeIO, but in the Build monad and throw an error if it returns ExitFailure.

systemTeeIO :: Bool -> String -> String -> IO (ExitCode, String, String)

Like systemTeeLogIO, but with strings.

The real function

systemTeeLogIO

Arguments

:: Bool

Whether stdout and stderr should be forwarded to the parent process.

-> String

Command to run.

-> Log

What to pass to the command's stdin.

-> IO (ExitCode, Log, Log)

Run a system command, returning its ExitCode and what was written to stdout and stderr.