File: CBasicLogConfigurator.h

package info (click to toggle)
vcmi 1.6.5%2Bdfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: forky, sid, trixie
  • size: 32,060 kB
  • sloc: cpp: 238,971; python: 265; sh: 224; xml: 157; ansic: 78; objc: 61; makefile: 49
file content (52 lines) | stat: -rw-r--r-- 1,719 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
/*
 * CBasicLogConfigurator.h, part of VCMI engine
 *
 * Authors: listed in file AUTHORS in main folder
 *
 * License: GNU General Public License v2.0 or later
 * Full text of license available in license.txt file, in main folder
 *
 */

#pragma once

#include "../CConsoleHandler.h"

VCMI_LIB_NAMESPACE_BEGIN

class CConsoleHandler;
class JsonNode;

/// The class CBasicLogConfigurator reads log properties from settings.json and
/// sets up the logging system. Make sure that you use the same configurator object to
/// initialize the whole logging system. If you don't do so, the log file will be overwritten/truncated.
class DLL_LINKAGE CBasicLogConfigurator
{
public:
	CBasicLogConfigurator(boost::filesystem::path filePath, CConsoleHandler * const console);

	/// Configures the logging system by parsing the logging settings. It adds the console target and the file target to the global logger.
	/// Doesn't throw, but logs on success or fault.
	void configure();

	/// Configures a default logging system by adding the console target and the file target to the global logger.
	void configureDefault();

	/// Removes all targets from the global logger.
	void deconfigure();


private:
	// Gets ELogLevel enum from string. (Should be moved to CLogger as a separate function?)
	// Throws: std::runtime_error
	static ELogLevel::ELogLevel getLogLevel(const std::string & level);
	// Gets EConsoleTextColor enum from strings. (Should be moved to CLogger as a separate function?)
	// Throws: std::runtime_error
	static EConsoleTextColor::EConsoleTextColor getConsoleColor(const std::string & colorName);

	boost::filesystem::path filePath;
	CConsoleHandler * console;
	bool appendToLogFile;
};

VCMI_LIB_NAMESPACE_END