nirs4all.core.logging.handlers module

Custom log handlers for nirs4all logging.

This module provides specialized handlers for throttled progress updates, file rotation, and other custom logging behaviors.

class nirs4all.core.logging.handlers.BufferedHandler(max_size: int = 1000)

Bases: Handler

Handler that buffers log records for batch processing.

Useful for collecting logs during a phase and outputting them together, e.g., for branch comparison summaries.

clear() → None

Clear the buffer.

emit(record: LogRecord) → None

Buffer the log record.

Parameters:

record – Log record to buffer.

flush_to(handler: Handler) → None

Flush buffered records to another handler.

Parameters:

handler – Handler to send buffered records to.

get_records() → list[LogRecord]

Get buffered records.

Returns:

List of buffered log records.

class nirs4all.core.logging.handlers.NullHandler(level=0)

Bases: Handler

Handler that discards all log records.

Used when logging should be completely silent.

emit(record: LogRecord) → None

Discard the log record.

Parameters:

record – Log record (ignored).