cloverage.instrument — camsaul/cloverage 1.2.1

*exclude-calls* clj

The set of symbols that will suppress instrumentation when any are used in the calling position of a form. Useful for excluding problematic macro call sites from coverage metrics.

do-wrap clj multimethod

(do-wrap f line form env)

Traverse the given form and wrap all its sub-forms in a function that evals the form and records that it was called.

eval-form clj

(eval-form filename form line-hint instrumented-form)

Evaluate an instrumented-form.

exclude? clj

(exclude? form)

Whether we should skip instrumenting a form because it is specified in the :exclude-call options.

form-type clj

(form-type form env)

Classifies the given form

instrument clj

(instrument f-var ns-symbol)

Instrument and evaluate the forms in the namespace named by ns-symbol using an instrumentation function referred to by f-var. The instrumentation function has the signature a function with the signature

(f line-hint form) -> instrumented-form

instrument-file clj

(instrument-file f-var lib filename)

Instrument all the forms in a file. Returns sequence of instrumented forms.

instrument-form clj

(instrument-form f-var filename form)

Instrument a single form. Returns instrumented form.

no-instr clj

(no-instr _ form)

Do not change form at all.

nop clj

(nop _ form)

Instrument form with expressions that do nothing.

wrap clj

(wrap f-var line-hint form)

Main interface for wrapping expressions using f. Wrap will return a form that during macroexpansion calls f on form and all sub-expressions of form that can be meaningfully wrapped. f should take an expression and return one that evaluates in exactly the same way, possibly with additional side effects.

wrap-binding clj

(wrap-binding f line-hint [args & body :as form])

Wrap a let/loop binding

e.g. - a (+ a b) (let or loop)

wrap-catch clj

(wrap-catch f line [catch-symbol classname localname & body])

wrap-deftype-defrecord-method clj

(wrap-deftype-defrecord-method f line [meth-name args & body :as method-form])

wrap-finally clj

(wrap-finally f line [finally-symbol & body])

wrap-fn-body clj

(wrap-fn-body f line form)

wrap-overload clj

(wrap-overload f line-hint [args & body :as form])

Wrap a single function overload.

e.g. - ([a b] (+ a b)) or ([n] {:pre [(> n 0)]} (/ 1 n))

wrap-overloads clj

(wrap-overloads f line-hint form)

wrapm clj macro

(wrapm f-sym line-hint form)

Helper macro for wrap. Takes advantage of &env to track lexical scope while walking form.

wrapper clj

(wrapper f line)

Return a function that when called, wraps f through its argument.