Dariusz L
a288b26b66
Enhance logging system with configurable module names and dynamic localStorage keys to avoid conflicts between multiple plugin instances. - Add LOG_MODULE_NAME and DEFAULT_LOGGER_NAME to web/log_system/config.js - Update logger.js to use dynamic storage keys based on module name - Change window property from ResolutionMasterLogger to dynamic key - Add PyDoc metadata to core/log_system/config.py - Add JSDoc metadata blocks to all web log_system files Reorganize web utilities: - Move css-loader.js from web/ to web/utils/ - Add ErrorHandler.js for centralized error handling - Add ResourceManager.js for stylesheet and template loading rename: web/css-loader.js => web/utils/css-loader.js
346 lines
10 KiB
JavaScript
346 lines
10 KiB
JavaScript
/**
|
|
author: Azornes
|
|
title: AzLogs
|
|
version: 1.4.1
|
|
description: Logging Setup - Central logging system
|
|
|
|
Features:
|
|
Logger - Central logging system for comfyui-model-linker
|
|
- Multiple log levels (DEBUG, INFO, WARN, ERROR)
|
|
- Ability to enable/disable logging globally or per module
|
|
- Colorful logs in the console
|
|
- Ability to save logs to localStorage
|
|
- Ability to export logs
|
|
*/
|
|
|
|
import { DEFAULT_LOGGER_NAME, LOG_MODULE_NAME } from './config.js';
|
|
|
|
function padStart(str, targetLength, padString) {
|
|
targetLength = targetLength >> 0;
|
|
padString = String(padString || ' ');
|
|
if (str.length > targetLength) {
|
|
return String(str);
|
|
}
|
|
else {
|
|
targetLength = targetLength - str.length;
|
|
if (targetLength > padString.length) {
|
|
padString += padString.repeat(targetLength / padString.length);
|
|
}
|
|
return padString.slice(0, targetLength) + String(str);
|
|
}
|
|
}
|
|
function sanitizeKeyPart(value) {
|
|
return String(value).replace(/[^a-zA-Z0-9_-]+/g, '_');
|
|
}
|
|
function toPascalCase(value) {
|
|
return String(value)
|
|
.split(/[^a-zA-Z0-9]+/)
|
|
.filter(Boolean)
|
|
.map((part) => part.charAt(0).toUpperCase() + part.slice(1))
|
|
.join('');
|
|
}
|
|
const LOGGER_NAME = LOG_MODULE_NAME || DEFAULT_LOGGER_NAME;
|
|
const STORAGE_PREFIX = sanitizeKeyPart(LOGGER_NAME);
|
|
const LOGGER_CONFIG_KEY = `${STORAGE_PREFIX}_logger_config`;
|
|
const LOGGER_STORAGE_KEY = `${STORAGE_PREFIX}_logs`;
|
|
const LOGGER_EXPORT_PREFIX = STORAGE_PREFIX;
|
|
const WINDOW_LOGGER_KEY = `${toPascalCase(LOGGER_NAME)}Logger`;
|
|
export const LogLevel = {
|
|
DEBUG: 0,
|
|
INFO: 1,
|
|
WARN: 2,
|
|
ERROR: 3,
|
|
NONE: 4
|
|
};
|
|
const DEFAULT_CONFIG = {
|
|
globalLevel: LogLevel.INFO,
|
|
moduleSettings: {},
|
|
useColors: true,
|
|
saveToStorage: false,
|
|
maxStoredLogs: 1000,
|
|
timestampFormat: 'HH:mm:ss',
|
|
storageKey: LOGGER_STORAGE_KEY
|
|
};
|
|
const COLORS = {
|
|
[LogLevel.DEBUG]: '#9e9e9e',
|
|
[LogLevel.INFO]: '#2196f3',
|
|
[LogLevel.WARN]: '#ff9800',
|
|
[LogLevel.ERROR]: '#f44336',
|
|
};
|
|
const LEVEL_NAMES = {
|
|
[LogLevel.DEBUG]: 'DEBUG',
|
|
[LogLevel.INFO]: 'INFO',
|
|
[LogLevel.WARN]: 'WARN',
|
|
[LogLevel.ERROR]: 'ERROR',
|
|
};
|
|
class Logger {
|
|
constructor() {
|
|
this.config = { ...DEFAULT_CONFIG };
|
|
this.logs = [];
|
|
this.enabled = true;
|
|
this.loadConfig();
|
|
}
|
|
/**
|
|
* Configure the logger
|
|
* @param {Partial<LoggerConfig>} config - Configuration object
|
|
*/
|
|
configure(config) {
|
|
this.config = { ...this.config, ...config };
|
|
this.saveConfig();
|
|
return this;
|
|
}
|
|
/**
|
|
* Enable/disable logger globally
|
|
* @param {boolean} enabled - Whether the logger should be enabled
|
|
*/
|
|
setEnabled(enabled) {
|
|
this.enabled = enabled;
|
|
return this;
|
|
}
|
|
/**
|
|
* Set global logging level
|
|
* @param {LogLevels} level - Logging level
|
|
*/
|
|
setGlobalLevel(level) {
|
|
this.config.globalLevel = level;
|
|
this.saveConfig();
|
|
return this;
|
|
}
|
|
/**
|
|
* Set logging level for a specific module
|
|
* @param {string} module - Module name
|
|
* @param {LogLevels} level - Logging level
|
|
*/
|
|
setModuleLevel(module, level) {
|
|
this.config.moduleSettings[module] = level;
|
|
this.saveConfig();
|
|
return this;
|
|
}
|
|
/**
|
|
* Check if a given logging level is active for a module
|
|
* @param {string} module - Module name
|
|
* @param {LogLevels} level - Logging level to check
|
|
* @returns {boolean} - Whether the level is active
|
|
*/
|
|
isLevelEnabled(module, level) {
|
|
if (!this.enabled)
|
|
return false;
|
|
if (this.config.moduleSettings[module] !== undefined) {
|
|
return level >= this.config.moduleSettings[module];
|
|
}
|
|
return level >= this.config.globalLevel;
|
|
}
|
|
/**
|
|
* Format timestamp
|
|
* @returns {string} - Formatted timestamp
|
|
*/
|
|
formatTimestamp() {
|
|
const now = new Date();
|
|
const format = this.config.timestampFormat;
|
|
return format
|
|
.replace('HH', padStart(String(now.getHours()), 2, '0'))
|
|
.replace('mm', padStart(String(now.getMinutes()), 2, '0'))
|
|
.replace('ss', padStart(String(now.getSeconds()), 2, '0'))
|
|
.replace('SSS', padStart(String(now.getMilliseconds()), 3, '0'));
|
|
}
|
|
/**
|
|
* Save log
|
|
* @param {string} module - Module name
|
|
* @param {LogLevels} level - Logging level
|
|
* @param {any[]} args - Arguments to log
|
|
*/
|
|
log(module, level, ...args) {
|
|
if (!this.isLevelEnabled(module, level))
|
|
return;
|
|
const timestamp = this.formatTimestamp();
|
|
const levelName = LEVEL_NAMES[level];
|
|
const logData = {
|
|
timestamp,
|
|
module,
|
|
level,
|
|
levelName,
|
|
args,
|
|
time: new Date()
|
|
};
|
|
if (this.config.saveToStorage) {
|
|
this.logs.push(logData);
|
|
if (this.logs.length > this.config.maxStoredLogs) {
|
|
this.logs.shift();
|
|
}
|
|
this.saveLogs();
|
|
}
|
|
this.printToConsole(logData);
|
|
}
|
|
/**
|
|
* Display log to console
|
|
* @param {LogData} logData - Log data
|
|
*/
|
|
printToConsole(logData) {
|
|
const { timestamp, module, level, levelName, args } = logData;
|
|
const prefix = `[${timestamp}] [${module}] [${levelName}]`;
|
|
if (this.config.useColors && typeof console.log === 'function') {
|
|
const color = COLORS[level] || '#000000';
|
|
console.log(`%c${prefix}`, `color: ${color}; font-weight: bold;`, ...args);
|
|
return;
|
|
}
|
|
console.log(prefix, ...args);
|
|
}
|
|
/**
|
|
* Save logs to localStorage
|
|
*/
|
|
saveLogs() {
|
|
if (typeof localStorage !== 'undefined' && this.config.saveToStorage) {
|
|
try {
|
|
const simplifiedLogs = this.logs.map((log) => ({
|
|
t: log.timestamp,
|
|
m: log.module,
|
|
l: log.level,
|
|
a: log.args.map((arg) => {
|
|
if (typeof arg === 'object') {
|
|
try {
|
|
return JSON.stringify(arg);
|
|
}
|
|
catch (e) {
|
|
return String(arg);
|
|
}
|
|
}
|
|
return arg;
|
|
})
|
|
}));
|
|
localStorage.setItem(this.config.storageKey, JSON.stringify(simplifiedLogs));
|
|
}
|
|
catch (e) {
|
|
console.error('Failed to save logs to localStorage:', e);
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Load logs from localStorage
|
|
*/
|
|
loadLogs() {
|
|
if (typeof localStorage !== 'undefined' && this.config.saveToStorage) {
|
|
try {
|
|
const storedLogs = localStorage.getItem(this.config.storageKey);
|
|
if (storedLogs) {
|
|
this.logs = JSON.parse(storedLogs);
|
|
}
|
|
}
|
|
catch (e) {
|
|
console.error('Failed to load logs from localStorage:', e);
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Save configuration to localStorage
|
|
*/
|
|
saveConfig() {
|
|
if (typeof localStorage !== 'undefined') {
|
|
try {
|
|
localStorage.setItem(LOGGER_CONFIG_KEY, JSON.stringify(this.config));
|
|
}
|
|
catch (e) {
|
|
console.error('Failed to save logger config to localStorage:', e);
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Load configuration from localStorage
|
|
*/
|
|
loadConfig() {
|
|
if (typeof localStorage !== 'undefined') {
|
|
try {
|
|
const storedConfig = localStorage.getItem(LOGGER_CONFIG_KEY);
|
|
if (storedConfig) {
|
|
this.config = { ...this.config, ...JSON.parse(storedConfig) };
|
|
}
|
|
}
|
|
catch (e) {
|
|
console.error('Failed to load logger config from localStorage:', e);
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Clear all logs
|
|
*/
|
|
clearLogs() {
|
|
this.logs = [];
|
|
if (typeof localStorage !== 'undefined') {
|
|
localStorage.removeItem(this.config.storageKey);
|
|
}
|
|
return this;
|
|
}
|
|
/**
|
|
* Export logs to file
|
|
* @param {'json' | 'txt'} format - Export format
|
|
*/
|
|
exportLogs(format = 'json') {
|
|
if (this.logs.length === 0) {
|
|
console.warn('No logs to export');
|
|
return;
|
|
}
|
|
let content;
|
|
let mimeType;
|
|
let extension;
|
|
if (format === 'json') {
|
|
content = JSON.stringify(this.logs, null, 2);
|
|
mimeType = 'application/json';
|
|
extension = 'json';
|
|
}
|
|
else {
|
|
content = this.logs.map((log) => `[${log.timestamp}] [${log.module}] [${log.levelName}] ${log.args.join(' ')}`).join('\n');
|
|
mimeType = 'text/plain';
|
|
extension = 'txt';
|
|
}
|
|
const blob = new Blob([content], { type: mimeType });
|
|
const url = URL.createObjectURL(blob);
|
|
const a = document.createElement('a');
|
|
a.href = url;
|
|
a.download = `${LOGGER_EXPORT_PREFIX}_logs_${new Date().toISOString().replace(/[:.]/g, '-')}.${extension}`;
|
|
document.body.appendChild(a);
|
|
a.click();
|
|
document.body.removeChild(a);
|
|
URL.revokeObjectURL(url);
|
|
}
|
|
/**
|
|
* Log at DEBUG level
|
|
* @param {string} module - Module name
|
|
* @param {any[]} args - Arguments to log
|
|
*/
|
|
debug(module, ...args) {
|
|
this.log(module, LogLevel.DEBUG, ...args);
|
|
}
|
|
/**
|
|
* Log at INFO level
|
|
* @param {string} module - Module name
|
|
* @param {any[]} args - Arguments to log
|
|
*/
|
|
info(module, ...args) {
|
|
this.log(module, LogLevel.INFO, ...args);
|
|
}
|
|
/**
|
|
* Log at WARN level
|
|
* @param {string} module - Module name
|
|
* @param {any[]} args - Arguments to log
|
|
*/
|
|
warn(module, ...args) {
|
|
this.log(module, LogLevel.WARN, ...args);
|
|
}
|
|
/**
|
|
* Log at ERROR level
|
|
* @param {string} module - Module name
|
|
* @param {any[]} args - Arguments to log
|
|
*/
|
|
error(module, ...args) {
|
|
this.log(module, LogLevel.ERROR, ...args);
|
|
}
|
|
}
|
|
export const logger = new Logger();
|
|
export const debug = (module, ...args) => logger.debug(module, ...args);
|
|
export const info = (module, ...args) => logger.info(module, ...args);
|
|
export const warn = (module, ...args) => logger.warn(module, ...args);
|
|
export const error = (module, ...args) => logger.error(module, ...args);
|
|
if (typeof window !== 'undefined') {
|
|
window[WINDOW_LOGGER_KEY] = logger;
|
|
}
|
|
export default logger;
|