Commit fe467aa587c648b6018532b7b7bbb2ed1feed656
0 parents
Initial commit MIT-licenced logutils to open_source
Showing
11 changed files
with
740 additions
and
0 deletions
.gitignore
0 → 100644
CMakeLists.txt
0 → 100644
1 | +++ a/CMakeLists.txt | ||
1 | +cmake_minimum_required(VERSION 3.0) | ||
2 | +LIST(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake) | ||
3 | + | ||
4 | +# Check to see if there is versioning information available | ||
5 | +if(IS_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/osdev_versioning/cmake) | ||
6 | + LIST(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/osdev_versioning/cmake) | ||
7 | + include(osdevversion) | ||
8 | +endif() | ||
9 | + | ||
10 | +include(projectheader) | ||
11 | +project_header(osdev_logutils) | ||
12 | + | ||
13 | +add_subdirectory(src) | ||
14 | +add_subdirectory(tests) | ||
15 | + | ||
16 | +# include(packaging) | ||
17 | +# package_component() |
README.md
0 → 100644
1 | +++ a/README.md |
cmake
0 → 120000
src/CMakeLists.txt
0 → 100644
1 | +++ a/src/CMakeLists.txt | ||
1 | +cmake_minimum_required(VERSION 3.0) | ||
2 | +LIST(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../cmake) | ||
3 | +include(projectheader) | ||
4 | +project_header(logutils) | ||
5 | + | ||
6 | +# find_library( log4cplus REQUIRED ) | ||
7 | +find_package( Qt5Core REQUIRED ) | ||
8 | +find_package( Qt5Sql REQUIRED ) | ||
9 | + | ||
10 | +include_directories( SYSTEM | ||
11 | + ${Qt5Core_INCLUDE_DIRS} | ||
12 | + ${CMAKE_CURRENT_SOURCE_DIR}/../global | ||
13 | +) | ||
14 | + | ||
15 | +include(compiler) | ||
16 | + | ||
17 | +set(SRC_LIST | ||
18 | + ${CMAKE_CURRENT_SOURCE_DIR}/log.cpp | ||
19 | + ${CMAKE_CURRENT_SOURCE_DIR}/threadcontext.cpp | ||
20 | +) | ||
21 | + | ||
22 | +include(library) | ||
23 | +add_libraries( | ||
24 | + ${Qt5Core_LIBRARIES} | ||
25 | + # ${log4cplus_LIBRARIES} | ||
26 | +) | ||
27 | + | ||
28 | +include(installation) | ||
29 | +install_component() |
src/log.cpp
0 → 100644
1 | +++ a/src/log.cpp | ||
1 | +/* ************************************************************************************************************************************************************************** | ||
2 | + * Copyright 2019 Open Systems Development BV * | ||
3 | + * * | ||
4 | + * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), * | ||
5 | + * to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, * | ||
6 | + * 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: * | ||
7 | + * * | ||
8 | + * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. * | ||
9 | + * * | ||
10 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * | ||
11 | + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * | ||
12 | + * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * | ||
13 | + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * | ||
14 | + * **************************************************************************************************************************************************************************/ | ||
15 | + | ||
16 | +// std | ||
17 | +#include <ios> | ||
18 | +#include <iomanip> | ||
19 | +#include <sstream> | ||
20 | +#include <thread> | ||
21 | + | ||
22 | +//#include "timeutils.h" | ||
23 | +#include "log.h" | ||
24 | +#include "threadcontext.h" | ||
25 | + | ||
26 | +#include <QBuffer> | ||
27 | +#include <QByteArray> | ||
28 | +#include <QDataStream> | ||
29 | +#include <QDateTime> | ||
30 | +#include <QDebug> | ||
31 | +#include <QFile> | ||
32 | +#include <QFileInfo> | ||
33 | +#include <QIODevice> | ||
34 | +#include <QObject> | ||
35 | +#include <QMutexLocker> | ||
36 | + | ||
37 | +namespace osdev { | ||
38 | +namespace components { | ||
39 | + | ||
40 | +namespace { | ||
41 | + | ||
42 | +QString toString(LogLevel level) | ||
43 | +{ | ||
44 | + switch(level) | ||
45 | + { | ||
46 | + case LogLevel::Trace: | ||
47 | + return "T"; | ||
48 | + case LogLevel::Debug: | ||
49 | + return "D"; | ||
50 | + case LogLevel::Info: | ||
51 | + return "I"; | ||
52 | + case LogLevel::Warning: | ||
53 | + return "W"; | ||
54 | + case LogLevel::Error: | ||
55 | + return "E"; | ||
56 | + } | ||
57 | + return "U"; | ||
58 | +} | ||
59 | + | ||
60 | +} // anonymous | ||
61 | + | ||
62 | +QString Log::s_context = QString(); | ||
63 | +QString Log::s_fileName = QString(); | ||
64 | +LogLevel Log::s_logLevel = LogLevel::Debug; | ||
65 | +QMutex Log::m_mutex; | ||
66 | + | ||
67 | +void Log::init(const QString& context, const QString& logFile, LogLevel logDepth) | ||
68 | +{ | ||
69 | + s_logLevel = logDepth; | ||
70 | + s_context = context; | ||
71 | + | ||
72 | + if ( !logFile.isEmpty() ) | ||
73 | + { | ||
74 | + s_fileName = logFile; | ||
75 | + } | ||
76 | +} | ||
77 | + | ||
78 | +void Log::terminate() | ||
79 | +{ | ||
80 | + s_context.clear(); | ||
81 | + s_fileName.clear(); | ||
82 | + s_logLevel = LogLevel::Info; | ||
83 | +} | ||
84 | + | ||
85 | +void Log::log(const QString& category, const QString& message, LogLevel level) | ||
86 | +{ | ||
87 | + QMutexLocker lock( &m_mutex ); | ||
88 | + | ||
89 | + QString logCategory = s_context + '|' + toString(level) + '|' + ThreadContext::instance().context() + '|' + category; | ||
90 | + QString logMessage = message; | ||
91 | + if(logMessage.isEmpty()) | ||
92 | + { | ||
93 | + static const QString emptyMessage("--"); | ||
94 | + logMessage = emptyMessage; | ||
95 | + } | ||
96 | + else | ||
97 | + { | ||
98 | + // Replace % signs. | ||
99 | + logMessage.replace('%', "%%"); | ||
100 | + } | ||
101 | + | ||
102 | + writeLog( logCategory, logMessage, level ); | ||
103 | +} | ||
104 | + | ||
105 | +QString Log::fileinfoMessage(const char* file, int line, const QString& message) | ||
106 | +{ | ||
107 | + static const QString templ("%1:%2| %3"); | ||
108 | + QFileInfo fi(file); | ||
109 | + return templ.arg( fi.fileName() ).arg(line).arg(message); | ||
110 | +} | ||
111 | + | ||
112 | +void Log::trace(const QString &category, const QString &message) | ||
113 | +{ | ||
114 | + log(category, message, LogLevel::Trace); | ||
115 | +} | ||
116 | + | ||
117 | +void Log::debug(const QString& category, const QString& message) | ||
118 | +{ | ||
119 | + log( category, message, LogLevel::Debug ); | ||
120 | +} | ||
121 | + | ||
122 | +void Log::info(const QString& category, const QString& message) | ||
123 | +{ | ||
124 | + log( category, message, LogLevel::Info ); | ||
125 | +} | ||
126 | + | ||
127 | +void Log::warning(const QString& category, const QString& message) | ||
128 | +{ | ||
129 | + log(category, message, LogLevel::Warning ); | ||
130 | +} | ||
131 | + | ||
132 | +void Log::error(const QString& category, const QString& message) | ||
133 | +{ | ||
134 | + log(category, message, LogLevel::Error ); | ||
135 | +} | ||
136 | + | ||
137 | +void Log::logObject(const QString& category, QObject* object) | ||
138 | +{ | ||
139 | + QBuffer buffer; | ||
140 | + buffer.open(QIODevice::ReadWrite); | ||
141 | + | ||
142 | + QDataStream datastream(&buffer); | ||
143 | + QString data; | ||
144 | + | ||
145 | + datastream << object; | ||
146 | + datastream >> data; | ||
147 | + | ||
148 | + log( category, data, LogLevel::Debug ); | ||
149 | +} | ||
150 | + | ||
151 | +void Log::trace(const char *file, int line, const QString &category, const QString &message) | ||
152 | +{ | ||
153 | + log(category, fileinfoMessage(file, line, message), LogLevel::Trace ); | ||
154 | +} | ||
155 | + | ||
156 | +void Log::debug(const char* file, int line, const QString& category, const QString& message) | ||
157 | +{ | ||
158 | + log( category, fileinfoMessage(file, line, message), LogLevel::Debug ); | ||
159 | +} | ||
160 | + | ||
161 | +void Log::info(const char* file, int line, const QString& category, const QString& message) | ||
162 | +{ | ||
163 | + log( category, fileinfoMessage(file, line, message), LogLevel::Info ); | ||
164 | +} | ||
165 | + | ||
166 | +void Log::warning(const char* file, int line, const QString& category, const QString& message) | ||
167 | +{ | ||
168 | + log( category, fileinfoMessage(file, line, message), LogLevel::Warning); | ||
169 | +} | ||
170 | + | ||
171 | +void Log::error(const char* file, int line, const QString& category, const QString& message) | ||
172 | +{ | ||
173 | + log( category, fileinfoMessage(file, line, message), LogLevel::Error ); | ||
174 | +} | ||
175 | + | ||
176 | +void Log::logObject(const char* file, int line, const QString& category, QObject* object) | ||
177 | +{ | ||
178 | + QBuffer buffer; | ||
179 | + buffer.open(QIODevice::ReadWrite); | ||
180 | + | ||
181 | + QDataStream datastream(&buffer); | ||
182 | + QString data; | ||
183 | + | ||
184 | + datastream << object; | ||
185 | + datastream >> data; | ||
186 | + | ||
187 | + log( " [LOGOBJECT] " + category, fileinfoMessage(file, line, data), LogLevel::Debug ); | ||
188 | +} | ||
189 | + | ||
190 | +QString Log::getDateTime() | ||
191 | +{ | ||
192 | + return QDateTime::currentDateTime().toString( "dd-MM-yyyy HH:mm:ss.zzz" ); | ||
193 | +} | ||
194 | + | ||
195 | +void Log::writeLog(const QString& category, const QString& message, LogLevel level) | ||
196 | +{ | ||
197 | + | ||
198 | + if ( level >= s_logLevel ) | ||
199 | + { | ||
200 | + std::ostringstream threadIdStr; | ||
201 | + threadIdStr << std::right << std::setfill('0') << std::setw(12) << std::hex << std::this_thread::get_id(); | ||
202 | + | ||
203 | + QString logLine; | ||
204 | + QTextStream(&logLine) << getDateTime() << '|' << threadIdStr.str().c_str() << '|' << category << '|' << message; | ||
205 | + if ( !s_fileName.isEmpty() ) | ||
206 | + { | ||
207 | + QFile mFile( s_fileName ); | ||
208 | + if ( !mFile.open( QIODevice::WriteOnly | QIODevice::Append | QIODevice::Text ) ) | ||
209 | + { | ||
210 | + qWarning() << "Error opening the logfile : " << s_fileName << " for writing."; | ||
211 | + qWarning() << logLine; | ||
212 | + } | ||
213 | + else | ||
214 | + { | ||
215 | + QTextStream out( &mFile ); | ||
216 | + out << logLine << '\n'; | ||
217 | + mFile.close(); | ||
218 | + } | ||
219 | + } | ||
220 | + else | ||
221 | + { | ||
222 | + qDebug() << logLine; | ||
223 | + } | ||
224 | + } | ||
225 | +} | ||
226 | + | ||
227 | +} /* End namespace components */ | ||
228 | +} /* End namespace osdev */ |
src/log.h
0 → 100644
1 | +++ a/src/log.h | ||
1 | +/* ************************************************************************************************************************************************************************** | ||
2 | + * Copyright 2019 Open Systems Development BV * | ||
3 | + * * | ||
4 | + * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), * | ||
5 | + * to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, * | ||
6 | + * 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: * | ||
7 | + * * | ||
8 | + * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. * | ||
9 | + * * | ||
10 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * | ||
11 | + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * | ||
12 | + * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * | ||
13 | + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * | ||
14 | + * **************************************************************************************************************************************************************************/ | ||
15 | + | ||
16 | +#ifndef OSDEV_COMPONENTS_LOG_H | ||
17 | +#define OSDEV_COMPONENTS_LOG_H | ||
18 | + | ||
19 | +// local | ||
20 | +#include "logutilslibexport.h" | ||
21 | + | ||
22 | +// qt | ||
23 | +#include <QString> | ||
24 | +#include <QMutex> | ||
25 | + | ||
26 | +class QObject; | ||
27 | + | ||
28 | +namespace osdev { | ||
29 | +namespace components { | ||
30 | + | ||
31 | +#define LogDebug(context, text) \ | ||
32 | + if (osdev::components::Log::level() <= osdev::components::LogLevel::Debug) \ | ||
33 | + { \ | ||
34 | + osdev::components::Log::debug(__FILE__, __LINE__, context, text); \ | ||
35 | + } | ||
36 | + | ||
37 | +#define LogObject(context, object) \ | ||
38 | + if (osdev::components::Log::level() <= osdev::components::LogLevel::Debug) \ | ||
39 | + { \ | ||
40 | + osdev::components::Log::logObject(__FILE__, __LINE__, context, object); \ | ||
41 | + } | ||
42 | + | ||
43 | +#define LogInfo(context, text) \ | ||
44 | + if (osdev::components::Log::level() <= osdev::components::LogLevel::Info) \ | ||
45 | + { \ | ||
46 | + osdev::components::Log::info(__FILE__, __LINE__, context,text); \ | ||
47 | + } | ||
48 | + | ||
49 | +#define LogWarning(context, text) \ | ||
50 | + if (osdev::components::Log::level() <= osdev::components::LogLevel::Warning) \ | ||
51 | + { \ | ||
52 | + osdev::components::Log::warning(__FILE__, __LINE__, context, text); \ | ||
53 | + } | ||
54 | + | ||
55 | +#define LogError(context, text) \ | ||
56 | + if (osdev::components::Log::level() <= osdev::components::LogLevel::Error) \ | ||
57 | + { \ | ||
58 | + osdev::components::Log::error(__FILE__, __LINE__, context, text); \ | ||
59 | + } | ||
60 | + | ||
61 | +#define LogTrace(context, text) \ | ||
62 | + if (osdev::components::Log::level() <= osdev::components::LogLevel::Trace) \ | ||
63 | + { \ | ||
64 | + osdev::components::Log::trace(__FILE__, __LINE__, context, text); \ | ||
65 | + } | ||
66 | + | ||
67 | + | ||
68 | +enum class LogLevel | ||
69 | +{ | ||
70 | + Trace, | ||
71 | + Debug, | ||
72 | + Info, | ||
73 | + Warning, | ||
74 | + Error | ||
75 | +}; | ||
76 | + | ||
77 | +/*! \class Log | ||
78 | + \brief Basic logging mechanism. | ||
79 | +*/ | ||
80 | +class LOGUTILSLIBINTERFACE Log | ||
81 | +{ | ||
82 | +public: | ||
83 | + /** | ||
84 | + * @brief Initialise the logging mechanism | ||
85 | + * @param context The main context | ||
86 | + * @param logFile Logfile if available | ||
87 | + * @param logDepth Initial log-depth | ||
88 | + */ | ||
89 | + static void init( const QString& context, | ||
90 | + const QString& logFile = QString(), | ||
91 | + LogLevel logDepth = LogLevel::Info ); | ||
92 | + | ||
93 | + //! Shutdown the logging mechanism. | ||
94 | + static void terminate(); | ||
95 | + | ||
96 | + /** | ||
97 | + * @brief Log a trace message in a category. | ||
98 | + * @param file Name of the source-file | ||
99 | + * @param line The line number in the source-file | ||
100 | + * @param category The category of the message. | ||
101 | + * @param message The string to print. | ||
102 | + */ | ||
103 | + static void trace( const char* file, int line, | ||
104 | + const QString& category, const QString& message ); | ||
105 | + | ||
106 | + /** | ||
107 | + * @brief Log a debug message in a category. | ||
108 | + * @param file Name of the source-file | ||
109 | + * @param line The line number in the source-file | ||
110 | + * @param category The category of the message. | ||
111 | + * @param message The string to print. | ||
112 | + */ | ||
113 | + static void debug(const char* file, int line, | ||
114 | + const QString& category, const QString& message); | ||
115 | + | ||
116 | + /** | ||
117 | + * @brief Log an info message in a category. | ||
118 | + * @param file Name of the source-file | ||
119 | + * @param line The line number in the source-file | ||
120 | + * @param category The category of the message. | ||
121 | + * @param message The string to print. | ||
122 | + */ | ||
123 | + static void info( const char* file, int line, | ||
124 | + const QString& category, const QString& message ); | ||
125 | + | ||
126 | + /** | ||
127 | + * @brief Log a warning message in a category. | ||
128 | + * @param file Name of the source-file | ||
129 | + * @param line The line number in the source-file | ||
130 | + * @param category The category of the message. | ||
131 | + * @param message The string to print. | ||
132 | + */ | ||
133 | + static void warning( const char* file, int line, | ||
134 | + const QString& category, const QString& message ); | ||
135 | + | ||
136 | + /** | ||
137 | + * @brief Log an error message in a category. | ||
138 | + * @param file Name of the source-file | ||
139 | + * @param line The line number in the source-file | ||
140 | + * @param category The category of the message. | ||
141 | + * @param message The string to print. | ||
142 | + */ | ||
143 | + static void error( const char* file, int line, | ||
144 | + const QString& category, const QString& message ); | ||
145 | + | ||
146 | + /** | ||
147 | + * @brief Dump a complete Qt Object in the logging stream at LogLevel::Debug | ||
148 | + * @param file Name of the source-file | ||
149 | + * @param line The line number in the source-file | ||
150 | + * @param category The category of the message | ||
151 | + * @param object The object to print | ||
152 | + */ | ||
153 | + static void logObject( const char* file, int line, | ||
154 | + const QString& category, QObject* object ); | ||
155 | + | ||
156 | + /** | ||
157 | + * @return The current log level. | ||
158 | + */ | ||
159 | + static LogLevel level() | ||
160 | + { | ||
161 | + return s_logLevel; | ||
162 | + } | ||
163 | + | ||
164 | +protected: | ||
165 | + /** | ||
166 | + * @brief Log a debug message in a category. | ||
167 | + * @param category The category of the message. | ||
168 | + * @param message The string to print. | ||
169 | + */ | ||
170 | + static void debug(const QString& category, const QString& message); | ||
171 | + | ||
172 | + /** | ||
173 | + * @brief Log an info message in a category. | ||
174 | + * @param category The category of the message. | ||
175 | + * @param message The string to print. | ||
176 | + */ | ||
177 | + static void info( const QString& category, const QString& message ); | ||
178 | + | ||
179 | + /** | ||
180 | + * @brief Log a warning message in a category. | ||
181 | + * @param category The category of the message. | ||
182 | + * @param message The string to print. | ||
183 | + */ | ||
184 | + static void warning( const QString& category, const QString& message ); | ||
185 | + | ||
186 | + /** | ||
187 | + * @brief Log an error message in a category. | ||
188 | + * @param category The category of the message. | ||
189 | + * @param message The string to print. | ||
190 | + */ | ||
191 | + static void error( const QString& category, const QString& message ); | ||
192 | + | ||
193 | + /** | ||
194 | + * @brief Log a trace message in a category. | ||
195 | + * @param category The category of the message. | ||
196 | + * @param message The string to print. | ||
197 | + */ | ||
198 | + static void trace( const QString& category, const QString& message ); | ||
199 | + | ||
200 | + /** | ||
201 | + * @brief Dump a complete Qt Object in the logging stream at LogLevel::Info | ||
202 | + * @param category The category of the message | ||
203 | + * @param object The object to print | ||
204 | + */ | ||
205 | + static void logObject( const QString& category, QObject* object ); | ||
206 | + | ||
207 | + //! Create a convenient timestamp | ||
208 | + static QString getDateTime(); | ||
209 | + | ||
210 | + /** | ||
211 | + * @brief Write the message to the logfile | ||
212 | + * @param category The category of the message. | ||
213 | + * @param message The string to print. | ||
214 | + * @param level Selected log level | ||
215 | + */ | ||
216 | + static void writeLog( const QString& category, | ||
217 | + const QString& message, | ||
218 | + LogLevel level ); | ||
219 | + | ||
220 | + /** | ||
221 | + * @brief Log an error message in a category. | ||
222 | + * @param category The category of the message. | ||
223 | + * @param message The string to print. | ||
224 | + * @param level Selected log level | ||
225 | + */ | ||
226 | + static void log(const QString& category, | ||
227 | + const QString& message, | ||
228 | + LogLevel level); | ||
229 | + | ||
230 | +private: | ||
231 | + /** | ||
232 | + * @brief Put filename, line-number and message in one string | ||
233 | + * @param file Source-file | ||
234 | + * @param line Line in source-file | ||
235 | + * @param message The string to print | ||
236 | + * @return Formatted string with file, line and message | ||
237 | + */ | ||
238 | + static QString fileinfoMessage(const char* file, int line, | ||
239 | + const QString& message); | ||
240 | + | ||
241 | + //! The main context. | ||
242 | + static QString s_context; | ||
243 | + | ||
244 | + //! The name of the LogFile. | ||
245 | + static QString s_fileName; | ||
246 | + | ||
247 | + //! The amount of logging | ||
248 | + static LogLevel s_logLevel; | ||
249 | + | ||
250 | + //! Mutex to keep it thread-safe | ||
251 | + static QMutex m_mutex; | ||
252 | +}; | ||
253 | + | ||
254 | +} // End namespace components | ||
255 | +} // End namespace osdev | ||
256 | + | ||
257 | +#endif // OSDEV_COMPONENTS_LOG_H |
src/logutilslibexport.h
0 → 100644
1 | +++ a/src/logutilslibexport.h | ||
1 | +/* ************************************************************************************************************************************************************************** | ||
2 | + * Copyright 2019 Open Systems Development BV * | ||
3 | + * * | ||
4 | + * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), * | ||
5 | + * to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, * | ||
6 | + * 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: * | ||
7 | + * * | ||
8 | + * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. * | ||
9 | + * * | ||
10 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * | ||
11 | + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * | ||
12 | + * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * | ||
13 | + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * | ||
14 | + * **************************************************************************************************************************************************************************/ | ||
15 | + | ||
16 | +#ifndef OSDEV_CAELUS_LOGUTILSLIBEXPORT_H | ||
17 | +#define OSDEV_CAELUS_LOGUTILSLIBEXPORT_H | ||
18 | + | ||
19 | +#ifdef WIN32 | ||
20 | + | ||
21 | +#ifdef LOGUTILSLIB | ||
22 | +#define LOGUTILSLIBINTERFACE __declspec(dllexport) | ||
23 | +#else | ||
24 | +#define LOGUTILSLIBINTERFACE __declspec(dllimport) | ||
25 | +#endif | ||
26 | + | ||
27 | +#else | ||
28 | +#define LOGUTILSLIBINTERFACE | ||
29 | +#endif | ||
30 | + | ||
31 | + | ||
32 | +#endif |
src/threadcontext.cpp
0 → 100644
1 | +++ a/src/threadcontext.cpp | ||
1 | +/* ************************************************************************************************************************************************************************** | ||
2 | + * Copyright 2019 Open Systems Development BV * | ||
3 | + * * | ||
4 | + * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), * | ||
5 | + * to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, * | ||
6 | + * 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: * | ||
7 | + * * | ||
8 | + * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. * | ||
9 | + * * | ||
10 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * | ||
11 | + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * | ||
12 | + * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * | ||
13 | + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * | ||
14 | + * **************************************************************************************************************************************************************************/ | ||
15 | + | ||
16 | +#include "threadcontext.h" | ||
17 | + | ||
18 | +// std | ||
19 | +#include <thread> | ||
20 | + | ||
21 | +using namespace osdev::components; | ||
22 | + | ||
23 | +ThreadContextScope::ThreadContextScope(const QString& _context) | ||
24 | + : m_previousContext(ThreadContext::instance().context()) | ||
25 | +{ | ||
26 | + ThreadContext::instance().setContext(_context); | ||
27 | +} | ||
28 | + | ||
29 | +ThreadContextScope::~ThreadContextScope() | ||
30 | +{ | ||
31 | + ThreadContext::instance().setContext(m_previousContext); | ||
32 | +} | ||
33 | + | ||
34 | +// static | ||
35 | +ThreadContext& ThreadContext::instance() | ||
36 | +{ | ||
37 | + static thread_local ThreadContext tc; | ||
38 | + return tc; | ||
39 | +} | ||
40 | + | ||
41 | +ThreadContext::ThreadContext() | ||
42 | + : m_context("default") | ||
43 | +{ | ||
44 | +} | ||
45 | + |
src/threadcontext.h
0 → 100644
1 | +++ a/src/threadcontext.h | ||
1 | +/* ************************************************************************************************************************************************************************** | ||
2 | + * Copyright 2019 Open Systems Development BV * | ||
3 | + * * | ||
4 | + * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), * | ||
5 | + * to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, * | ||
6 | + * 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: * | ||
7 | + * * | ||
8 | + * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. * | ||
9 | + * * | ||
10 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * | ||
11 | + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * | ||
12 | + * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * | ||
13 | + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * | ||
14 | + * **************************************************************************************************************************************************************************/ | ||
15 | + | ||
16 | +#ifndef OSDEV_COMPONENTS_THREADCONTEXT_H | ||
17 | +#define OSDEV_COMPONENTS_THREADCONTEXT_H | ||
18 | + | ||
19 | +// Qt | ||
20 | +#include <QString> | ||
21 | + | ||
22 | +namespace osdev { | ||
23 | +namespace components { | ||
24 | + | ||
25 | +/** | ||
26 | + * @brief Set the current thread context. | ||
27 | + * The context is restored to the previous context when this object goes out of scope. | ||
28 | + * @note This object is meant to be used on the stack. | ||
29 | + */ | ||
30 | +class ThreadContextScope | ||
31 | +{ | ||
32 | +public: | ||
33 | + /** | ||
34 | + * @brief Construct a scoped object that sets the current thread context. | ||
35 | + * @param context The context that will be used by the logging framework. | ||
36 | + */ | ||
37 | + explicit ThreadContextScope(const QString& context); | ||
38 | + ~ThreadContextScope(); | ||
39 | + | ||
40 | + // Non copyable and non movable | ||
41 | + ThreadContextScope(const ThreadContextScope&) = delete; | ||
42 | + ThreadContextScope& operator=(const ThreadContextScope&) = delete; | ||
43 | + ThreadContextScope(ThreadContextScope&&) = delete; | ||
44 | + ThreadContextScope& operator=(ThreadContextScope&&) = delete; | ||
45 | + | ||
46 | +private: | ||
47 | + QString m_previousContext; ///< Copy of the previous context. | ||
48 | +}; | ||
49 | + | ||
50 | +/** | ||
51 | + * @brief Add context to a thread. | ||
52 | + * For every thread only one specific instance of this object will exist. | ||
53 | + * @note Contexts can only be set by using a ThreadContextScope object. | ||
54 | + */ | ||
55 | +class ThreadContext | ||
56 | +{ | ||
57 | + | ||
58 | +// Contexts can only be set by using a ThreadContextScope object. | ||
59 | +friend class ThreadContextScope; | ||
60 | + | ||
61 | +public: | ||
62 | + static ThreadContext& instance(); | ||
63 | + | ||
64 | + /** | ||
65 | + * @brief Return the thread context. | ||
66 | + */ | ||
67 | + const QString& context() const | ||
68 | + { | ||
69 | + return m_context; | ||
70 | + } | ||
71 | + | ||
72 | +private: | ||
73 | + /** | ||
74 | + * @brief Set the thread context. | ||
75 | + */ | ||
76 | + void setContext(const QString& contextString) | ||
77 | + { | ||
78 | + m_context = contextString; | ||
79 | + } | ||
80 | + | ||
81 | + /** | ||
82 | + * Construct a ThreadContext object. | ||
83 | + * The context is set to "default" | ||
84 | + */ | ||
85 | + ThreadContext(); | ||
86 | + | ||
87 | + // Non copyable and non movable | ||
88 | + ThreadContext(const ThreadContext&) = delete; | ||
89 | + ThreadContext& operator=(const ThreadContext&) = delete; | ||
90 | + ThreadContext(ThreadContext&&) = delete; | ||
91 | + ThreadContext& operator=(ThreadContext&&) = delete; | ||
92 | + | ||
93 | + QString m_context; ///< The context string | ||
94 | +}; | ||
95 | + | ||
96 | +} /* End namespace components */ | ||
97 | +} /* End namespace osdev */ | ||
98 | + | ||
99 | +#endif // OSDEV_COMPONENTS_THREADCONTEXT_H |
tests/CMakeLists.txt
0 → 100644
1 | +++ a/tests/CMakeLists.txt | ||
1 | +cmake_minimum_required(VERSION 3.0) | ||
2 | +LIST(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../cmake) | ||
3 | + | ||
4 | +include(projectheader) | ||
5 | +project_header(test_logutils) | ||
6 | + | ||
7 | +include_directories( SYSTEM | ||
8 | + ${CMAKE_CURRENT_SOURCE_DIR}/../../src | ||
9 | +) | ||
10 | + | ||
11 | +include(compiler) | ||
12 | +set(SRC_LIST | ||
13 | +) | ||
14 | + | ||
15 | +# add_executable( ${PROJECT_NAME} | ||
16 | +# ${SRC_LIST} | ||
17 | +# ) | ||
18 | + | ||
19 | +# target_link_libraries( | ||
20 | +# ${PROJECT_NAME} | ||
21 | +# ) | ||
22 | + | ||
23 | +# set_target_properties( ${PROJECT_NAME} PROPERTIES | ||
24 | +# RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin | ||
25 | +# LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib | ||
26 | +# ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/archive | ||
27 | +# ) | ||
28 | + | ||
29 | +# include(installation) | ||
30 | +# install_application() |