clojure.tools.namespace.repl — org.clojure/tools.namespace 1.5.0

REPL utilities for working with namespaces

clear clj

(clear)

Clears all state from the namespace/file tracker. This may help repair the namespace tracker when it gets into an inconsistent state, without restarting the Clojure process. The next call to 'refresh' will reload all source files, but may not completely remove stale code from deleted files.

disable-reload! clj

(disable-reload!)

(disable-reload! namespace)

Adds metadata to namespace (or ns if unspecified) telling 'refresh' not to load it. Implies disable-unload! also.

Warning: Aliases to reloaded namespaces will break.

disable-unload! clj

(disable-unload!)

(disable-unload! namespace)

Adds metadata to namespace (or ns if unspecified) telling 'refresh' not to unload it. The namespace may still be reloaded, it just won't be removed first.

Warning: Aliases to reloaded namespaces will break.

refresh clj

(refresh & options)

Scans source code directories for files which have changed (since the last time this function was run) and reloads them in dependency order. Returns :ok or an error; sets the latest exception to clojure.core/*e (if *e is thread-bound).

The directories to be scanned are controlled by 'set-refresh-dirs'; defaults to all directories on the Java classpath.

Options are key-value pairs. Valid options are:

:after   Namespace-qualified symbol naming a zero-argument
         function to be invoked after a successful refresh. This
         symbol will be resolved *after* all namespaces have
         been reloaded.

refresh-all clj

(refresh-all & options)

Scans source code directories for all Clojure source files and reloads them in dependency order.

The directories to be scanned are controlled by 'set-refresh-dirs'; defaults to all directories on the Java classpath.

Options are key-value pairs. Valid options are:

:after   Namespace-qualified symbol naming a zero-argument
         function to be invoked after a successful refresh. This
         symbol will be resolved *after* all namespaces have
         been reloaded.

refresh-dirs clj

refresh-scanned clj

(refresh-scanned & options)

Reloads namespaces in dependency order. Does not scan directories again, expected to be used after 'scan'.

Returns :ok or an error; sets the latest exception to clojure.core/*e (if *e is thread-bound).

The directories to be scanned are controlled by 'set-refresh-dirs'; defaults to all directories on the Java classpath.

Options are key-value pairs. Valid options are:

:after   Namespace-qualified symbol naming a zero-argument
         function to be invoked after a successful refresh. This
         symbol will be resolved *after* all namespaces have
         been reloaded.

refresh-tracker clj

scan clj

(scan)

(scan options)

Scans directories for files which have changed since the last time 'scan' or 'refresh' was run; updates the dependency tracker with new/changed/deleted files.

Optional argument is map of options:

:platform  Either clj (default) or cljs, both defined in
           clojure.tools.namespace.find, controls file extensions
           and reader options.

:add-all?  If true, assumes all extant files are modified regardless
           of filesystem timestamps.

Returns map with keys:

::track/unload   list of namespace symbols that will be unloaded
::track/load     list of namespace symbols that will be loaded

set-refresh-dirs clj

(set-refresh-dirs & dirs)

Sets the directories which are scanned by 'refresh'. Supports the same types as clojure.java.io/file.