space.matterandvoid.subscriptions.impl.core — space.matterandvoid/subscriptions 2022.11.28

<sub clj/s

(<sub app query)

Subscribe and deref a subscription, returning its value, not a reaction.

cache-lookup clj/s

(cache-lookup datasource cache-key)

clear-handlers clj/s

(clear-handlers _db)

(clear-handlers _db id)

clear-sub clj/s

(clear-sub registry)

(clear-sub registry query-id)

clear-subscription-cache! clj/s

(clear-subscription-cache! registry)

Removes all subscriptions from the cache.

deflayer2-sub clj macro

(deflayer2-sub meta-sub-kw sub-name ?path)

Only supports use cases where your datasource is a hashmap.

Takes a symbol for a subscription name and a way to derive a path in your datasource hashmap. Returns a function subscription which itself returns a Reagent RCursor. Supports a vector path, a single keyword, or a function which takes the RAtom datasource and the arguments map passed to subscribe and must return a path vector to use as an RCursor path.

Examples:

(deflayer2-sub my-subscription :a-path-in-your-db)

(deflayer2-sub my-subscription [:a-path-in-your-db])

(deflayer2-sub my-subscription (fn [db-atom sub-args-map] [:a-key (:some-val sub-args-map])))

defsubraw clj macro

(defsubraw meta-sub-kw sub-name args body)

Creates a subscription function that takes the datasource ratom and optionally an args map and returns the subscription value. The return value is wrapped in a Reaction for you, so you do not need to.

deref-input-signals clj/s

get-cache-key clj/s

(get-cache-key _app [query-key :as query-v])

get-handler clj/s

(get-handler id)

get-input-db-signal clj/s

(get-input-db-signal ratom)

get-subscription-cache clj/s

(get-subscription-cache _app)

handler-registry_ clj/s

make-sub-fn clj/s

(make-sub-fn meta-sub-kw query-id sub-args)

parse-reg-sub-args clj/s

(parse-reg-sub-args args)

reg-layer2-sub clj/s

(reg-layer2-sub query-id path-vec-or-fn)

Registers a handler function that returns a Reagent RCursor instead of a Reagent Reaction. Accepts a single keyword, a vector path into or a function which takes your db atom and arguments map passed to subscribe and must return a vector path to be used for the cursor.

reg-sub clj/s

(reg-sub query-id & args)

reg-sub-raw clj/s

(reg-sub-raw query-id handler-fn)

register-handler! clj/s

(register-handler! id handler-fn)

Returns handler-fn after associng it in the map.

set-args-merge-fn! clj/s

(set-args-merge-fn! f)

set-memoize-fn! clj/s

(set-memoize-fn! f)

sub-fn clj/s

(sub-fn meta-fn-key f)

Takes a function that returns either a Reaction or RCursor. Returns a function that when invoked delegates to f and derefs its output. The returned function can be used in subscriptions.

sub-fn->sub-name clj/s

(sub-fn->sub-name sub-fn)

sub-meta-name-kw* clj/s

sub-missing-name! clj/s

(sub-missing-name! sub-fn)

subs-cache_ clj/s

subs-state-path clj/s

(subs-state-path k)

subscribe clj/s

(subscribe app query)

Given a query vector, returns a Reagent reaction which will, over time, reactively deliver a stream of values. Also known as a Signal.

To obtain the current value from the Signal, it must be dereferenced