hansel.api — com.github.jpmonettas/hansel 0.1.24

instrument clj macro

(instrument config form)

A macro for instrumenting a form using hansel.api/instrument-form. Check that one for params docs.

instrument-form clj

(instrument-form config form)

Given any top level form, returns the form instrumented. config should be a map with optional [:trace-form-init :trace-fn-call :trace-fn-return :trace-expr-exec :trace-bind]

instrument-namespaces-clj clj

(instrument-namespaces-clj ns-prefixes config)

Instrument entire namespaces. ns-prefixes should be a set of ns name prefixes, like : #{"cljs."}

config should be a map optionally containing all the keys for hansel.api/instrument-form plus :

• :verbose? true or false to indicate verbose logging
• :excluding-ns a set of namepsaces names as string to be excluded from instrumentation
• :excluding-fns a set of fully cualified fn symbols to be excluded from instrumentation

instrument-namespaces-shadow-cljs clj

(instrument-namespaces-shadow-cljs ns-prefixes {:keys [build-id] :as config})

Instrument entire namespaces for ClojureScript. The arguments are the same as hansel.api/instrument-namespaces-clj plus the config should also contain a :build-id Meant to be used from shadow-cljs clojure repl (not the ClojureScript one)

The :trace-* handlers should be fully qualified symbols of functions in the ClojureScript runtime.

instrument-var-clj clj

(instrument-var-clj var-symb config)

(instrument-var-clj var-symb
                    {:keys [deep? uninstrument? skip-namespaces] :as config}
                    *instrumented-set)

Given a Clojure var-symb instrument it using hansel.api/instrument-form. Config options are the same as hansel.api/instrument-form plus

• :deep? When true recursively instrument all referenced vars (default to false)
• :skip-namespaces A set of namespaces to skip when instrumenting deeply.

instrument-var-shadow-cljs clj

(instrument-var-shadow-cljs var-symb config)

(instrument-var-shadow-cljs
  var-symb
  {:keys [build-id deep? uninstrument? skip-namespaces] :as config}
  *instrumented-set)

Instrument a var for ClojureScript. The arguments are the same as hansel.api/instrument-var-clj plus the config should also contain a :build-id Meant to be used from shadow-cljs clojure repl (not the ClojureScript one)

The :trace-* handlers should be fully qualified symbols of functions in the ClojureScript runtime.

uninstrument-namespaces-clj clj

(uninstrument-namespaces-clj ns-prefixes)

(uninstrument-namespaces-clj ns-prefixes config)

Uninstrument namespaces instrumented by hansel.api/instrument-namespaces-clj ns-prefixes should be a set of namespaces prefixes as string.

uninstrument-namespaces-shadow-cljs clj

(uninstrument-namespaces-shadow-cljs ns-prefixes config)

Uninstrument namespaces instrumented by hansel.api/instrument-namespaces-shadow-cljs

uninstrument-var-clj clj

(uninstrument-var-clj var-symb)

(uninstrument-var-clj var-symb config)

Uninstrument a Clojure var-symb instrumented by hansel.api/instrument-var-clj

uninstrument-var-shadow-cljs clj

(uninstrument-var-shadow-cljs var-symb config)

Uninstrument vars instrumented by hansel.api/instrument-var-shadow-cljs

with-ctx clj macro

(with-ctx ctx & body)

Run body binding hansel.instrument.runtime/*runtime-ctx* to ctx