Package: restorepoint 0.2

Roman Zenka

restorepoint: Debugging with Restore Points

Debugging with restore points instead of break points. A restore point stores all local variables when called inside a function. The stored values can later be retrieved and evaluated in a modified R console that replicates the function's environment. To debug step by step, one can simply copy & paste the function body from the R script. Particularly convenient in combination with "RStudio". See the "Github" page inst/vignettes for a tutorial.

Authors:Sebastian Kranz [aut, cre], Roman Zenka [ctb]

restorepoint_0.2.tar.gz
restorepoint_0.2.zip(r-4.5)restorepoint_0.2.zip(r-4.4)restorepoint_0.2.zip(r-4.3)
restorepoint_0.2.tgz(r-4.4-any)restorepoint_0.2.tgz(r-4.3-any)
restorepoint_0.2.tar.gz(r-4.5-noble)restorepoint_0.2.tar.gz(r-4.4-noble)
restorepoint_0.2.tgz(r-4.4-emscripten)restorepoint_0.2.tgz(r-4.3-emscripten)
restorepoint.pdf |restorepoint.html✨
restorepoint/json (API)
NEWS

# Install 'restorepoint' in R:
install.packages('restorepoint', repos = c('https://skranz.r-universe.dev', 'https://cloud.r-project.org'))

Peer review:

Bug tracker:https://github.com/skranz/restorepoint/issues

On CRAN:

debugging

6.16 score 15 stars 41 packages 78 scripts 56 downloads 19 exports 0 dependencies

Last updated 6 months agofrom:586ff0b271 (on master). Checks:OK: 5 NOTE: 2. Indexed: yes.

TargetResultDate
Doc / VignettesOKDec 01 2024
R-4.5-winOKDec 01 2024
R-4.5-linuxOKDec 01 2024
R-4.4-winNOTEDec 01 2024
R-4.4-macNOTEDec 01 2024
R-4.3-winOKDec 01 2024
R-4.3-macOKDec 01 2024

Exports:add.restore.point.testassertbreak.pointcalls.to.traceclone.environmentcopy.into.envdisable.restore.pointsenv.consoleeval.with.error.traceget.restore.point.optionsget.stored.dotsget.stored.object.listis.storingrestore.objectsrestore.pointrestore.point.browserrestore.point.optionsset.storingstore.objects

Dependencies:

Readme and manuals

Help Manual

Help pageTopics
Add one or several test functionsadd.restore.point.test
Checks whether cond holds true if not throws an errorassert
Sets a break point that can be debugged like a restore pointbreak.point
Transforms a list returned by sys.calls into a vector of strings that looks like a result of traceback()calls.to.trace
Checks whether for the installed R version the function env.console is able to correctly parse R expressions that extend over more than a linecan.parse.multi.line
Deep copy of an environmentclone.environment
Copies all members of a list or environment into an environmentcopy.into.env
A default error string function for eval with error tracedefault.error.string.fun
Globally disable or enable restore pointsdisable.restore.points
Emulates an R console that evaluates expressions in the specified environement env. You return to the standard R console by pressing ESCenv.console
Evals the expression such that if an error is encountered a traceback is added to the error message.eval.with.error.trace
Get global options for restore pointsget.restore.point.options
Returns the ellipsis (...) that has been stored in restore.point name as a listget.stored.dots
Retrieves the list of all restore.points with the stored objectsget.stored.object.list
Check whether objects currently are stored or notis.storing
Restore stored objects by copying them into the specified environment. Is used by restore.pointrestore.objects
Sets a restore pointrestore.point
Examing a previously stored restore point by invoking the browser.restore.point.browser
Set global options for restore pointsrestore.point.options
Set whether objects shall be stored or notset.storing
Stores all local objects of the calling environment to be able to restore them later when debugging. Is used by restore.pointstore.objects