postmortem.core — postmortem 0.5.0

*current-session* clj/s

Dynamic var bound to the current session. Don't use this directly, call (current-session) instead.

completed? clj/s

(completed? key)

(completed? session key)

Returns true if the log entry for the specified key has been completed. If session is omitted, the log entry in the current session will be checked.

current-session clj/s

(current-session)

Returns the current session.

dump clj/s macro

(dump key)

(dump key xform)

(dump session key xform)

Saves a local environment map to the log entry corresponding to the specified key. If a transducer xform is specified, it will be applied when adding the environment map to the log entry. Defaults to clojure.core/identity. If session is specified, the environment map will be added to the log entry in that session. Otherwise, the environment map will be added to the log entry in the current session.

frequencies clj/s

(frequencies)

(frequencies session)

Alias for stats. See the docstring for stats for details.

keys clj/s

(keys)

(keys session)

Returns all the log entry keys that the session contains. If session is ommited, the keys will be pulled from the current session.

last-log-for clj/s

(last-log-for key)

(last-log-for session key)

Completes log entry for the specified key and returns the last item in the entry. If session is omitted, the log will be pulled from the current session.

locals clj/s macro

(locals & names)

Creates and returns a local environment map at the call site. A local environment map is a map of keyword representing each local name in the scope at that position, to the value that the local name is bound to.

log-for clj/s

(log-for key)

(log-for session key)

Completes log entry for the specified key and returns a vector of logged items in the entry. If session is omitted, the log will be pulled from the current session.

logs clj/s

(logs)

(logs session)

Completes all log entries and returns a map of key to vector of logged items. If session is omitted, the logs will be pulled from the current session.

logs-for clj/s

(logs-for keys)

(logs-for session keys)

Completes log entries for the specified keys and returns a map of key to vector of logged items. If session is omitted, the logs will be pulled from the current session.

make-logger clj/s

(make-logger)

(make-logger xform)

Creates a simple logger.

A simple logger is a function with two arities that closes over an implicit session. If called with one argument, it acts like (spy>> :key <arg>) on the implicit session. If called with no argument, it acts like (log-for :key).

If a transducer is passed as the optional argument, it will be attached to the implicit session.

make-multi-logger clj/s

(make-multi-logger)

(make-multi-logger xform)

Creates a multi logger.

A multi logger is a variant of the simple logger. If called with two arguments, it acts like (spy>> <arg1> <arg2>) on the implicit session. If called with one argument, it acts like (log-for <arg>). If called with no argument, it acts like(logs)`.

If a transducer is passed as the optional argument, it will be attached to the implicit session.

make-session clj/s

(make-session)

(make-session xform)

Creates and returns a new session. Sessions created by this function are thread-safe and so all updates to them will be synchronized. Only if it is guaranteed that no more than one updates never happen simultaneously, make-unsafe-session can be used instead for better performance. In ClojureScript, make-session is exactly the same as make-unsafe-session.

make-unsafe-session clj/s

(make-unsafe-session)

(make-unsafe-session xform)

Creates and returns a new thread-unsafe session. Updates to a thread-unsafe session won't be synchronized among mulithreads. If all updates to a session need to be synchronized, use make-session instead. In ClojureScript, make-unsafe-session is exactly the same as make-session.

reset! clj/s

(reset!)

(reset! session)

Resets all the log entries. If session is omitted, the entries in the current session will be reset.

reset-key! clj/s

(reset-key! key)

(reset-key! session key)

Resets log entry for the specified key. If session is omitted, the entries in the current session will be reset.

reset-keys! clj/s

(reset-keys! keys)

(reset-keys! session keys)

Resets log entries for the specified keys. If session is omitted, the entries in the current session will be reset.

session? clj/s

(session? x)

Returns true if x is a session.

set-current-session! clj/s

(set-current-session! session)

Sets the current session to the specified one.

spy> clj/s

(spy> x key)

(spy> x key xform)

(spy> x session key xform)

Saves a value to the log entry corresponding to the specified key and returns the value as-is. If a transducer xform is specified, it will be applied when adding the value to the log entry. Defaults to clojure.core/identity. If session is specified, the value will be added to the log entry in that session. Otherwise, the value will be added to the log entry in the current session. spy> is intended to be used in combination with thread-first macros. In thread-last contexts, use spy>> instead.

spy>> clj/s

(spy>> key x)

(spy>> key xform x)

(spy>> session key xform x)

A version of spy> intended to be used in combination with thread-last macros. See the docstring of spy> for more details.

stats clj/s

(stats)

(stats session)

Returns a stats map, which is a map of log entry key to a number that indicates how many log items have been logged for the log entry. If session is omitted, stats for the current session will be returned.

void-session clj/s

(void-session)

Returns a void session, which logs nothing and never triggers a call to transducer. It's useful to disable logging entirely.

with-session clj/s macro

(with-session session & body)

Dynamically binds the current session to the specified one within the body of this form.