anomalies-tools.core — dawcs/anomalies-tools 0.1.3

!! clj

*default-category* clj

Default category for new anomaly created with constructor or produced with catch-anomaly and its variations if no category specified

*exception-categories* clj

Map containing Java exception classes and corresponding categories. Used to determine category in catch-anomaly and its variations if no category specified

-alet-impl clj macro

(-alet-impl bindings & body)

alet clj macro

(alet bindings & body)

Anomaly aware version of let, if any of given bindings is evaluated to anomaly, it's returned immediately, otherwise body evaluation result is returned

anomaly clj

(anomaly)

(anomaly cat-msg-data)

(anomaly cat-msg msg-data)

(anomaly cat msg data)

Creates new anomaly with given category(defaults to ::fault) message(optional) and data(optional)

anomaly? clj

(anomaly? x)

Checks if given value is anomaly

aware clj

(aware f)

(aware f v)

Creates anomaly-aware wrapper for given 1-arity function. Wrapper calls function if no anomaly argument given and returns argument otherwise.

aware-> clj macro

(aware-> expr & forms)

When expr is not anomaly, threads it into the first form (via ->), and when that result is not anomaly, through the next etc

aware->> clj macro

(aware->> expr & forms)

When expr is not anomaly, threads it into the first form (via ->>), and when that result is not anomaly, through the next etc

busy clj

catch-all clj macro

(catch-all & body)

Turns all exceptions into anomalies

catch-anomaly clj macro

(catch-anomaly options & body)

Wraps given body to try/catch, turning thrown exceptions into anomalies. First argument should be map of settings or nil(each setting is optional) :category - assigns given category to produced anomaly (default-category is used if nothing specied) :message - assigns given message to produced anomaly (exception message when present is used if nothing specified) :data - assigns given value as data of produced anomaly (exception itself is used if nothing specified) :only - set of exceptions which will be turned into anomalies(other exceptions will be thrown) :except - set of exceptions which will be thrown(other exceptions will be turned into anomalies) :only and :except are mutually exclusive

catch-except clj macro

(catch-except ex & body)

Throws exceptions of given classes, other exceptions are turned into anomalies

catch-only clj macro

(catch-only ex & body)

Turns exceptions of given classes set into anomalies, other exceptions are thrown

category clj

caught clj

(caught v & f)

Creates anomaly-centric function call chain for given value. If given value is not anomaly, it's returned immediately and chain is skipped. If some function in chain returns anomaly, then new anomaly comes to next function in chain, otherwise initial anomaly is passed to next function

chain clj

(chain v & f)

Creates anomaly-aware function call chain for given value. If given value is anomaly or any function in chain returns anomaly, it's returned immediately, rest of the chain is skipped

conflict clj

data clj

either clj

(either v other & others)

If any of given arguments (min 2) is not anomaly, returns it, otherwise returns last given argument

fault clj

forbidden clj

incorrect clj

interrupted clj

message clj

not-found clj

rescue clj

(rescue f)

(rescue f v)

Creates anomaly-aware wrapper for given 1-arity function. Wrapper calls function if anomaly argument given and returns argument otherwise.

unavailable clj

unsupported clj

valid-category? clj

(valid-category? cat)

Checks if given category exists in the list of categories

with-default-category clj macro

(with-default-category default-category & body)

Sets given category as default-category while executing body. Given category should be valid one

with-exception-categories clj macro

(with-exception-categories exception-categories & body)

Sets given map as exception-categories while executing body