prpr.promise — employeerepublic/promisespromises 2.5.0.1

all-pr clj/s

(all-pr & ps)

always-pr clj/s macro

(always-pr & body)

wraps body in a promise, even if the body exprs throw during evaluation

branch-pr clj/s

(branch-pr p success-fn error-fn)

catch clj/s macro

(catch error-handler & body)

catches any errors and returns the result of applying the error-handler to the error-value

catch-error clj/s macro

(catch-error body)

catches any errors and returns the results of decode-error-value on the error value. has to be a macro to catch any exceptions in the initial evaluation of the body

catch-error-log clj/s macro

(catch-error-log description body)

catch-handle clj/s macro

(catch-handle handlers body)

catch-error and handle - any unhandled tags result in an exception

catch-handle-safe clj/s macro

(catch-handle-safe default-response-or-fn body)

(catch-handle-safe handlers default-response-or-fn body)

catch-error and handle - if a tag is unhandled and a default-response-fn is provided then it will be called with the unhandled variant, if a default response value is provided then a warning will be logged and the default response value will be returned

catch-log clj/s macro

(catch-log description error-handler & body)

catches any errors, logs them and returns the result of applying the error-handler to the error-value

catch-xform-error clj/s macro

(catch-xform-error error-xform body)

catches any errors and returns the results of (error-xform (decode-error-value error-value))

chain-pr clj/s

(chain-pr p & fs)

dado clj/s macro

(dado & body)

alet with a deferred or pr-context

ddo clj/s macro

(ddo & body)

mlet with a deferred or pr-context

decode-error-value clj/s

(decode-error-value v)

decodes an error value to a variant. if the error-value is already a variant, or an ex-info with a variant, it returns that directly, otherwise you will get an [::unknown-error] variant

delay-pr clj/s

(delay-pr delay-ms value)

error-ex clj/s

(error-ex [tag value])

(error-ex tag value)

(error-ex tag value cause)

encodes an error-variant on to an ex-info

error-pr clj/s

(error-pr [tag value])

(error-pr tag value)

(error-pr tag value cause)

creates an errored promise encoding the error-variant

exception? clj/s

(exception? v)

true if the arg is a platform exception

factory-pr clj/s

(factory-pr factory-cb)

promesa-style promise creation - the factory-cb callback will receive resolve and reject fns to complete the promise

finally clj/s macro

(finally callback & body)

finally for promises - makes sure to run the finally even if promise chain init throws. some exceptions might slip through the net - non-Exception Throwables on the jvm for example - but we are probably in deeper trouble anyway if that happens

handle clj/s

(handle handlers [tag value])

handle a variant

• handlers : map of tag to handler

if a handler is not available for the tag then an error-ex with tag ::unhandled-tag will be thrown

handle-safe clj/s

(handle-safe handlers default-response-or-fn [tag value])

safely handle a variant

• handlers : a map of tag to handler

if a handler is not available and a default-response fn is provided it will be called with the unhandled variant, if a default-response value is provided then a warning will be logged for the unhandled variant, and the default response value will be returned

promise? clj/s

(promise? v)

success-pr clj/s

(success-pr value)

creates a promise containing the value

wrap-catch-error clj/s macro

(wrap-catch-error body)

(wrap-catch-error tag body)

wraps any normal responses in a [tag <response>] variant, and catches any errors and returns the results of decode-error-value on the error value. has to be a macro to catch any exceptions in the initial evaluation of the body

wrap-catch-error-log clj/s macro

(wrap-catch-error-log description body)

(wrap-catch-error-log description tag body)

wraps any normal responses in a [tag <response>] variant, and catches any errors and returns the results of decode-error-value on the error value. has to be a macro to catch any exceptions in the initial evaluation of the body