convex.run.stream — world.convex/run.clj 0.0.0-alpha2

Handling files and STDIO streams.

A stream is an id that represents an opened file or a STDIO streams. Those ids are kept in env.

All operations, such as closing a stream or reading one, rely on operation.

Used for implementing IO requests.

close clj

(close env id)

Closes the requested stream.

close-all clj

(close-all {:as env :convex.run/keys [stream+]})

Closes all streams in env.

Not needed if the runner is run standalone since the OS closes them when the process terminates.

file-in clj

(file-in env path)

Opens an input stream for file under path.

file-out clj

(file-out env path)

Opens an output stream for file under path.

flush clj

(flush env id)

Flushes the requested stream.

id-stderr clj

Id of STDERR.

in clj

(in env id)

Reads a single cell from the requested stream.

in+ clj

(in+ env id)

Reads all available cells from the requested stream and closes it.

line+ clj

(line+ env id)

Reads a line from the requested stream and parses it into a list of cells.

operation clj

(operation env id op+ f)

Generic function for carrying out an operation.

Retrieves the stream associated with id and executes (f env stream).

Takes care of failure.

out clj

(out env id cell)

Writes cell to the requested stream.

out! clj

(out! env id cell)

Like out but appends a new line and flushes the stream.