PROMOTE. A raw plugin answer to an Outcome, pure.
The plugin answers with {"status": "success", "results": ...} or
{"status": "error", "error": ..., "traceback": ...}. Both reference
clients read result["status"] inline at every call site, which is why the
same three-line unwrap appears eighty times in their server and why a
command that forgets it silently returns the envelope instead of the value.
Interpreting once, here, over a VALUE, is the whole difference.
Portable (.cljc since 2026-09-20). It reads the shape gate and its
explanation from hive-gimp.shape, which is data plus plain predicates,
rather than from hive-gimp.schema, which compiles those same shapes with
malli and is therefore JVM only. The schema require is gone on purpose.
PROMOTE. A raw plugin answer to an `Outcome`, pure.
The plugin answers with `{"status": "success", "results": ...}` or
`{"status": "error", "error": ..., "traceback": ...}`. Both reference
clients read `result["status"]` inline at every call site, which is why the
same three-line unwrap appears eighty times in their server and why a
command that forgets it silently returns the envelope instead of the value.
Interpreting once, here, over a VALUE, is the whole difference.
Portable (.cljc since 2026-09-20). It reads the shape gate and its
explanation from `hive-gimp.shape`, which is data plus plain predicates,
rather than from `hive-gimp.schema`, which compiles those same shapes with
malli and is therefore JVM only. The schema require is gone on purpose.(->result outcome)Outcome as a hive-dsl Result, for callers composing with let-ok.
`Outcome` as a hive-dsl Result, for callers composing with `let-ok`.
(from-error command result)A transport or promote failure rendered as an Outcome.
Everything a caller sees is an Outcome, whether it failed inside GIMP,
on the socket, or before a byte was sent. One shape for all three is what
lets the tool layer have a single error path instead of three.
A transport or promote failure rendered as an `Outcome`. Everything a caller sees is an `Outcome`, whether it failed inside GIMP, on the socket, or before a byte was sent. One shape for all three is what lets the tool layer have a single error path instead of three.
(interpret command raw)RawResponse to Outcome.
command is carried through so a caller holding several outcomes can tell
which one failed without correlating by position.
`RawResponse` to `Outcome`. `command` is carried through so a caller holding several outcomes can tell which one failed without correlating by position.
(value outcome)The result of a successful outcome, or nil.
Returns nil for an error ON PURPOSE and is therefore only safe after ok?.
Callers that cannot branch should use ->result instead, which makes the
failure impossible to ignore.
The result of a successful outcome, or nil. Returns nil for an error ON PURPOSE and is therefore only safe after `ok?`. Callers that cannot branch should use `->result` instead, which makes the failure impossible to ignore.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |