Commit 13df26c37b0e553e59fac829980e99b69b226b94
0 parents
Static Logger class - initial push
Showing
17 changed files
with
911 additions
and
0 deletions
.gitignore
0 → 100644
.gitmodules
0 → 100644
CMakeLists.txt
0 → 100644
1 | +++ a/CMakeLists.txt | |
1 | +cmake_minimum_required(VERSION 3.0) | |
2 | +project(osdev_logger) | |
3 | + | |
4 | +LIST( APPEND CMAKE_MODULE_PATH ${CMAKE_SOURCE_DIR}/submodules/cmake ) | |
5 | +LIST( APPEND CMAKE_MODULE_PATH ${CMAKE_SOURCE_DIR}/submodules/versioning/cmake ) | |
6 | + | |
7 | +include(projectheader) | |
8 | +project_header(osdev_logger) | |
9 | + | |
10 | +add_subdirectory(src) | |
11 | +add_subdirectory(tests) | |
12 | + | |
13 | +#include(packaging) | |
14 | +#package_component() | ... | ... |
README.md
0 → 100644
1 | +++ a/README.md | ... | ... |
scripts/setup_submodules
0 → 100755
1 | +++ a/scripts/setup_submodules | |
1 | +#!/bin/bash | |
2 | + | |
3 | +# =============================================== | |
4 | +# == Setting some environment variables | |
5 | +# =============================================== | |
6 | +GIT_URL_OPEN="http://gitlab.osdev.nl/open_source" | |
7 | +GIT_URL_CLOSED="git@gitlab.osdev.nl:closed_source" | |
8 | + | |
9 | +FUNC_RESULT="-1" | |
10 | + | |
11 | +# Name : print_usage_exit() | |
12 | +# Description : Print the way this script is intended to be used and exit. | |
13 | +# Parameters : None. | |
14 | +# Returns : err_code 1 to the Operating System | |
15 | +# -------------------------------------------------------------------------------------- | |
16 | +function print_usage_exit() | |
17 | +{ | |
18 | + echo "Usage $0 -i|--install|-u|--update" | |
19 | + echo " -i or --install Install the submodules mentioned in the submodules.list" | |
20 | + echo " -u or --update Update the submodules mentioned in the submodules.list" | |
21 | + echo " " | |
22 | + exit 1 | |
23 | +} | |
24 | + | |
25 | +# Name : check_top_or_sub | |
26 | +# Description : Determine if we're running in a "single" lib-build or part of a | |
27 | +# "meta"-repository ( submodule ). | |
28 | +# Parameters : None | |
29 | +# Returns : Updates the value FUNC_RESULT. | |
30 | +# -1 - We're neither a git-repo or submodule. | |
31 | +# 0 - We're a submodule | |
32 | +# 1 - We're a top-repo ( Single library ) | |
33 | +# -------------------------------------------------------------------------------------- | |
34 | +function check_top_or_sub() | |
35 | +{ | |
36 | + # This function checks if we're the top-repository. | |
37 | + # In that case we need the submodules.. If we're already a submodule, | |
38 | + # we simply exit this script with a message | |
39 | + if [ -e ./.git ]; then | |
40 | + FUNC_RESULT="1" | |
41 | + return | |
42 | + elif [ -e ../.git ]; then | |
43 | + if [ -e ../.submodules ]; then | |
44 | + echo "Seems like we're already a submodule. Nothing to do here." | |
45 | + FUNC_RESULT="0" | |
46 | + return | |
47 | + fi | |
48 | + fi | |
49 | + FUNC_RESULT="-1" | |
50 | + return | |
51 | +} | |
52 | + | |
53 | +# Name : check_working_dir | |
54 | +# Description : If we're in the top of our repo, we can run this script further. | |
55 | +# Parameters : None. | |
56 | +# Returns : Updates the value FUNC_RESULT. | |
57 | +# -1 - Not used. | |
58 | +# 0 - We're not on the top-level | |
59 | +# 1 - We're at the top-level. Good to go. | |
60 | +# -------------------------------------------------------------------------------------- | |
61 | +function check_working_dir() | |
62 | +{ | |
63 | + FUNC_RESULT="-1" | |
64 | + # Check if we're in the top-level directory of our repository. | |
65 | + if [ -f ./scripts/submodules.list ]; then | |
66 | + # We're good to go | |
67 | + FUNC_RESULT="1" | |
68 | + return | |
69 | + fi | |
70 | + FUNC_RESULT="0" | |
71 | + return | |
72 | +} | |
73 | + | |
74 | +# Name : read_submodules | |
75 | +# Description : Read the list of submodules needed for this project | |
76 | +# Parameters : None | |
77 | +# Returns : Updates the value FUNC_RESULT | |
78 | +# 0 - Module list was not found | |
79 | +# 1 - Module list was found and read. | |
80 | +# -------------------------------------------------------------------------------------- | |
81 | +function read_submodules() | |
82 | +{ | |
83 | + FUNC_RESULT="-1" | |
84 | + if [ -e ./scripts/submodules.list ]; then | |
85 | + source ./scripts/submodules.list | |
86 | + FUNC_RESULT="1" | |
87 | + return | |
88 | + fi | |
89 | + | |
90 | + echo "Submodules list not found...." | |
91 | + FUNC_RESULT="0" | |
92 | + return | |
93 | +} | |
94 | + | |
95 | +# Name : add_submodules | |
96 | +# Description : Configure the repo to add the submodules. | |
97 | +# Parameters : None. | |
98 | +# Returns : None. | |
99 | +# -------------------------------------------------------------------------------------- | |
100 | +function add_submodules() | |
101 | +{ | |
102 | + echo -e "Adding SubModule(s)." | |
103 | + for SUB_MODULE in ${SUB_MODULES_OPEN} | |
104 | + do | |
105 | + git submodule add -f ${GIT_URL_OPEN}/${SUB_MODULE}.git submodules/${SUB_MODULE} | |
106 | + git config submodule.${SUB_MODULE}.url ${GIT_URL_OPEN}/${SUB_MODULE}.git | |
107 | + done | |
108 | + | |
109 | + for SUB_MODULE in ${SUB_MODULES_CLOSED} | |
110 | + do | |
111 | + echo {GIT_URL_CLOSED}/${SUB_MODULE}.git | |
112 | + git submodule add -f ${GIT_URL_CLOSED}/${SUB_MODULE}.git submodules/${SUB_MODULE} | |
113 | + git config submodule.${SUB_MODULE}.url ${GIT_URL_CLOSED}/${SUB_MODULE}.git | |
114 | + done | |
115 | + | |
116 | +} | |
117 | + | |
118 | +# Name : get_submodules | |
119 | +# Description : Actually get the submodules from gitlab and add them. | |
120 | +# Parameters : None | |
121 | +# Returns : None | |
122 | +# -------------------------------------------------------------------------------------- | |
123 | +function get_submodules() | |
124 | +{ | |
125 | + git submodule update --init --recursive | |
126 | +} | |
127 | + | |
128 | +# Name : update_submodules | |
129 | +# Description : Update the submodules already added. | |
130 | +# Parameters : None | |
131 | +# Returns : None | |
132 | +# -------------------------------------------------------------------------------------- | |
133 | +function update_submodules() | |
134 | +{ | |
135 | + git submodule update --recursive | |
136 | +} | |
137 | + | |
138 | +# ============================================================================= | |
139 | +# == T H E M A I N E N T R Y O F T H I S S C R I P T == | |
140 | +# ============================================================================= | |
141 | +check_top_or_sub | |
142 | +if [ "${FUNC_RESULT}" == "0" ]; then | |
143 | + echo "Seems like we're a submodule already or not part of a repository." | |
144 | + exit 0 | |
145 | +fi | |
146 | + | |
147 | +check_working_dir | |
148 | +if [ "${FUNC_RESULT}" == "0" ]; then | |
149 | + echo "Go to the top of this repository and type : scripts/setup_submodules [-i|--install]" | |
150 | + exit 0 | |
151 | +fi | |
152 | + | |
153 | +read_submodules | |
154 | + | |
155 | +case "$1" in | |
156 | + -i*|--install*) | |
157 | + echo "Installing submodules for this repository ( ${PWD} )" | |
158 | + add_submodules | |
159 | + get_submodules | |
160 | + ;; | |
161 | + -u*|--update*) | |
162 | + echo "Update submodules : ${SUB_MODULES}" | |
163 | + update_submodules | |
164 | + ;; | |
165 | + *) | |
166 | + echo "No parameters found..." | |
167 | + print_usage_exit | |
168 | + ;; | |
169 | +esac | |
170 | + | ... | ... |
scripts/submodules.list
0 → 100644
src/CMakeLists.txt
0 → 100644
1 | +++ a/src/CMakeLists.txt | |
1 | +cmake_minimum_required(VERSION 3.12) | |
2 | +include(projectheader) | |
3 | +project_header(logger) | |
4 | + | |
5 | +include_directories( SYSTEM | |
6 | +) | |
7 | + | |
8 | +include(compiler) | |
9 | + | |
10 | +set(SRC_LIST | |
11 | + #${CMAKE_CURRENT_SOURCE_DIR}/logger.cpp | |
12 | + ${CMAKE_CURRENT_SOURCE_DIR}/threadcontext.cpp | |
13 | + ${CMAKE_CURRENT_SOURCE_DIR}/log.cpp | |
14 | +) | |
15 | + | |
16 | +include(library) | |
17 | +add_libraries( | |
18 | +) | |
19 | + | |
20 | +include(installation) | |
21 | +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 * | |
5 | + * copy of this software and associated documentation files (the "Software"), * | |
6 | + * to deal in the Software without restriction, including without limitation * | |
7 | + * the rights to use, copy, modify, merge, publish, distribute, sublicense, * | |
8 | + * and/or sell copies of the Software, and to permit persons to whom the * | |
9 | + * Software is furnished to do so, subject to the following conditions: * | |
10 | + * * | |
11 | + * The above copyright notice and this permission notice shall be included in * | |
12 | + * all copies or substantial portions of the Software. * | |
13 | + * * | |
14 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * | |
15 | + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * | |
16 | + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * | |
17 | + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * | |
18 | + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * | |
19 | + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * | |
20 | + * DEALINGS IN THE SOFTWARE. * | |
21 | + * ***************************************************************************/ | |
22 | + | |
23 | +// std | |
24 | +#include <ios> | |
25 | +#include <iomanip> | |
26 | +#include <iostream> | |
27 | +#include <sstream> | |
28 | +#include <thread> | |
29 | + | |
30 | +#include "log.h" | |
31 | +#include "threadcontext.h" | |
32 | + | |
33 | +namespace osdev { | |
34 | +namespace components { | |
35 | +namespace log { | |
36 | + | |
37 | +int toInt( LogLevel level ) | |
38 | +{ | |
39 | + switch( level ) | |
40 | + { | |
41 | + case LogLevel::Emergency: | |
42 | + return 0; | |
43 | + case LogLevel::Alert: | |
44 | + return 1; | |
45 | + case LogLevel::Critical: | |
46 | + return 2; | |
47 | + case LogLevel::Error: | |
48 | + return 3; | |
49 | + case LogLevel::Warning: | |
50 | + return 4; | |
51 | + case LogLevel::Notice: | |
52 | + return 5; | |
53 | + case LogLevel::Info: | |
54 | + return 6; | |
55 | + case LogLevel::Debug: | |
56 | + return 7; | |
57 | + } | |
58 | + return -1; | |
59 | +} | |
60 | + | |
61 | +std::string Log::s_context = std::string(); | |
62 | +std::string Log::s_fileName = std::string(); | |
63 | +LogLevel Log::s_logLevel = LogLevel::Error; | |
64 | +LogMask Log::s_logMask = LogMask::None; | |
65 | + | |
66 | +std::mutex Log::m_mutex = std::mutex(); | |
67 | + | |
68 | +void Log::init( const std::string& context, const std::string& logFile, LogLevel logDepth ) | |
69 | +{ | |
70 | + s_logLevel = logDepth; | |
71 | + s_context = context; | |
72 | + | |
73 | + if ( !logFile.empty() ) | |
74 | + { | |
75 | + s_fileName = logFile; | |
76 | + } | |
77 | +} | |
78 | + | |
79 | +void Log::terminate() | |
80 | +{ | |
81 | + s_context.clear(); | |
82 | + s_fileName.clear(); | |
83 | + s_logLevel = LogLevel::Debug; | |
84 | + s_logMask = LogMask::None; | |
85 | +} | |
86 | + | |
87 | +void Log::write( const int &priority, const std::string &message, const std::string& context ) | |
88 | +{ | |
89 | + switch( s_logMask ) | |
90 | + { | |
91 | + case LogMask::Mask: | |
92 | + setlogmask( LOG_MASK( toInt( s_logLevel ) ) ); | |
93 | + break; | |
94 | + case LogMask::Upto: | |
95 | + setlogmask( LOG_UPTO( toInt( s_logLevel ) ) ); | |
96 | + break; | |
97 | + case LogMask::None: | |
98 | + setlogmask( LOG_UPTO( toInt( LogLevel::Debug ) ) ); | |
99 | + break; | |
100 | + default: | |
101 | + break; | |
102 | + } | |
103 | + | |
104 | + if( !context.empty() ) | |
105 | + { | |
106 | + s_context = context; | |
107 | + openlog( s_context.c_str(), LOG_PID, LOG_USER ); | |
108 | + } | |
109 | + else | |
110 | + { | |
111 | + openlog( NULL, LOG_PID, LOG_USER ); | |
112 | + } | |
113 | + | |
114 | + syslog( priority, "%s", message.c_str() ); | |
115 | + closelog(); | |
116 | +} | |
117 | + | |
118 | +std::string Log::fileinfoMessage( const char* file, int line, const std::string& message ) | |
119 | +{ | |
120 | + (void)file; | |
121 | + (void)line; | |
122 | + | |
123 | +// static const std::string templ("%1:%2| %3"); | |
124 | +// QFileInfo fi(file); | |
125 | +// return templ.arg( fi.fileName() ).arg(line).arg(message); | |
126 | + | |
127 | + return message; | |
128 | +} | |
129 | + | |
130 | +void Log::log( const std::string &category, const std::string &message, LogLevel level ) | |
131 | +{ | |
132 | + std::lock_guard<std::mutex> lock(m_mutex); | |
133 | + | |
134 | + std::string logCategory = category; | |
135 | + std::string logMessage = message; | |
136 | + if( logMessage.empty() ) | |
137 | + { | |
138 | + static const std::string emptyMessage( "--" ); | |
139 | + logMessage = emptyMessage; | |
140 | + } | |
141 | + else | |
142 | + { | |
143 | + // Replace % signs | |
144 | + ReplaceAll( logMessage, "%", "%%" ); | |
145 | + } | |
146 | + | |
147 | + write( toInt( level ), logCategory, logMessage ); | |
148 | +} | |
149 | + | |
150 | +// Static functions | |
151 | +void Log::emergency( const char *file, int line, const std::string &category, const std::string &message ) | |
152 | +{ | |
153 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Emergency ); | |
154 | +} | |
155 | + | |
156 | +void Log::alert( const char *file, int line, const std::string &category, const std::string &message ) | |
157 | +{ | |
158 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Alert ); | |
159 | +} | |
160 | + | |
161 | +void Log::critical( const char *file, int line, const std::string &category, const std::string &message ) | |
162 | +{ | |
163 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Critical ); | |
164 | +} | |
165 | + | |
166 | +void Log::error( const char *file, int line, const std::string &category, const std::string &message ) | |
167 | +{ | |
168 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Error ); | |
169 | +} | |
170 | + | |
171 | +void Log::warning( const char *file, int line, const std::string &category, const std::string &message ) | |
172 | +{ | |
173 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Warning ); | |
174 | +} | |
175 | + | |
176 | +void Log::notice( const char *file, int line, const std::string &category, const std::string &message ) | |
177 | +{ | |
178 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Notice ); | |
179 | +} | |
180 | + | |
181 | +void Log::info( const char *file, int line, const std::string &category, const std::string &message ) | |
182 | +{ | |
183 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Info ); | |
184 | +} | |
185 | + | |
186 | +void Log::debug( const char *file, int line, const std::string &category, const std::string &message ) | |
187 | +{ | |
188 | + log( category, fileinfoMessage( file, line, message ), LogLevel::Debug ); | |
189 | +} | |
190 | + | |
191 | +// Protected functions | |
192 | +void Log::emergency( const std::string &category, const std::string &message ) | |
193 | +{ | |
194 | + write( toInt( LogLevel::Emergency ), message, category ); | |
195 | +} | |
196 | + | |
197 | +void Log::alert( const std::string &category, const std::string &message ) | |
198 | +{ | |
199 | + write( toInt( LogLevel::Alert ), message, category ); | |
200 | +} | |
201 | + | |
202 | +void Log::critical( const std::string &category, const std::string &message ) | |
203 | +{ | |
204 | + write( toInt( LogLevel::Critical ), message, category ); | |
205 | +} | |
206 | + | |
207 | +void Log::error( const std::string &category, const std::string &message ) | |
208 | +{ | |
209 | + write( toInt( LogLevel::Error ), message, category ); | |
210 | +} | |
211 | + | |
212 | +void Log::warning( const std::string &category, const std::string &message ) | |
213 | +{ | |
214 | + write( toInt( LogLevel::Warning ), message, category ); | |
215 | +} | |
216 | + | |
217 | +void Log::notice( const std::string &category, const std::string &message ) | |
218 | +{ | |
219 | + write( toInt( LogLevel::Notice ), message, category ); | |
220 | +} | |
221 | + | |
222 | +void Log::info( const std::string &category, const std::string &message ) | |
223 | +{ | |
224 | + write( toInt( LogLevel::Info ), message, category ); | |
225 | +} | |
226 | + | |
227 | +void Log::debug( const std::string &category, const std::string &message ) | |
228 | +{ | |
229 | + write( toInt( LogLevel::Debug ), message, category ); | |
230 | +} | |
231 | + | |
232 | +void Log::ReplaceAll( std::string &strToReplace, const std::string& from_chars, const std::string& to_chars ) | |
233 | +{ | |
234 | + size_t start_pos = 0; | |
235 | + while( ( start_pos = strToReplace.find( from_chars, start_pos ) ) != std::string::npos ) | |
236 | + { | |
237 | + strToReplace.replace( start_pos, from_chars.length(), to_chars ); | |
238 | + start_pos += to_chars.length(); // Handles case where 'to' is a substring of 'from' | |
239 | + } | |
240 | +} | |
241 | + | |
242 | +} /* End namespace log */ | |
243 | +} /* End namespace components */ | |
244 | +} /* 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 * | |
5 | + * copy of this software and associated documentation files (the "Software"), * | |
6 | + * to deal in the Software without restriction, including without limitation * | |
7 | + * the rights to use, copy, modify, merge, publish, distribute, sublicense, * | |
8 | + * and/or sell copies of the Software, and to permit persons to whom the * | |
9 | + * Software is furnished to do so, subject to the following conditions: * | |
10 | + * * | |
11 | + * The above copyright notice and this permission notice shall be included in * | |
12 | + * all copies or substantial portions of the Software. * | |
13 | + * * | |
14 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * | |
15 | + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * | |
16 | + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * | |
17 | + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * | |
18 | + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * | |
19 | + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * | |
20 | + * DEALINGS IN THE SOFTWARE. * | |
21 | + * ***************************************************************************/ | |
22 | +#pragma once | |
23 | + | |
24 | +#include <string> | |
25 | +#include <mutex> | |
26 | +#include <syslog.h> | |
27 | + | |
28 | +namespace osdev { | |
29 | +namespace components { | |
30 | +namespace log { | |
31 | + | |
32 | +#define LogEmergency(context, text) \ | |
33 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Emergency)\ | |
34 | + { \ | |
35 | + osdev::components::log::Log::emergency(__FILE__, __LINE__, context, text); \ | |
36 | + } | |
37 | + | |
38 | +#define LogAlert(context, text) \ | |
39 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Alert) \ | |
40 | + { \ | |
41 | + osdev::components::log::Log::alert(__FILE__, __LINE__, context, text); \ | |
42 | + } | |
43 | + | |
44 | +#define LogCritical(context, text) \ | |
45 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Critical) \ | |
46 | + { \ | |
47 | + osdev::components::log::Log::critical(__FILE__, __LINE__, context, text); \ | |
48 | + } | |
49 | + | |
50 | +#define LogError(context, text) \ | |
51 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Error) \ | |
52 | + { \ | |
53 | + osdev::components::log::Log::error(__FILE__, __LINE__, context, text); \ | |
54 | + } | |
55 | + | |
56 | +#define LogWarning(context, text) \ | |
57 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Warning) \ | |
58 | + { \ | |
59 | + osdev::components::log::Log::warning(__FILE__, __LINE__, context, text); \ | |
60 | + } | |
61 | + | |
62 | +#define LogNotice(context, text) \ | |
63 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Notice) \ | |
64 | + { \ | |
65 | + osdev::components::log::Log::notice(__FILE__, __LINE__, context, text); \ | |
66 | + } | |
67 | + | |
68 | +#define LogInfo(context, text) \ | |
69 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Info) \ | |
70 | + { \ | |
71 | + osdev::components::log::Log::info(__FILE__, __LINE__, context, text); \ | |
72 | + } | |
73 | + | |
74 | +#define LogDebug(context, text) \ | |
75 | + if (osdev::components::log::Log::level() >= osdev::components::log::LogLevel::Debug) \ | |
76 | + { \ | |
77 | + osdev::components::log::Log::debug(__FILE__, __LINE__, context, text); \ | |
78 | + } | |
79 | + | |
80 | +enum class LogLevel | |
81 | +{ | |
82 | + Emergency = 0, | |
83 | + Alert, | |
84 | + Critical, | |
85 | + Error, | |
86 | + Warning, | |
87 | + Notice, | |
88 | + Info, | |
89 | + Debug | |
90 | +}; | |
91 | + | |
92 | +enum class LogMask | |
93 | +{ | |
94 | + Mask = 0, | |
95 | + Upto, | |
96 | + None | |
97 | +}; | |
98 | + | |
99 | +/*! \class Log | |
100 | + \brief Basic logging mechanism. | |
101 | +*/ | |
102 | +class Log | |
103 | +{ | |
104 | +public: | |
105 | + static void init( const std::string& context, | |
106 | + const std::string& logFile = std::string(), | |
107 | + LogLevel logDepth = LogLevel::Info ); | |
108 | + | |
109 | + static void terminate(); | |
110 | + | |
111 | + static void write( const int &priority, const std::string &message, const std::string &context = std::string() ); | |
112 | + | |
113 | + static void emergency( const char* file, int line, const std::string& category, const std::string& message ); | |
114 | + static void alert ( const char* file, int line, const std::string& category, const std::string& message ); | |
115 | + static void critical ( const char* file, int line, const std::string& category, const std::string& message ); | |
116 | + static void error ( const char* file, int line, const std::string& category, const std::string& message ); | |
117 | + static void warning ( const char* file, int line, const std::string& category, const std::string& message ); | |
118 | + static void notice ( const char* file, int line, const std::string& category, const std::string& message ); | |
119 | + static void info ( const char* file, int line, const std::string& category, const std::string& message ); | |
120 | + static void debug ( const char* file, int line, const std::string& category, const std::string& message ); | |
121 | + | |
122 | + /** | |
123 | + * @return The current log level. | |
124 | + */ | |
125 | + static LogLevel level() | |
126 | + { | |
127 | + if( s_logMask == LogMask::None ) | |
128 | + { | |
129 | + return LogLevel::Debug; | |
130 | + } | |
131 | + return s_logLevel; | |
132 | + } | |
133 | + | |
134 | + static void setMask ( LogMask logMask ) { s_logMask = logMask; } | |
135 | + static void setLogLevel( LogLevel logLevel ) { s_logLevel = logLevel; } | |
136 | + static void setContext ( std::string context ) { s_context = context; } | |
137 | + | |
138 | +protected: | |
139 | + static void emergency( const std::string& category, const std::string& message ); | |
140 | + static void alert ( const std::string& category, const std::string& message ); | |
141 | + static void critical ( const std::string& category, const std::string& message ); | |
142 | + static void error ( const std::string& category, const std::string& message ); | |
143 | + static void warning ( const std::string& category, const std::string& message ); | |
144 | + static void notice ( const std::string& category, const std::string& message ); | |
145 | + static void info ( const std::string& category, const std::string& message ); | |
146 | + static void debug ( const std::string& category, const std::string& message ); | |
147 | + | |
148 | + /** | |
149 | + * @brief Log an error message in a category. | |
150 | + * @param category The category of the message. | |
151 | + * @param message The string to print. | |
152 | + * @param level Selected log level | |
153 | + */ | |
154 | + static void log( const std::string &category, | |
155 | + const std::string &message, | |
156 | + LogLevel level ); | |
157 | + | |
158 | +private: | |
159 | + /** | |
160 | + * @brief Replace the characters in a std::string with other characters. | |
161 | + * @param strToReplace The string we want to replace characters in | |
162 | + * @param from_chars The characters we want to replace | |
163 | + * @param to_chars The characters we want to replace with. | |
164 | + * @return strToReplace This is the original string with the replaced characters. | |
165 | + */ | |
166 | + static void ReplaceAll( std::string &strToReplace, const std::string& from_chars, const std::string& to_chars ); | |
167 | + | |
168 | + /** | |
169 | + * @brief Put filename, line-number and message in one string | |
170 | + * @param file Source-file | |
171 | + * @param line Line in source-file | |
172 | + * @param message The string to print | |
173 | + * @return Formatted string with file, line and message | |
174 | + */ | |
175 | + static std::string fileinfoMessage(const char* file, int line, | |
176 | + const std::string& message); | |
177 | + | |
178 | + //! The main context. | |
179 | + static std::string s_context; | |
180 | + | |
181 | + //! The name of the LogFile. | |
182 | + static std::string s_fileName; | |
183 | + | |
184 | + //! The amount of logging | |
185 | + static LogLevel s_logLevel; | |
186 | + | |
187 | + //! The mask | |
188 | + static LogMask s_logMask; | |
189 | + | |
190 | + //! Mutex to keep the logger thread-safe | |
191 | + static std::mutex m_mutex; | |
192 | +}; | |
193 | + | |
194 | +} // End namespace log | |
195 | +} // End namespace components | |
196 | +} // End namespace osdev | |
197 | + | ... | ... |
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 * | |
5 | + * copy of this software and associated documentation files (the "Software"), * | |
6 | + * to deal in the Software without restriction, including without limitation * | |
7 | + * the rights to use, copy, modify, merge, publish, distribute, sublicense, * | |
8 | + * and/or sell copies of the Software, and to permit persons to whom the * | |
9 | + * Software is furnished to do so, subject to the following conditions: * | |
10 | + * * | |
11 | + * The above copyright notice and this permission notice shall be included in * | |
12 | + * all copies or substantial portions of the Software. * | |
13 | + * * | |
14 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * | |
15 | + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * | |
16 | + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * | |
17 | + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * | |
18 | + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * | |
19 | + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * | |
20 | + * DEALINGS IN THE SOFTWARE. * | |
21 | + * ***************************************************************************/ | |
22 | + | |
23 | +#include "threadcontext.h" | |
24 | + | |
25 | +// std | |
26 | +#include <thread> | |
27 | + | |
28 | +using namespace osdev::components; | |
29 | + | |
30 | +ThreadContextScope::ThreadContextScope(const std::string& _context) | |
31 | + : m_previousContext(ThreadContext::instance().context()) | |
32 | +{ | |
33 | + ThreadContext::instance().setContext(_context); | |
34 | +} | |
35 | + | |
36 | +ThreadContextScope::~ThreadContextScope() | |
37 | +{ | |
38 | + ThreadContext::instance().setContext(m_previousContext); | |
39 | +} | |
40 | + | |
41 | +// static | |
42 | +ThreadContext& ThreadContext::instance() | |
43 | +{ | |
44 | + static thread_local ThreadContext tc; | |
45 | + return tc; | |
46 | +} | |
47 | + | |
48 | +ThreadContext::ThreadContext() | |
49 | + : m_context("default") | |
50 | +{ | |
51 | +} | |
52 | + | ... | ... |
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 * | |
5 | + * copy of this software and associated documentation files (the "Software"), * | |
6 | + * to deal in the Software without restriction, including without limitation * | |
7 | + * the rights to use, copy, modify, merge, publish, distribute, sublicense, * | |
8 | + * and/or sell copies of the Software, and to permit persons to whom the * | |
9 | + * Software is furnished to do so, subject to the following conditions: * | |
10 | + * * | |
11 | + * The above copyright notice and this permission notice shall be included in * | |
12 | + * all copies or substantial portions of the Software. * | |
13 | + * * | |
14 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * | |
15 | + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * | |
16 | + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * | |
17 | + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * | |
18 | + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * | |
19 | + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * | |
20 | + * DEALINGS IN THE SOFTWARE. * | |
21 | + * ***************************************************************************/ | |
22 | +#ifndef OSDEV_COMPONENTS_THREADCONTEXT_H | |
23 | +#define OSDEV_COMPONENTS_THREADCONTEXT_H | |
24 | + | |
25 | +// Qt | |
26 | +#include <string> | |
27 | + | |
28 | +namespace osdev { | |
29 | +namespace components { | |
30 | + | |
31 | +/** | |
32 | + * @brief Set the current thread context. | |
33 | + * The context is restored to the previous context when this object goes out of scope. | |
34 | + * @note This object is meant to be used on the stack. | |
35 | + */ | |
36 | +class ThreadContextScope | |
37 | +{ | |
38 | +public: | |
39 | + /** | |
40 | + * @brief Construct a scoped object that sets the current thread context. | |
41 | + * @param context The context that will be used by the logging framework. | |
42 | + */ | |
43 | + explicit ThreadContextScope(const std::string& context); | |
44 | + ~ThreadContextScope(); | |
45 | + | |
46 | + // Non copyable and non movable | |
47 | + ThreadContextScope(const ThreadContextScope&) = delete; | |
48 | + ThreadContextScope& operator=(const ThreadContextScope&) = delete; | |
49 | + ThreadContextScope(ThreadContextScope&&) = delete; | |
50 | + ThreadContextScope& operator=(ThreadContextScope&&) = delete; | |
51 | + | |
52 | +private: | |
53 | + std::string m_previousContext; ///< Copy of the previous context. | |
54 | +}; | |
55 | + | |
56 | +/** | |
57 | + * @brief Add context to a thread. | |
58 | + * For every thread only one specific instance of this object will exist. | |
59 | + * @note Contexts can only be set by using a ThreadContextScope object. | |
60 | + */ | |
61 | +class ThreadContext | |
62 | +{ | |
63 | + | |
64 | +// Contexts can only be set by using a ThreadContextScope object. | |
65 | +friend class ThreadContextScope; | |
66 | + | |
67 | +public: | |
68 | + static ThreadContext& instance(); | |
69 | + | |
70 | + /** | |
71 | + * @brief Return the thread context. | |
72 | + */ | |
73 | + const std::string& context() const | |
74 | + { | |
75 | + return m_context; | |
76 | + } | |
77 | + | |
78 | +private: | |
79 | + /** | |
80 | + * @brief Set the thread context. | |
81 | + */ | |
82 | + void setContext(const std::string& contextString) | |
83 | + { | |
84 | + m_context = contextString; | |
85 | + } | |
86 | + | |
87 | + /** | |
88 | + * Construct a ThreadContext object. | |
89 | + * The context is set to "default" | |
90 | + */ | |
91 | + ThreadContext(); | |
92 | + | |
93 | + // Non copyable and non movable | |
94 | + ThreadContext(const ThreadContext&) = delete; | |
95 | + ThreadContext& operator=(const ThreadContext&) = delete; | |
96 | + ThreadContext(ThreadContext&&) = delete; | |
97 | + ThreadContext& operator=(ThreadContext&&) = delete; | |
98 | + | |
99 | + std::string m_context; ///< The context string | |
100 | +}; | |
101 | + | |
102 | +} /* End namespace components */ | |
103 | +} /* End namespace osdev */ | |
104 | + | |
105 | +#endif // OSDEV_COMPONENTS_THREADCONTEXT_H | ... | ... |
tests/CMakeLists.txt
0 → 100644
1 | +++ a/tests/CMakeLists.txt | |
1 | +cmake_minimum_required(VERSION 3.12) | |
2 | +LIST(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../cmake) | |
3 | + | |
4 | +include(projectheader) | |
5 | +project_header(test_logger) | |
6 | + | |
7 | +include_directories( SYSTEM | |
8 | + ${CMAKE_CURRENT_SOURCE_DIR}/../src | |
9 | +) | |
10 | + | |
11 | +include(compiler) | |
12 | +set(SRC_LIST | |
13 | + ${CMAKE_CURRENT_SOURCE_DIR}/main.cpp | |
14 | + ${CMAKE_CURRENT_SOURCE_DIR}/logtest.cpp | |
15 | +) | |
16 | + | |
17 | +add_executable( ${PROJECT_NAME} | |
18 | + ${SRC_LIST} | |
19 | +) | |
20 | + | |
21 | +target_link_libraries( | |
22 | + ${PROJECT_NAME} | |
23 | + logger | |
24 | +) | |
25 | + | |
26 | +set_target_properties( ${PROJECT_NAME} PROPERTIES | |
27 | + RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin | |
28 | + LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib | |
29 | + ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/archive | |
30 | +) | |
31 | + | |
32 | +include(installation) | |
33 | +install_application() | ... | ... |
tests/logtest.cpp
0 → 100644
1 | +++ a/tests/logtest.cpp | |
1 | +#include "logtest.h" | |
2 | + | |
3 | +LogTest::LogTest() | |
4 | +{ | |
5 | + | |
6 | +} | |
7 | + | |
8 | +void LogTest::writeTest() | |
9 | +{ | |
10 | + osdev::components::log::Log::setMask( osdev::components::log::LogMask::Upto ); | |
11 | + | |
12 | + LogError ( "testcase", "testing the error message" ); | |
13 | + LogCritical ( "testcase", "testing the critical message" ); | |
14 | + LogAlert ( "testcase", "testing the alert message" ); | |
15 | + LogEmergency( "testcase", "testing the emergency message" ); | |
16 | + | |
17 | + osdev::components::log::Log::setMask( osdev::components::log::LogMask::None ); | |
18 | + | |
19 | + LogDebug ( "testcase", "testing the debug message" ); | |
20 | + LogDebug ( "testcase", "testing a second debug message" ); | |
21 | + LogInfo ( "testcase", "testing the info message" ); | |
22 | + LogNotice ( "testcase", "testing the notice message" ); | |
23 | + LogWarning ( "testcase", "testing the warning message" ); | |
24 | + | |
25 | +} | ... | ... |
tests/logtest.h
0 → 100644