Log a debug leaf line — log

The most verbose leaf level, for fine-grained diagnostic detail that would be noisy at the default verbosity. Shown only when verbosity is "debug" (see logtree_threshold()). Like log_info() and log_success(), it does not elevate the enclosing step's status – unlike log_warn()/log_error().

Usage

log_debug(msg, close = FALSE, summary = NA)

Arguments

msg: Character scalar.
close: Logical. When TRUE, force-close the enclosing section after this line: the line is shown as the section's terminal (corner) line and its Done line is suppressed. Defaults to FALSE.
summary: Whether to record this line in the logtree_summary() digest. NA (default) records it only when it is a warning or error; TRUE always records it; FALSE never does.

Value

NULL, invisibly.

Examples

logtree_reset()
logtree_threshold("debug")
log_debug("Cache miss for key user:42")
#> ⚙ Cache miss for key user:42
logtree_threshold("info")