clojure.tools.trace — org.clojure/tools.trace 0.7.11

This file defines simple tracing macros to help you see what your code is doing.

deftrace clj macro

(deftrace name & definition)

Use in place of defn; traces each call/return of this fn, including arguments. Nested calls to deftrace'd functions will print a tree-like structure. The first argument of the form definition can be a doc string

dotrace clj macro

(dotrace fnames & exprs)

Given a sequence of function identifiers, evaluate the body expressions in an environment in which the identifiers are bound to the traced functions. Does not work on inlined functions, such as clojure.core/+

ThrowableRecompose clj protocol

Protocol to isolate trace-form from convoluted throwables that do not have a constructor with a single string argument.

clone-throwable attempts to clone a throwable with a human readable stack trace and message :) It must return a throwable of the same class. If not clonable, the original throwable should be returned. At least this will preserve the original throwable information.

Cloning should be non-obtrusive hence internal exceptions should be silently swallowed and return the original throwable.

clone-throwable clj

(clone-throwable this stack-trace args)

trace clj

(trace value)

(trace name value)

Sends name (optional) and value to the tracer function, then returns value. May be wrapped around any expression without affecting the result.

trace-forms clj macro

(trace-forms & body)

Trace all the forms in the given body. Returns any underlying uncaught exceptions that may make the forms fail.

trace-ns clj macro

(trace-ns n)

Trace all fns in the given name space. The given name space can be quoted, unquoted or stored in a var. We must try to resolve the expression passed to us partially to find out if it needs to be quoted or not when passed to trace-ns*

trace-special-form clj multimethod

trace-vars clj macro

(trace-vars & vs)

Trace each of the specified Vars. The arguments may be Var objects or symbols to be resolved in the current namespace.

traceable? clj

(traceable? v)

Returns true if the given var can be traced, false otherwise

traced? clj

(traced? v)

Returns true if the given var is currently traced, false otherwise

untrace-ns clj macro

(untrace-ns n)

Untrace all fns in the given name space. The given name space can be quoted, unquoted or stored in a var. We must try to resolve the expression passed to us partially to find out if it needs to be quoted or not when passed to untrace-ns*

untrace-vars clj macro

(untrace-vars & vs)

Untrace each of the specified Vars. Reverses the effect of trace-var / trace-vars / trace-ns for each of the arguments, replacing the traced functions with the original, untraced versions.