redelay.core — functionalbytes/redelay 1.0.3

Core API for creating and managing first class state objects.

defstate clj macro

(defstate name doc-string? attr-map? body)

Create a State object, using the optional :start, :stop and :meta expressions, and bind it to a var with the given name in the current namespace. Supports metadata on the name, a docstring and an attribute map. Trying to redefine an active (i.e. realized) defstate is skipped.

state clj macro

(state & exprs)

Create a state object, using the optional :start, :stop, :name and :meta expressions. The first forms are implicitly considered as the :start expression, if not qualified otherwise. Returned State object implements IDeref, IPending, Closeable, Named, IMeta and IObj.

state* clj

(state* {:keys [ns-str name-str start-fn stop-fn meta]
         :or {start-fn (fn []) stop-fn (fn [_])}})

Low-level function to create a State object. All keys are optional. The :start-fn value must be a 0-arity function. The :stop-fn value must be a 1-arity function. The :meta value must be a map.

state? clj

(state? obj)

Returns true if obj is a State object.

status clj

(status)

Returns a list of active states, in realization order.

stop clj

(stop)

Stop the active states in the reverse order they were realized.

watchpoint clj

Add watches to this var to be notified of new (started) or old (closed) states.