Shell Utilities

(copy src dest)

Copy a file or directory recursively from one location to another. Expects input to be unix style paths

(copy-file src-path dst-path)

Copy a file from source to destination. Creates all directories in the path to the destination file if they do not exist.

(create-dirs dir-path)

Create all directories in path specified as string including itself.

(devnull)

get the /dev/null equivalent of the current platform as an open file

(escape & args)

Output a string with all arguments correctly quoted

(exec & args)

Execute command specified by args returning its exit code

(exec-fail & args)

Execute command specified by args, fails when command exits with non-zero exit code

(exec-slurp & args)

It executes args with os/spawn and throws an error if the process returns with non-zero exit code. If the process exits with zero exit code, this function trims standard output of the process and returns it. Before the function finishes, the spawned process is closed for resource control.

(exec-slurp-all & args)

It executes args with os/spawn and returns a struct which has the following keys.

• :out - trimmed standard output of the process
• :err - trimmed standard error of the process
• :status - the exit code of the process

Before the function finishes, the spawned process is closed for resource control.

(exists? path)

Check if the given file or directory exists. (Follows symlinks)

(list-all-files dir &opt into)

List the files in the given directory recursively. Return the paths to all files found, relative to the current working directory if the given path is a relative path, or as an absolute path otherwise.

(make-new-file file-path &opt mode)

Create and open a file, creating all the directories leading to the file if they do not exist, and return it. By default, open as a writable file (mode is :w).

(rm path)

Remove a directory and all sub directories recursively.

(scan-directory dir func)

Scan a directory recursively, applying the given function on all files and directories in a depth-first manner. This function has no effect if the directory does not exist.

(split s)

Split a string into 'sh like' tokens, returns nil if unable to parse the string.