Pianola.Pianola.Driver

Documentation

simpleDriver :: Protocol o -> Endpoint -> Pianola Protocol LogEntry o a -> Stream FilePath -> EitherT DriverError IO a

Runs a pianola computation. Receives as argument a monadic action to obtain snapshots of type o of a remote system, a connection endpoint to the remote system, a Pianola computation with context of type o and return value of type a, and an infinite stream of filenames to store the screenshots. Textual log messages are written to standard output. The computation may fail with an error of type DriverError.

See also simpleSwingDriver.

data DriverError

Possible failure outcomes when running a pianola computation.

Constructors

DriverIOError IOException

Local exception while storing screenshots or log messages.

PianolaIOError IOException

Exception when connecting the remote system.

PianolaParseError Text

Remote system returns unparseable data.

PianolaSnapshotError Int Int

An operation was requested on an obsolete snapshot (first integer) of the remote system (whose current snapshot number is the second integer).

PianolaServerError Text

Server couldn't complete requested operation (either because it doesn't support the operation or because of an internal error.)

PianolaFailure

Failure from a call to pfail or from a Glance without results.

Instances

Show DriverError

filePathStream :: String -> Int -> String -> FilePath -> Stream FilePath

A more general version of screenshotStream, which allows the client to specify the prefix before the file number, the amount of padding for the file number, and the suffix after the file number.

screenshotStream :: FilePath -> Stream FilePath

Returns an infinite stream of filenames for storing screenshots, located in the directory supplied as a parameter.