lambdaisland.tools.namespace.track — lambdaisland/tools.namespace 0.0-237

Dependency tracker which can compute which namespaces need to be reloaded after files have changed. This is the low-level implementation that requires you to find the namespace dependencies yourself: most uses will interact with the wrappers in lambdaisland.tools.namespace.file and lambdaisland.tools.namespace.dir or the public API in lambdaisland.tools.namespace.repl.

add clj/s

(add tracker depmap)

Returns an updated dependency tracker with new/updated namespaces.

Depmap is a map describing the new or modified namespaces. Keys in the map are namespace names (symbols). Values in the map are sets of symbols naming the direct dependencies of each namespace. For example, assuming these ns declarations:

(ns alpha (:require beta))
(ns beta (:require gamma delta))

the depmap would look like this:

{alpha #{beta}
 beta  #{gamma delta}}

After adding new/updated namespaces, the dependency tracker will have two lists associated with the following keys:

:lambdaisland.tools.namespace.track/unload
    is the list of namespaces that need to be removed

:lambdaisland.tools.namespace.track/load
    is the list of namespaces that need to be reloaded

To reload namespaces in the correct order, first remove/unload all namespaces in the 'unload' list, then (re)load all namespaces in the 'load' list. The lambdaisland.tools.namespace.reload namespace has functions to do this.

remove clj/s

(remove tracker names)

Returns an updated dependency tracker from which the namespaces (symbols) have been removed. The ::unload and ::load lists are populated as with 'add'.

tracker clj/s

(tracker)

Returns a new, empty dependency tracker