clojure.java.process — org.clojure/clojure 1.12.0-alpha12

A process invocation API wrapping the Java process API.

The primary function here is 'start' which starts a process and handles the streams as directed. It returns a map that contains keys to access the streams (if available) and the Java Process object. It is also deref-able to wait for process exit.

Use ‘slurp' to capture the output of a process stream, and 'ok?’ to wait for a non-error exit. The 'exec' function handles the common case of `start'ing a process, waiting for process exit, slurp, and return stdout.

exec clj

(exec & opts+args)

Execute a command and on successful exit, return the captured output, else throw RuntimeException. Args are the same as 'start' and options if supplied override the default 'exec' settings.

from-file clj

(from-file f)

Coerce f to a file per clojure.java.io/file and return a ProcessBuilder.Redirect reading from the file. This can be passed to 'start' in :in.

ok? clj

(ok? process-map)

Given the map returned from 'start', wait for the process to exit and then return true on success

start clj

(start & opts+args)

Start an external command, defined in args. The process environment vars are inherited from the parent by default (use :clear-env to clear them).

If needed, provide options in map as first arg: :in - a ProcessBuilder.Redirect (default = :pipe) or :inherit :out - a ProcessBuilder.Redirect (default = :pipe) or :inherit :discard :err - a ProcessBuilder.Redirect (default = :pipe) or :inherit :discard :stdout :dir - current directory when the process runs (default=".") :clear-env - if true, remove all inherited parent env vars :env - {env-var value} of environment variables to set (all strings)

Returns an ILookup containing the java.lang.Process in :process and the streams :in :out :err. The map is also an IDeref that waits for process exit and returns the exit code.

to-file clj

(to-file f & {:keys [append] :as opts})

Coerce f to a file per clojure.java.io/file and return a ProcessBuilder.Redirect writing to the file. Set ':append' in opts to append. This can be passed to 'start' in :out or :err.