Translated using Weblate (Italian)
[oweals/minetest.git] / src / log.h
index 1d087429cd09f04ecaedfa33096a10ca6177a5fe..856d3479b94d44cfd8187591440ee859ca0b5520 100644 (file)
--- a/src/log.h
+++ b/src/log.h
 /*
-Minetest-c55
-Copyright (C) 2011 celeron55, Perttu Ahola <celeron55@gmail.com>
+Minetest
+Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
 
 This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation; either version 2.1 of the License, or
 (at your option) any later version.
 
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
+GNU Lesser General Public License for more details.
 
-You should have received a copy of the GNU General Public License along
+You should have received a copy of the GNU Lesser General Public License along
 with this program; if not, write to the Free Software Foundation, Inc.,
 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
-#ifndef LOG_HEADER
-#define LOG_HEADER
+#pragma once
 
+#include <map>
+#include <queue>
 #include <string>
+#include <fstream>
+#include <thread>
+#include <mutex>
+#if !defined(_WIN32)  // POSIX
+       #include <unistd.h>
+#endif
+#include "irrlichttypes.h"
 
-/*
-       Use this for logging everything.
-       
-       If you need to explicitly print something, use dstream or cout or cerr.
-*/
+class ILogOutput;
 
-enum LogMessageLevel {
-       LMT_ERROR, /* Something failed ("invalid map data on disk, block (2,2,1)") */
-       LMT_ACTION, /* In-game actions ("celeron55 placed block at (12,4,-5)") */
-       LMT_INFO, /* More deep info ("saving map on disk (only_modified=true)") */
-       LMT_VERBOSE, /* Flood-style ("loaded block (2,2,2) from disk") */
-       LMT_NUM_VALUES,
+enum LogLevel {
+       LL_NONE, // Special level that is always printed
+       LL_ERROR,
+       LL_WARNING,
+       LL_ACTION,  // In-game actions
+       LL_INFO,
+       LL_VERBOSE,
+       LL_MAX,
 };
 
-class ILogOutput
-{
+enum LogColor {
+       LOG_COLOR_NEVER,
+       LOG_COLOR_ALWAYS,
+       LOG_COLOR_AUTO,
+};
+
+typedef u8 LogLevelMask;
+#define LOGLEVEL_TO_MASKLEVEL(x) (1 << x)
+
+class Logger {
 public:
-       /* line: Full line with timestamp, level and thread */
-       virtual void printLog(const std::string &line){};
-       /* line: Only actual printed text */
-       virtual void printLog(enum LogMessageLevel lev, const std::string &line){};
+       void addOutput(ILogOutput *out);
+       void addOutput(ILogOutput *out, LogLevel lev);
+       void addOutputMasked(ILogOutput *out, LogLevelMask mask);
+       void addOutputMaxLevel(ILogOutput *out, LogLevel lev);
+       LogLevelMask removeOutput(ILogOutput *out);
+       void setLevelSilenced(LogLevel lev, bool silenced);
+
+       void registerThread(const std::string &name);
+       void deregisterThread();
+
+       void log(LogLevel lev, const std::string &text);
+       // Logs without a prefix
+       void logRaw(LogLevel lev, const std::string &text);
+
+       void setTraceEnabled(bool enable) { m_trace_enabled = enable; }
+       bool getTraceEnabled() { return m_trace_enabled; }
+
+       static LogLevel stringToLevel(const std::string &name);
+       static const std::string getLevelLabel(LogLevel lev);
+
+       static LogColor color_mode;
+
+private:
+       void logToOutputsRaw(LogLevel, const std::string &line);
+       void logToOutputs(LogLevel, const std::string &combined,
+               const std::string &time, const std::string &thread_name,
+               const std::string &payload_text);
+
+       const std::string getThreadName();
+
+       std::vector<ILogOutput *> m_outputs[LL_MAX];
+
+       // Should implement atomic loads and stores (even though it's only
+       // written to when one thread has access currently).
+       // Works on all known architectures (x86, ARM, MIPS).
+       volatile bool m_silenced_levels[LL_MAX];
+       std::map<std::thread::id, std::string> m_thread_names;
+       mutable std::mutex m_mutex;
+       bool m_trace_enabled;
+};
+
+class ILogOutput {
+public:
+       virtual void logRaw(LogLevel, const std::string &line) = 0;
+       virtual void log(LogLevel, const std::string &combined,
+               const std::string &time, const std::string &thread_name,
+               const std::string &payload_text) = 0;
+};
+
+class ICombinedLogOutput : public ILogOutput {
+public:
+       void log(LogLevel lev, const std::string &combined,
+               const std::string &time, const std::string &thread_name,
+               const std::string &payload_text)
+       {
+               logRaw(lev, combined);
+       }
 };
 
-void log_add_output(ILogOutput *out, enum LogMessageLevel lev);
-void log_add_output_maxlev(ILogOutput *out, enum LogMessageLevel lev);
-void log_add_output_all_levs(ILogOutput *out);
-void log_remove_output(ILogOutput *out);
+class StreamLogOutput : public ICombinedLogOutput {
+public:
+       StreamLogOutput(std::ostream &stream) :
+               m_stream(stream)
+       {
+#if !defined(_WIN32)
+               is_tty = isatty(fileno(stdout));
+#else
+               is_tty = false;
+#endif
+       }
 
-void log_register_thread(const std::string &name);
-void log_deregister_thread();
+       void logRaw(LogLevel lev, const std::string &line);
 
-void log_printline(enum LogMessageLevel lev, const std::string &text);
+private:
+       std::ostream &m_stream;
+       bool is_tty;
+};
 
-#define LOGLINEF(lev, ...)\
-{\
-       char buf[10000];\
-       snprintf(buf, 10000, __VA_ARGS__);\
-       log_printline(lev, buf);\
-}
+class FileLogOutput : public ICombinedLogOutput {
+public:
+       void setFile(const std::string &filename, s64 file_size_max);
+
+       void logRaw(LogLevel lev, const std::string &line)
+       {
+               m_stream << line << std::endl;
+       }
+
+private:
+       std::ofstream m_stream;
+};
+
+class LogOutputBuffer : public ICombinedLogOutput {
+public:
+       LogOutputBuffer(Logger &logger) :
+               m_logger(logger)
+       {
+               updateLogLevel();
+       };
+
+       virtual ~LogOutputBuffer()
+       {
+               m_logger.removeOutput(this);
+       }
+
+       void updateLogLevel();
+
+       void logRaw(LogLevel lev, const std::string &line);
+
+       void clear()
+       {
+               m_buffer = std::queue<std::string>();
+       }
+
+       bool empty() const
+       {
+               return m_buffer.empty();
+       }
+
+       std::string get()
+       {
+               if (empty())
+                       return "";
+               std::string s = m_buffer.front();
+               m_buffer.pop();
+               return s;
+       }
+
+private:
+       std::queue<std::string> m_buffer;
+       Logger &m_logger;
+};
+
+
+extern StreamLogOutput stdout_output;
+extern StreamLogOutput stderr_output;
+extern std::ostream null_stream;
+
+extern std::ostream *dout_con_ptr;
+extern std::ostream *derr_con_ptr;
+extern std::ostream *dout_server_ptr;
+extern std::ostream *derr_server_ptr;
+
+#ifndef SERVER
+extern std::ostream *dout_client_ptr;
+extern std::ostream *derr_client_ptr;
+#endif
+
+extern Logger g_logger;
+
+// Writes directly to all LL_NONE log outputs for g_logger with no prefix.
+extern std::ostream rawstream;
 
 extern std::ostream errorstream;
+extern std::ostream warningstream;
 extern std::ostream actionstream;
 extern std::ostream infostream;
 extern std::ostream verbosestream;
+extern std::ostream dstream;
 
-#endif
+#define TRACEDO(x) do {               \
+       if (g_logger.getTraceEnabled()) { \
+               x;                            \
+       }                                 \
+} while (0)
 
+#define TRACESTREAM(x) TRACEDO(verbosestream x)
+
+#define dout_con (*dout_con_ptr)
+#define derr_con (*derr_con_ptr)
+#define dout_server (*dout_server_ptr)
+
+#ifndef SERVER
+       #define dout_client (*dout_client_ptr)
+#endif