eyelogger: Run 'eyeris' commands with automatic logging of R console's...

In eyeris: Flexible, Extensible, & Reproducible Pupillometry Preprocessing

Run eyeris commands with automatic logging of R console's stdout and stderr

Description

This utility function evaluates eyeris commands while automatically capturing and recording both standard output (stdout) and standard error (stderr) to timestamped log files in your desired log directory.

Usage

eyelogger(
  eyeris_cmd,
  log_dir = file.path(tempdir(), "eyeris_logs"),
  timestamp_format = "%Y%m%d_%H%M%S"
)

Arguments

eyeris_cmd	An eyeris command, wrapped in {} if multiline.
log_dir	Character path to the desired log directory. Is set to the temporary directory given by tempdir() by default.
timestamp_format	Format string passed to format(Sys.time()) for naming the log files. Defaults to "%Y%m%d_%H%M%S".

Details

Each run produces two log files:

• ⁠<timestamp>.out⁠: records all console output

• ⁠<timestamp>.err⁠: records all warnings and errors

Value

The result of the evaluated eyeris command (invisibly).

Examples

eyelogger({
  message("eyeris `glassbox()` completed successfully.")
  warning("eyeris `glassbox()` completed with warnings.")
  print("some eyeris-related information.")
})

eyelogger({
  glassbox(eyelink_asc_demo_dataset(), interactive_preview = FALSE)
}, log_dir = file.path(tempdir(), "eyeris_logs"))

eyeris documentation built on June 13, 2025, 5:09 p.m.