@robinpath/log

Structured logging with levels, file output, JSON format, timers, and grouping

Why use this module?

The log module lets you:

• Log a message at DEBUG level to stdout
• Log a message at INFO level to stdout
• Log a message at WARN level to stderr
• Log a message at ERROR level to stderr
• Log a message at FATAL level to stderr

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/log

Quick Start

No credentials needed — start using it right away:

log.info "Server started on port" $port

Available Functions

| Function | Description | |----------|-------------| | log.debug | Log a message at DEBUG level to stdout | | log.info | Log a message at INFO level to stdout | | log.warn | Log a message at WARN level to stderr | | log.error | Log a message at ERROR level to stderr | | log.fatal | Log a message at FATAL level to stderr | | log.setLevel | Set the minimum log level; messages below this level are suppressed | | log.getLevel | Get the current minimum log level as a string | | log.setFile | Set a file path to append log output to in addition to stdout/stderr | | log.setFormat | Set the output format for log messages | | log.clear | Reset all log settings to defaults (info level, no file, text format) | | log.table | Pretty-print an array of objects as a table to stdout | | log.group | Print a group header and increase indentation for subsequent log messages | | log.groupEnd | End the current group and decrease indentation | | log.time | Start a named timer | | log.timeEnd | Stop a named timer and log the elapsed time in milliseconds |

Examples

Log a message at INFO level to stdout

log.info "Server started on port" $port

Log a message at WARN level to stderr

log.warn "Deprecated function called"

Log a message at ERROR level to stderr

log.error "Failed to connect:" $err

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/log";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  log.info "Server started on port" $port
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT