Skip to content

Log manager

cutana_ui.utils.log_manager

UI logging manager for Cutana UI.

UILogManager

Manages UI logging handlers for loguru.

This class tracks handler IDs to allow cleanup without affecting user handlers. The console handler ID is stored separately to allow dynamic log level changes.

setup(output_dir, session_timestamp=None, console_level=None)

Set up loguru logging for UI with output directory and separate UI files.

This function follows loguru best practices: - Enables cutana logging (disabled by default at import) - Tracks handler IDs to allow cleanup without affecting user handlers

Parameters:

Name Type Description Default
output_dir

Required output directory for logs. Must be provided.

required
session_timestamp

Optional timestamp for log file naming consistency.

None
console_level

Log level for console output. If None, keeps current level.

None

set_console_level(level)

Change the console log level dynamically.

This allows users to adjust the verbosity of logs shown in the Jupyter notebook without affecting file logging.

Parameters:

Name Type Description Default
level str

Log level string (DEBUG, INFO, WARNING, ERROR).

required

setup_ui_logging(output_dir, session_timestamp=None, console_level=None)

Set up loguru logging for UI. Wrapper for UILogManager.setup().

set_console_log_level(level)

Change the console log level dynamically. Wrapper for UILogManager.set_console_level().

get_console_log_level()

Get the current console log level. Returns capitalized level (e.g., 'Warning').