breakerofchains-package: breakerofchains: Break Chained Expressions and Run Them with...

In MilesMcBain/breakerofchains: Break Chained Expressions and Run Them with Printed Output

breakerofchains: Break Chained Expressions and Run Them with Printed Output

Description

Run an infix operator expression chain up to the line your cursor is on, printing the output, and ignoring any result assignment step. This facilitates easier interactive debugging of chained code. Common examples of code amenable to breaking with this tool are dplyr wrangling chained with '

Details

The function you are looking for is break_chain(). Bind it to a keyboard shortcut and run it with the cursor on the line of the chain you want to run up to.

Why do you want this? Do you find yourself appending code to piped expressions in order to break them up for debugging? For example adding I() to the end of a line?

Apart from being an annoying number of keystrokes, using these little debugging trapdoors risks leaving one around in the code and creating further bugs.

break_chain protects you from this class of bugs since you don't need to add code, but also if you are assigning the result of chain with <- or = that assignment is skipped when the chain section is run.

Results are printed, and stored in a global .chain, analogous to .Last.value. So you don't risk accidentally putting strange state into your environment that will leave you scratching your head later.

break_chain works with all infix operators, and so can be used run portions of ggplot2 code chained with +. In addition to RStudio, it is known to work with VSCode.

Author(s)

Maintainer: Miles McBain [e-mail] (ORCID)

See Also

break_chain()

MilesMcBain/breakerofchains documentation built on Nov. 23, 2022, 8:53 p.m.