.devel/sphinx/rapi/source2.md

In gagolews/realtest: Where Expectations Meet Reality: Realistic Unit Testing

source2: Read and Evaluate Code from an R Script

Description

A simplified alternative to source, which additionally sets some environment variables whilst executing a series of expressions to ease debugging.

Usage

source2(file, local = FALSE)

Arguments

| | | |----|----| | file | usually a file name, see parse | | local | specifies the environment where expressions will be evaluated, see source |

Details

The function sets/updates the following environment variables while evaluating consecutive expressions:

• __FILE__ -- path to the current file,

• __LINE__ -- line number where the currently executed expression begins,

• __EXPR__ -- source code defining the expression.

Value

This function returns nothing.

Author(s)

Marek Gagolewski

See Also

The official online manual of realtest at https://realtest.gagolewski.com/

Examples

# example error handler - report source file and line number
old_option_error <- getOption("error")
options(error=function()
   cat(sprintf(
       "Error in %s:%s.\n", Sys.getenv("__FILE__"), Sys.getenv("__LINE__")
   ), file=stderr()))
# now call source2() to execute an R script that throws some errors...
options(error=old_option_error)  # cleanup

gagolews/realtest documentation built on July 12, 2024, 5:01 p.m.