echo: Echo

In echo: Echo Code Evaluations

Echo

Description

Echo expression or a file

Usage

echo(
  expr,
  log = echo_get_log(),
  msg = echo_get_msg(),
  level = echo_get_level(),
  file = NULL
)

Arguments

expr	Expression to evaluate; should be written with curly braces (see examples)
log	A connection or file name for outputs; defaults to stdout()
msg	Logical, if FALSE does not output a message; defaults to TRUE
level	Sets the echo level (see details); defaults to 0L
file	File path to evaluate (like base::source()). If file is not NULL, then expr must be missing'

Details

Levels of output can be controlled with level:

0

EXP: logs expressions that were evaluated

1

OUT: logs outputs from expressions

2

MSG: logs messages

3

WRN: logs warnings

4

ERR: logs errors

When set, all outputs at the level or below are run. Errors are always logged as they will interrupt and stop the program.

Timestamps are printed in UTC by default. To control this, set the option value, such as options(echo.timezone = "EST").

Value

Nothing, called for side-effects

Examples

# make sure to use braces for expr
echo(letters, level = 0)   # bad
echo({letters}, level = 0) # good

try(echo(
  expr = {
    print(1 + 1)
    Sys.sleep(2)
    head(mtcars)
    message(1)
    warning(2)
    stop(3)
  },
  level = 0
))


# Parse lines in a file instead
try(echo(file = system.file("example-script.R", package = "echo")))

# Note that
x <- c("example for", "writing lines")
echo({
  x
  print(x)
  writeLines(x)
}, level = 0)

echo documentation built on May 31, 2023, 7:03 p.m.