redelay.core — functionalbytes/redelay 2.0.1

Core API for creating and managing first class state objects.

close! clj

(close! state)

Close the State, skipping the stop logic.

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. 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 (deref), IPending (realized?), Closeable (.close), IPersistentStack (peek), Named (name, namespace), IMeta (meta) and IReference (alter-meta!, reset-meta!).

state* clj

(state* {:keys [name start-fn stop-fn meta]
         :or {name (gensym "state--") 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 state changes, using add-watch. The third argument to the watch fn will be one of :starting, :started, :stopping or :stopped. The fourth argument is the State object.