Deborah.Sarah.JobLoggerTools

assert_benji(
    cond::Bool, 
    msg::AbstractString, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Assert that cond is true. If false, log an error with timestamp and job ID, then throw.

Arguments

• cond: Boolean condition to assert.
• msg: Message to print if assertion fails.
• jobid: Optional job identifier.

debug_benji(
    msg::AbstractString, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print a timestamped debug message with optional job ID.

The message is prefixed with [DEBUG], and flushed to stdout.

Arguments

• msg: Debug message to print.
• jobid: Optional job identifier.

error_benji(
    msg::AbstractString, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print an error message with timestamp and job ID (if given), then throw an error with the same message.

Also flushes stdout and stderr after printing.

info_benji(
    msg::AbstractString, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print a timestamped informational message with optional job ID.

The message is prefixed with [INFO], and flushed to stdout.

Arguments

• msg: Informational message to print.
• jobid: Optional job identifier.

log_stage_benji(
    title::String, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print a high-level stage delimiter with a title, surrounded by = lines.

Useful for separating major processing stages in logs.

log_stage_sub1_benji(
    title::String, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print a substage delimiter with a title, surrounded by - lines.

Used for visually marking sub-sections in logs.

println_benji(
    msg::AbstractString, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print a timestamped log message with optional job ID.

Arguments

• msg: The message to print.
• jobid: Optional job identifier to prepend.

Output is printed to stdout, immediately flushed.

warn_benji(
    msg::AbstractString, 
    jobid::Union{Nothing, String}=nothing
) -> Nothing

Print a timestamped warning message with optional job ID.

The message is prefixed with [WARNING], and flushed to stdout.

Arguments

• msg: Warning message to print.
• jobid: Optional job identifier.

@logtime_benji(
    jobid_expr, 
    expr
) -> Any

Macro that times and logs the execution of an expression, with optional GC allocation info.

Arguments

• jobid_expr: Optional job ID (can be nothing).
• expr: Any Julia expression to execute and time.

Logs elapsed time and memory usage with a timestamp. Returns the value of expr.