mirror of
https://github.com/godotengine/godot
synced 2024-09-05 14:30:30 +00:00
![Hugo Locurcio](/assets/img/avatar_default.png)
Text editors cannot display ANSI escape codes, so these should be stripped from log files to ensure readability. Since this uses a regex, this works both for `print_rich()` and manually inserted ANSI escape codes. Co-authored-by: bruvzg <7645683+bruvzg@users.noreply.github.com>
285 lines
8.7 KiB
C++
285 lines
8.7 KiB
C++
/**************************************************************************/
|
|
/* 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<DirAccess> da = DirAccess::open(base_path.get_base_dir());
|
|
if (da.is_null()) {
|
|
return;
|
|
}
|
|
|
|
da->list_dir_begin();
|
|
String f = da->get_next();
|
|
HashSet<String> 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<String>::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<DirAccess> da = DirAccess::open(base_path.get_base_dir());
|
|
if (da.is_valid()) {
|
|
da->copy(base_path, backup_name);
|
|
}
|
|
clear_old_backups();
|
|
}
|
|
} else {
|
|
Ref<DirAccess> 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<Logger *> &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]);
|
|
}
|
|
}
|