# README
log
log provides functionality for logging messages at various severity levels.
Functions
debug(msg, *misc, **kv)
Logs a message at the debug log level.
Parameters
| name | type | description |
|---|---|---|
msg | string | The message to log. |
misc | *args | Additional message arguments will be concatenated to the message string separated by a space. |
kv | **kwargs | Key-value pairs to provide additional debug information. |
Examples
basic
Log a debug message with additional information.
load("log", "debug")
debug("Fetching data at", "21:40", retry_attempt=1)
{"retry_attempt": 1}
info(msg, *misc, **kv)
Logs a message at the info log level.
Parameters
| name | type | description |
|---|---|---|
msg | string | The message to log. |
misc | *args | Additional message arguments will be concatenated to the message string separated by a space. |
kv | **kwargs | Key-value pairs to provide additional information. |
Examples
basic
Log an info message with additional information.
load("log", "info")
info("Data fetched", response_time=42)
warn(msg, *misc, **kv)
Logs a message at the warn log level.
Parameters
| name | type | description |
|---|---|---|
msg | string | The message to log. |
misc | *args | Additional message arguments will be concatenated to the message string separated by a space. |
kv | **kwargs | Key-value pairs to provide additional warning information. |
Examples
basic
Log a warning message with additional information.
load("log", "warn")
warn("Fetching data took longer than expected", response_time=123)
error(msg, *misc, **kv)
Logs a message at the error log level and returns an error.
Parameters
| name | type | description |
|---|---|---|
msg | string | The message to log. |
misc | *args | Additional message arguments will be concatenated to the message string separated by a space. |
kv | **kwargs | Key-value pairs to provide additional error information. |
Examples
basic
Log an error message with additional information.
load("log", "error")
error("Failed to fetch data", response_time=240)
fatal(msg, *misc, **kv)
Logs a message at the error log level, returns a fail(msg) to halt program execution.
Parameters
| name | type | description |
|---|---|---|
msg | string | The message to log. |
misc | *args | Additional message arguments will be concatenated to the message string separated by a space. |
kv | **kwargs | Key-value pairs to provide additional fatal error information. |
Examples
basic
Log a fatal error message with additional information.
load("log", "fatal")
fatal("Failed to fetch data and cannot recover", retry_attempts=3, response_time=360)