Documentation

This function needs to be called in order to use the library succesfully from GHCi.

Execute the given command. Further arguments can be passed in.

exe "ls" "-l"

See also loadExe and loadEnv.

Create a Proc from a command and a list of arguments.

Run's a Proc in IO. This is usually not required, as most commands in Shh are polymorphic in their return type, and work just fine in IO directly.

Type representing a series or pipeline (or both) of shell commands.

This class is used to allow most of the operators in Shh to be polymorphic in their return value. This makes using them in an IO context easier (we can avoid having to prepend everything with a runProc).

Type used to represent destinations for redirects. Truncate file is like > file in a shell, and Append file is like >> file.

Shortcut for Truncate "/dev/null"

Like withRead except it splits the string with split0 first.

Like withRead except it splits the string with lines first.

NB: Please consider using withReadSplit0 where you can.

Like withRead except it splits the string with words first.

Read the stdout of a Proc. This captures stdout, so further piping will not see anything on the input.

This is strict, so the whole output is read into a String. See withRead for a lazy version that can be used for streaming.

Like readProc, but trim leading and tailing whitespace.

A convinience function for reading in a "\NUL" seperated list of strings. This is commonly used when dealing with paths.

readSplit0 $ find "-print0"

A convinience function for reading the output lines of a Proc.

Note: Please consider using readSplit0 instead if you can.

Read output into a list of words

Like readProc, but attempts to read the result.

Infix version of writeProc

Flipped, infix version of writeProc

Read and write to a Proc. Same as readProc proc <<< input

Some as readWriteProc. Apply a Proc to a String.

>>> apply shasum "Hello"
"f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0  -\n"

Trim leading and tailing whitespace.

Function that splits '\0' seperated list of strings. Useful in conjuction with find . "-print0".

When a process exits with a non-zero exit code we throw this Failure exception.

The only exception to this is when a process is terminated by SIGPIPE in a pipeline, in which case we ignore it.

Run a Proc action, ignoring any Failure exceptions. This can be used to prevent a process from interrupting a whole pipeline.

>>> false `|>` (sleep 2 >> echo 1)
*** Exception: Command `false` failed [exit 1]

>>> (ignoreFailure  false) `|>` (sleep 2 >> echo 1)
1

Run a Proc action, catching an Failure exceptions and returning them.

Run an Proc action returning the return code if an exception was thrown, and 0 if it wasn't.

A class for things that can be converted to arguments on the command line. The default implementation is to use show.

Specify how executables should be referenced.

Load the given executables into the program, checking their executability and creating a function missingExecutables to do a runtime check for their availability.

Scans your '$PATH' environment variable and creates a function for each executable found. Binaries that would not create valid Haskell identifiers are ignored. It also creates the IO action missingExecutables which will do a runtime check to ensure all the executables that were found at compile time still exist.

Same as load, but allows you to modify the function names.

Like loadEnv, but allows you to modify the function name that would be generated.

Create a function for the executable named

$(loadExeAs fnName executable) defines a function called fnName which executes the path in executable.