clojure.repl — buttle 0.1.0

Utilities meant to be used interactively at the REPL

apropos clj

(apropos str-or-pattern)

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

demunge clj

(demunge fn-name)

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

dir clj macro

(dir nsname)

Prints a sorted directory of public vars in a namespace

dir-fn clj

(dir-fn ns)

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

doc clj macro

(doc name)

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

find-doc clj

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

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

pst clj

(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 the most recent repl exception (*e), and a depth of 12.

root-cause clj

(root-cause t)

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

set-break-handler! clj

(set-break-handler!)

(set-break-handler! f)

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

source clj macro

(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 a namespace for which the .clj is in the classpath.

Example: (source filter)

source-fn clj

(source-fn x)

Returns a string of the source code for the given symbol, if it can find it. This requires that the symbol resolve to a Var defined in a namespace for which the .clj is in the classpath. Returns nil if it can't find the source. For most REPL usage, 'source' is more convenient.

Example: (source-fn 'filter)

stack-element-str clj

(stack-element-str el)

Returns a (possibly unmunged) string representation of a StackTraceElement

thread-stopper clj

(thread-stopper)

(thread-stopper thread)

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