/**************************************************************************/ /* logger.cpp */ /**************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /**************************************************************************/ /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */ /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /**************************************************************************/ #include "logger.h" #include "core/config/project_settings.h" #include "core/core_globals.h" #include "core/io/dir_access.h" #include "core/os/os.h" #include "core/os/time.h" #include "core/string/print_string.h" #include "modules/modules_enabled.gen.h" // For regex. #if defined(MINGW_ENABLED) || defined(_MSC_VER) #define sprintf sprintf_s #endif bool Logger::should_log(bool p_err) { return (!p_err || CoreGlobals::print_error_enabled) && (p_err || CoreGlobals::print_line_enabled); } bool Logger::_flush_stdout_on_print = true; void Logger::set_flush_stdout_on_print(bool value) { _flush_stdout_on_print = value; } void Logger::log_error(const char *p_function, const char *p_file, int p_line, const char *p_code, const char *p_rationale, bool p_editor_notify, ErrorType p_type) { if (!should_log(true)) { return; } const char *err_type = "ERROR"; switch (p_type) { case ERR_ERROR: err_type = "ERROR"; break; case ERR_WARNING: err_type = "WARNING"; break; case ERR_SCRIPT: err_type = "SCRIPT ERROR"; break; case ERR_SHADER: err_type = "SHADER ERROR"; break; default: ERR_PRINT("Unknown error type"); break; } const char *err_details; if (p_rationale && *p_rationale) { err_details = p_rationale; } else { err_details = p_code; } if (p_editor_notify) { logf_error("%s: %s\n", err_type, err_details); } else { logf_error("USER %s: %s\n", err_type, err_details); } logf_error(" at: %s (%s:%i)\n", p_function, p_file, p_line); } void Logger::logf(const char *p_format, ...) { if (!should_log(false)) { return; } va_list argp; va_start(argp, p_format); logv(p_format, argp, false); va_end(argp); } void Logger::logf_error(const char *p_format, ...) { if (!should_log(true)) { return; } va_list argp; va_start(argp, p_format); logv(p_format, argp, true); va_end(argp); } void RotatedFileLogger::clear_old_backups() { int max_backups = max_files - 1; // -1 for the current file String basename = base_path.get_file().get_basename(); String extension = base_path.get_extension(); Ref da = DirAccess::open(base_path.get_base_dir()); if (da.is_null()) { return; } da->list_dir_begin(); String f = da->get_next(); HashSet backups; while (!f.is_empty()) { if (!da->current_is_dir() && f.begins_with(basename) && f.get_extension() == extension && f != base_path.get_file()) { backups.insert(f); } f = da->get_next(); } da->list_dir_end(); if (backups.size() > (uint32_t)max_backups) { // since backups are appended with timestamp and Set iterates them in sorted order, // first backups are the oldest int to_delete = backups.size() - max_backups; for (HashSet::Iterator E = backups.begin(); E && to_delete > 0; ++E, --to_delete) { da->remove(*E); } } } void RotatedFileLogger::rotate_file() { file.unref(); if (FileAccess::exists(base_path)) { if (max_files > 1) { String timestamp = Time::get_singleton()->get_datetime_string_from_system().replace(":", "."); String backup_name = base_path.get_basename() + timestamp; if (!base_path.get_extension().is_empty()) { backup_name += "." + base_path.get_extension(); } Ref da = DirAccess::open(base_path.get_base_dir()); if (da.is_valid()) { da->copy(base_path, backup_name); } clear_old_backups(); } } else { Ref da = DirAccess::create(DirAccess::ACCESS_USERDATA); if (da.is_valid()) { da->make_dir_recursive(base_path.get_base_dir()); } } file = FileAccess::open(base_path, FileAccess::WRITE); file->detach_from_objectdb(); // Note: This FileAccess instance will exist longer than ObjectDB, therefore can't be registered in ObjectDB. } RotatedFileLogger::RotatedFileLogger(const String &p_base_path, int p_max_files) : base_path(p_base_path.simplify_path()), max_files(p_max_files > 0 ? p_max_files : 1) { rotate_file(); #ifdef MODULE_REGEX_ENABLED strip_ansi_regex.instantiate(); strip_ansi_regex->detach_from_objectdb(); // Note: This RegEx instance will exist longer than ObjectDB, therefore can't be registered in ObjectDB. strip_ansi_regex->compile("\u001b\\[((?:\\d|;)*)([a-zA-Z])"); #endif // MODULE_REGEX_ENABLED } void RotatedFileLogger::logv(const char *p_format, va_list p_list, bool p_err) { if (!should_log(p_err)) { return; } if (file.is_valid()) { const int static_buf_size = 512; char static_buf[static_buf_size]; char *buf = static_buf; va_list list_copy; va_copy(list_copy, p_list); int len = vsnprintf(buf, static_buf_size, p_format, p_list); if (len >= static_buf_size) { buf = (char *)Memory::alloc_static(len + 1); vsnprintf(buf, len + 1, p_format, list_copy); } va_end(list_copy); #ifdef MODULE_REGEX_ENABLED // Strip ANSI escape codes (such as those inserted by `print_rich()`) // before writing to file, as text editors cannot display those // correctly. file->store_string(strip_ansi_regex->sub(String(buf), "", true)); #else file->store_buffer((uint8_t *)buf, len); #endif // MODULE_REGEX_ENABLED if (len >= static_buf_size) { Memory::free_static(buf); } if (p_err || _flush_stdout_on_print) { // Don't always flush when printing stdout to avoid performance // issues when `print()` is spammed in release builds. file->flush(); } } } void StdLogger::logv(const char *p_format, va_list p_list, bool p_err) { if (!should_log(p_err)) { return; } if (p_err) { vfprintf(stderr, p_format, p_list); } else { vprintf(p_format, p_list); if (_flush_stdout_on_print) { // Don't always flush when printing stdout to avoid performance // issues when `print()` is spammed in release builds. fflush(stdout); } } } CompositeLogger::CompositeLogger(const Vector &p_loggers) : loggers(p_loggers) { } void CompositeLogger::logv(const char *p_format, va_list p_list, bool p_err) { if (!should_log(p_err)) { return; } for (int i = 0; i < loggers.size(); ++i) { va_list list_copy; va_copy(list_copy, p_list); loggers[i]->logv(p_format, list_copy, p_err); va_end(list_copy); } } void CompositeLogger::log_error(const char *p_function, const char *p_file, int p_line, const char *p_code, const char *p_rationale, bool p_editor_notify, ErrorType p_type) { if (!should_log(true)) { return; } for (int i = 0; i < loggers.size(); ++i) { loggers[i]->log_error(p_function, p_file, p_line, p_code, p_rationale, p_editor_notify, p_type); } } void CompositeLogger::add_logger(Logger *p_logger) { loggers.push_back(p_logger); } CompositeLogger::~CompositeLogger() { for (int i = 0; i < loggers.size(); ++i) { memdelete(loggers[i]); } }