c4ed791164
Migrates a remaining common file over to the Common namespace, making it consistent with the rest of common files. This also allows for high-traffic FS related code to alias the filesystem function namespace as namespace FS = Common::FS; for more concise typing.
138 lines
No EOL
3.2 KiB
C++
138 lines
No EOL
3.2 KiB
C++
// Copyright 2014 Citra Emulator Project
|
|
// Licensed under GPLv2 or any later version
|
|
// Refer to the license.txt file included.
|
|
#pragma once
|
|
|
|
#include <chrono>
|
|
#include <memory>
|
|
#include <string>
|
|
#include <string_view>
|
|
#include "common/file_util.h"
|
|
#include "common/logging/filter.h"
|
|
#include "common/logging/log.h"
|
|
|
|
namespace Log {
|
|
|
|
class Filter;
|
|
|
|
/**
|
|
* A log entry. Log entries are store in a structured format to permit more varied output
|
|
* formatting on different frontends, as well as facilitating filtering and aggregation.
|
|
*/
|
|
struct Entry {
|
|
std::chrono::microseconds timestamp;
|
|
Class log_class{};
|
|
Level log_level{};
|
|
const char* filename = nullptr;
|
|
unsigned int line_num = 0;
|
|
std::string function;
|
|
std::string message;
|
|
bool final_entry = false;
|
|
};
|
|
|
|
/**
|
|
* Interface for logging backends. As loggers can be created and removed at runtime, this can be
|
|
* used by a frontend for adding a custom logging backend as needed
|
|
*/
|
|
class Backend {
|
|
public:
|
|
virtual ~Backend() = default;
|
|
virtual void SetFilter(const Filter& new_filter) {
|
|
filter = new_filter;
|
|
}
|
|
virtual const char* GetName() const = 0;
|
|
virtual void Write(const Entry& entry) = 0;
|
|
|
|
private:
|
|
Filter filter;
|
|
};
|
|
|
|
/**
|
|
* Backend that writes to stderr without any color commands
|
|
*/
|
|
class ConsoleBackend : public Backend {
|
|
public:
|
|
static const char* Name() {
|
|
return "console";
|
|
}
|
|
const char* GetName() const override {
|
|
return Name();
|
|
}
|
|
void Write(const Entry& entry) override;
|
|
};
|
|
|
|
/**
|
|
* Backend that writes to stderr and with color
|
|
*/
|
|
class ColorConsoleBackend : public Backend {
|
|
public:
|
|
static const char* Name() {
|
|
return "color_console";
|
|
}
|
|
|
|
const char* GetName() const override {
|
|
return Name();
|
|
}
|
|
void Write(const Entry& entry) override;
|
|
};
|
|
|
|
/**
|
|
* Backend that writes to a file passed into the constructor
|
|
*/
|
|
class FileBackend : public Backend {
|
|
public:
|
|
explicit FileBackend(const std::string& filename);
|
|
|
|
static const char* Name() {
|
|
return "file";
|
|
}
|
|
|
|
const char* GetName() const override {
|
|
return Name();
|
|
}
|
|
|
|
void Write(const Entry& entry) override;
|
|
|
|
private:
|
|
Common::FS::IOFile file;
|
|
std::size_t bytes_written;
|
|
};
|
|
|
|
/**
|
|
* Backend that writes to Visual Studio's output window
|
|
*/
|
|
class DebuggerBackend : public Backend {
|
|
public:
|
|
static const char* Name() {
|
|
return "debugger";
|
|
}
|
|
const char* GetName() const override {
|
|
return Name();
|
|
}
|
|
void Write(const Entry& entry) override;
|
|
};
|
|
|
|
void AddBackend(std::unique_ptr<Backend> backend);
|
|
|
|
void RemoveBackend(std::string_view backend_name);
|
|
|
|
Backend* GetBackend(std::string_view backend_name);
|
|
|
|
/**
|
|
* Returns the name of the passed log class as a C-string. Subclasses are separated by periods
|
|
* instead of underscores as in the enumeration.
|
|
*/
|
|
const char* GetLogClassName(Class log_class);
|
|
|
|
/**
|
|
* Returns the name of the passed log level as a C-string.
|
|
*/
|
|
const char* GetLevelName(Level log_level);
|
|
|
|
/**
|
|
* The global filter will prevent any messages from even being processed if they are filtered. Each
|
|
* backend can have a filter, but if the level is lower than the global filter, the backend will
|
|
* never get the message
|
|
*/
|
|
void SetGlobalFilter(const Filter& filter);
|
|
} // namespace Log
|