flow-storm.fn-sampler.core — com.github.jpmonettas/flow-storm-inst 3.3.313

Instrument entire namespaces for sampling fn args and return values.

The main entry point is flow-storm.fn-sampler.core/sample

When instrumented namespaces code runs, the sampler will collect fns into a map {fully-qualified-fn-symbol-1 {:args-types #{...} :return-types #{...} :call-examples #{...} :var-meta {...}} fully-qualified-fn-symbol-2 {...} ...}

end save it into a edn file then wrapped into a jar.

:args-type is a set of vectors with sampled types descriptions.

:return-types is a set of sampled types descriptions.

:call-examples is a set of {:args [sv] :ret sv} where sv is the value serialization of the sampled value. See serialize-val to see how values get serialized.

:var-meta is meta as returned by Clojure (meta (var fully-qualified-fn-symbol))

*tracing* clj

add-vars-meta clj

(add-vars-meta fns-map)

collect-fn-call clj

(collect-fn-call {:keys [collected-fns]} fn-call)

context clj

empty-stats clj

(empty-stats)

max-map-keys clj

max-samples-per-fn clj

peek-thread-frame clj

(peek-thread-frame {:keys [threads-stacks]} thread-id)

pop-thread-frame clj

(pop-thread-frame {:keys [threads-stacks]} thread-id)

push-thread-frame clj

(push-thread-frame {:keys [threads-stacks]} thread-id frame)

report-stats clj

(report-stats {:keys [inst-fns sampled-fns]})

sample clj macro

(sample {:keys [uninstrument? inst-ns-prefixes print-unsampled?] :as config}
        &
        forms)

Expands into code for sampling the executions of FORMS.

serialize-call-examples clj

(serialize-call-examples {:keys [examples-pprint? examples-print-length
                                 examples-print-level]}
                         collected-fns)

set-stats-inst-fns clj

(set-stats-inst-fns {:keys [stats]} {:keys [inst-fns]})

trace-fn-call clj

(trace-fn-call fn-call-data)

trace-fn-return clj

(trace-fn-return {:keys [return]})

type-desc clj

(type-desc o)

If o is non nil, returns a string description for the type of o

type-name clj

(type-name o)

update-stats clj

(update-stats {:keys [stats]} {:keys [ns fn-name]})