taoensso.tufte
A simple, fast, monitoring profiler for Clojure/Script.
Core API:
These macros conditionally[1] activate thread-local or dynamic (multi-threaded) profiling for their body:
(profiled [level & body] [level :when test & body])
(profiled-dynamic [level & body] [level :when test & body])
(profile [level stats-id & body] [level stats-id :when test & body])
(profile-dynamic [level stats-id & body] [level stats-id :when test & body])
profiled* ALWAYS returns [<result> ?<thread-local-stats>] vector.
profile* ALWAYS returns <result>; and handles[2] ?<thread-local-stats>.
[1] Compile-time elision for: [level ns] Runtime filtering for: [level ns (test)] ; Note optional arbitrary test
[2] See set-handler! to un/register handler fn/s (e.g. for logging or
further analysis).
This macro conditionally[3] records body execution times when profiling is active:
(p [form-id & body] [level form-id & body]) ; ALWAYS returns body's result
[3] Compile-time elision for: [level ns] Runtime filtering for: [profiling-active?]
Please see the API docs for more info.
How/where to use this library:
Tufte is highly optimized: even without elision, you can usually leave profiling code in production (e.g. for sampled profiling, or to detect unusual performance behaviour). Tufte's stats maps are well suited to programmatic inspection + analysis.
A simple, fast, monitoring profiler for Clojure/Script.
Core API:
=========
These macros conditionally[1] activate thread-local or dynamic
(multi-threaded) profiling for their body:
(profiled [level & body] [level :when test & body])
(profiled-dynamic [level & body] [level :when test & body])
(profile [level stats-id & body] [level stats-id :when test & body])
(profile-dynamic [level stats-id & body] [level stats-id :when test & body])
`profiled*` ALWAYS returns [<result> ?<thread-local-stats>] vector.
`profile*` ALWAYS returns <result>; and handles[2] ?<thread-local-stats>.
[1] Compile-time elision for: [level ns]
Runtime filtering for: [level ns (test)] ; Note optional arbitrary test
[2] See `set-handler!` to un/register handler fn/s (e.g. for logging or
further analysis).
-------------------------------------------------------------------------
This macro conditionally[3] records body execution times when profiling
is active:
(p [form-id & body] [level form-id & body]) ; ALWAYS returns body's result
[3] Compile-time elision for: [level ns]
Runtime filtering for: [profiling-active?]
Please see the API docs for more info.
How/where to use this library:
==============================
Tufte is highly optimized: even without elision, you can usually leave
profiling code in production (e.g. for sampled profiling, or to detect
unusual performance behaviour). Tufte's stats maps are well suited to
programmatic inspection + analysis.- *min-level*
- *ns-filter*
- -compile-ns-filter
- -elide?
- -fn-sigs
- -handle!
- accumulate-stats
- chance
- compile-ns-filter
- defnp
- fnp
- format-stats
- HandlerVal
- invalid-form-level-msg
- invalid-min-level-msg
- may-profile?
- merge-stats
- p
- profile
- profile-dynamic
- profiled
- profiled-dynamic
- profiling?
- pspy
- set-basic-println-handler!
- set-handler!
- set-min-level!
- set-ns-pattern!
- start-thread-local-profiling!
- stats-accumulator
- stop-thread-local-profiling!
- valid-form-level
- valid-form-level?
- valid-min-level
- valid-min-level?
- with-min-level
- with-ns-pattern
taoensso.tufte.examples
No vars found in this namespace.
taoensso.tufte.impl
Private implementation details.
Private implementation details.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close