record_ggplot

<code>record_ggplot</code> captures a complete <code>{ggplot2}</code> expression, evaluates it, and
creates a <code>chronicle</code> object. It uses a robust <code>tryCatch</code> and <code>withCallingHandlers</code>
pattern to reliably capture errors, warnings, and messages.
To trigger all conditions, including rendering-time warnings and messages, it
forces a full render of the plot. This is achieved safely by opening a null
graphics device (<code>pdf(NULL)</code>), scheduling its closure with <code>on.exit(dev.off())</code>,
and then printing the plot. This guarantees that the temporary device is always
closed, even if an error occurs, preventing any side effects on the user's
active graphics session.

Decorate functions to make them return enhanced output. The
enhanced output consists in an object of type 'chronicle' containing
the result of the function applied to its arguments, as well as a log
detailing when the function was run, what were its inputs, what were
the errors (if the function failed to run) and other useful
information. Tools to handle decorated functions are included, such as
a forward pipe operator that makes chaining decorated functions
possible.

Bruno Andr<c3><a9> Rodrigues coelho

chronicler

Add Logging to Functions

Bruno Rodrigues

Matouš Eibich

record_ggplot function

<dl><dt>ggplot_expression</dt>
<dd>The entire <code>{ggplot2}</code> expression to be recorded.</dd>
<dt>strict</dt>
<dd>An optional integer argument controlling what is treated as a failure:<ul>
<li><code>1</code>: Catches only errors.</li>
<li><code>2</code>: Catches errors and warnings (the default).</li>
<li><code>3</code>: Catches errors, warnings, and messages.</li>
</ul></dd></dl>

Arguments

Record a ggplot expression — record_ggplot

<dl>

<dt>ggplot_expression</dt>
<dd>The entire <code>{ggplot2}</code> expression to be recorded.</dd>


<dt>strict</dt>
<dd>An optional integer argument controlling what is treated as a failure:<ul>
<li><code>1</code>: Catches only errors.</li>
<li><code>2</code>: Catches errors and warnings (the default).</li>
<li><code>3</code>: Catches errors, warnings, and messages.</li>
</ul></dd>

</dl>

record_ggplot: Record a ggplot expression

Description

Usage

Value

Arguments