BuildBox.Command.File

Working with the file system.

Documentation

data PropFile

Properties of the file system we can test for.

Constructors

HasExecutable String

Some executable is in the current path.

HasFile FilePath

Some file exists.

HasDir FilePath

Some directory exists.

FileEmpty FilePath

Some file is empty.

Instances

Show PropFile

Methods

showsPrec :: Int -> PropFile -> ShowS

show :: PropFile -> String

showList :: [PropFile] -> ShowS

Testable PropFile

Methods

test :: PropFile -> Build Bool

inDir :: FilePath -> Build a -> Build a

Run a command in a different working directory. Throws an error if the directory doesn't exist.

inScratchDir :: FilePath -> Build a -> Build a

Create a new directory with the given name, run a command within it, then change out and recursively delete the directory. Throws an error if a directory with the given name already exists.

clobberDir :: FilePath -> Build ()

Delete a dir recursively if it's there, otherwise do nothing.

ensureDir :: FilePath -> Build ()

Create a new directory if it isn't already there, or return successfully if it is.

withTempFile :: (FilePath -> Build a) -> Build a

Create a temp file, pass it to some command, then delete the file after the command finishes.

atomicWriteFile :: FilePath -> String -> Build ()

Atomically write a file by first writing it to a tmp file then renaming it. This prevents concurrent processes from reading half-written files.

exe :: String

The file extension for an executable on the current system.