rmap.core — functionalbytes/rmap 2.1.1

The core API for recursive maps.

ref clj

(ref key)

(ref key not-found)

Returns the value mapped to key, not-found or nil if key not present.

ref-tag clj

(ref-tag key)

A tagged literal processor, for use with clojure.edn/read-string.

(clojure.edn/read-string {:readers {'rmap/ref rmap.core/ref-tag}} "{:foo 1 :bar #rmap/ref :foo}")

rmap clj macro

(rmap m)

Takes an associative datastructure m and returns m where each of the values are wrapped as an rval. Can be a literal representation, then the unevaluated expressions are passed to rval.

rmap! clj macro

(rmap! m)

(rmap! m f)

Same as rmap, but composed with valuate!.

rval clj macro

(rval & body)

Takes a body of expressions and yields an RVal object. The body is not evaluated yet. The body can use the ref function while it is evaluated. You can bind it locally for use at a later stage.

rval? clj

(rval? x)

Returns true if x is an RVal.

valuate! clj

(valuate! m)

(valuate! m f)

Given associative datastructure m, returns m where all RVal values are evaluated. Takes an optional post-evaluation wrapper function.

valuate-keys! clj

(valuate-keys! m & keys)

Given associative datastructure m, returns m where all RVal values under the given keys and their dependencies are evaluated.