API forclojure.repl -Clojurev1.13.0 (in development)

Overview

Utilities meant to be used interactively at the REPL

Usage: (apropos str-or-pattern)

Given a regular expression or stringable thing, return a seq of allpublic definitions in all currently-loaded namespaces that match thestr-or-pattern.

Usage: (demunge fn-name)

Given a string representation of a fn class,as in a stack trace element, returns a readable version.

Usage: (dir nsname)

Prints a sorted directory of public vars in a namespace

Usage: (dir-fn ns)

Returns a sorted seq of symbols naming public vars ina namespace or namespace alias. Looks for aliases in *ns*

Usage: (doc name)

Prints documentation for a var or special form given its name,or for a spec if given a keyword

Usage: (find-doc re-string-or-pattern)

Prints documentation for any var whose documentation or namecontains a match for re-string-or-pattern

Usage: (pst)       (pst e-or-depth)       (pst e depth)

Prints a stack trace of the exception, to the depth requested. If none supplied, uses the root cause of themost recent repl exception (*e), and a depth of 12.

Usage: (root-cause t)

Returns the initial cause of an exception or error by peeling off all ofits wrappers

Usage: (set-break-handler!)       (set-break-handler! f)

Register INT signal handler.  After calling this, Ctrl-C will causethe given function f to be called with a single argument, the signal.Uses thread-stopper if no function given.

Usage: (source n)

Prints the source code for the given symbol, if it can find it.This requires that the symbol resolve to a Var defined in anamespace for which the .clj is in the classpath.Example: (source filter)

Usage: (source-fn x)

Returns a string of the source code for the given symbol, if it canfind it.  This requires that the symbol resolve to a Var defined ina namespace for which the .clj is in the classpath.  Returns nil ifit can't find the source.  For most REPL usage, 'source' is moreconvenient.Example: (source-fn 'filter)

Usage: (stack-element-str el)

Returns a (possibly unmunged) string representation of a StackTraceElement

Usage: (thread-stopper)       (thread-stopper thread)

Returns a function that takes one arg and uses that as an exception messageto stop the given thread.  Defaults to the current thread

clojure.repl.deps

clojure.repl.deps provides facilities for dynamically modifying the availablelibraries in the runtime when running at the REPL, without restarting

Usage: (add-lib lib coord)       (add-lib lib)

Given a lib that is not yet on the repl classpath, make it available bydownloading the library if necessary and adding it to the classloader.Libs already on the classpath are not updated. Requires a valid parentDynamicClassLoader. lib - symbol identifying a library, for Maven: groupId/artifactId coord - optional map of location information specific to the procurer,         or latest if not suppliedReturns coll of libs loaded, including transitive (or nil if none).For info on libs, coords, and versions, see:https://clojure.org/reference/deps_and_cli

Usage: (add-libs lib-coords)

Given lib-coords, a map of lib to coord, will resolve all transitive deps for the libstogether and add them to the repl classpath, unlike separate calls to add-lib.

Usage: (sync-deps & {:as opts})

Calls add-libs with any libs present in deps.edn but not yet present on the classpath.:aliases - coll of alias keywords to use during the sync