Set the style (color and typo) of the given log level.
+
clutchlog.h
-
Node1
-clutchlog.h
+clutchlog.h
@@ -30,8 +30,8 @@
Node1->Node2
-
@@ -45,8 +45,8 @@
Node1->Node3
-
@@ -60,8 +60,8 @@
Node1->Node4
-
@@ -75,83 +75,98 @@
Node1->Node5
-
Node6
-
-t-demo.cpp
+
+t-demo-extravagant.cpp
Node1->Node6
-
Node7
-
-t-dump.cpp
+
+t-demo.cpp
Node1->Node7
-
Node8
-
-t-fmt-constructors.cpp
+
+t-dump.cpp
Node1->Node8
-
Node9
-
-t-log.cpp
+
+t-fmt-constructors.cpp
Node1->Node9
-
Node10
-
-t-one-line-if.cpp
+
+t-log.cpp
Node1->Node10
-
+
+
+Node11
+
+t-one-line-if.cpp
+
+
+
+
+Node1->Node11
+
diff --git a/docs/clutchlog_8h_source.html b/docs/clutchlog_8h_source.html
index 5de3275..e3c31b4 100644
--- a/docs/clutchlog_8h_source.html
+++ b/docs/clutchlog_8h_source.html
@@ -645,796 +645,810 @@ $(document).ready(function(){initNavTree('clutchlog_8h_source.html',''); initRes
835 {level::debug ,
"Debug" },
836 {level::xdebug ,
"XDebug" }
839 {level::critical,fmt(fmt::fg::red, fmt::typo::underline)},
840 {level::error ,fmt(fmt::fg::red, fmt::typo::bold)},
841 {level::warning ,fmt(fmt::fg::magenta, fmt::typo::bold)},
842 {level::progress,fmt()},
843 {level::note ,fmt()},
844 {level::info ,fmt()},
845 {level::debug ,fmt()},
846 {level::xdebug ,fmt()}
839 {level::critical,
"Crit" },
840 {level::error ,
"Erro" },
841 {level::warning ,
"Warn" },
842 {level::progress,
"Prog" },
843 {level::note ,
"Note" },
844 {level::info ,
"Info" },
845 {level::debug ,
"Dbug" },
846 {level::xdebug ,
"XDbg" }
850 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 852 _hfill_fmt(fmt::fg::none),
857 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 858 _depth(std::numeric_limits<size_t>::max() -
_strip_calls ),
870 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 872 ioctl(STDERR_FILENO, TIOCGWINSZ, &w);
890 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 902 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 849 {level::critical,fmt(fmt::fg::red, fmt::typo::underline)},
850 {level::error ,fmt(fmt::fg::red, fmt::typo::bold)},
851 {level::warning ,fmt(fmt::fg::magenta, fmt::typo::bold)},
852 {level::progress,fmt()},
853 {level::note ,fmt()},
854 {level::info ,fmt()},
855 {level::debug ,fmt()},
856 {level::xdebug ,fmt()}
860 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 862 _hfill_fmt(fmt::fg::none),
867 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 868 _depth(std::numeric_limits<size_t>::max() -
_strip_calls ),
880 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 882 ioctl(STDERR_FILENO, TIOCGWINSZ, &w);
902 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 906 std::string _depth_mark;
917 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 919 static const size_t _max_buffer = 4096;
922 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 948 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 949 void depth(
size_t d) {_depth = d;}
952 size_t depth()
const {
return _depth;}
955 void depth_mark(
const std::string mark) {_depth_mark = mark;}
957 std::string depth_mark()
const {
return _depth_mark;}
964 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1 965 void hfill_mark(
const char mark) {_hfill_char = mark;}
968 char hfill_mark()
const {
return _hfill_char;}
970 void hfill_style(fmt
style ) {_hfill_fmt =
style ;}
975 template <
class ... FMT>
976 void hfill_style(FMT... styles) { this->hfill_style(fmt(styles...)); }
978 fmt hfill_style()
const {
return _hfill_fmt;}
980 void hfill_max(
const size_t nmax) {_hfill_max = nmax;}
982 size_t hfill_max() {
return _hfill_max;}
984 void hfill_min(
const size_t nmin) {_hfill_min = nmin;}
986 size_t hfill_min() {
return _hfill_min;}
1006 return ilevel->second;
1008 throw std::out_of_range(
"'" + name +
"' is not a valid log level name" );
1021 const std::string& in_file,
1022 const std::string& in_function=
".*" ,
1023 const std::string& in_line=
".*" 914 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 918 std::string _depth_mark;
929 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 931 static const size_t _max_buffer = 4096;
934 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 960 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 961 void depth(
size_t d) {_depth = d;}
964 size_t depth()
const {
return _depth;}
967 void depth_mark(
const std::string mark) {_depth_mark = mark;}
969 std::string depth_mark()
const {
return _depth_mark;}
976 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1 977 void hfill_mark(
const char mark) {_hfill_char = mark;}
980 char hfill_mark()
const {
return _hfill_char;}
982 void hfill_style(fmt
style ) {_hfill_fmt =
style ;}
987 template <
class ... FMT>
988 void hfill_style(FMT... styles) { this->hfill_style(fmt(styles...)); }
990 fmt hfill_style()
const {
return _hfill_fmt;}
992 void hfill_max(
const size_t nmax) {_hfill_max = nmax;}
994 size_t hfill_max() {
return _hfill_max;}
996 void hfill_min(
const size_t nmin) {_hfill_min = nmin;}
998 size_t hfill_min() {
return _hfill_min;}
1018 return ilevel->second;
1020 throw std::out_of_range(
"'" + name +
"' is not a valid log level name" );
1035 template <
class ... FMT>
1055 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1033 const std::string& in_file,
1034 const std::string& in_function=
".*" ,
1035 const std::string& in_line=
".*" 1047 template <
class ... FMT>
1067 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1076 const std::string&
file ,
1077 const std::string&
func ,
1085 scope.stage = stage;
1086 if (not (scope.stage <=
_stage )) {
1091 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1095 void *buffer[_max_buffer];
1096 stack_depth = backtrace(buffer, _max_buffer);
1097 scope.depth = stack_depth;
1106 std::ostringstream sline; sline <<
line ;
1110 and std::regex_search(sline.str(),
_in_line );
1113 scope.matches = scope.there;
1126 const std::string& form,
1127 const std::string& mark,
1128 const std::string& tag
1088 const std::string&
file ,
1089 const std::string&
func ,
1097 scope.stage = stage;
1098 if (not (scope.stage <=
_stage )) {
1103 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1107 void *buffer[_max_buffer];
1108 stack_depth = backtrace(buffer, _max_buffer);
1109 scope.depth = stack_depth;
1118 std::ostringstream sline; sline <<
line ;
1122 and std::regex_search(sline.str(),
_in_line );
1125 scope.matches = scope.there;
1138 const std::string& form,
1139 const std::string& mark,
1140 const std::string& tag
1185 const std::regex re(mark);
1186 return std::regex_replace(form, re, tag);
1191 const std::string& form,
1192 const std::string& mark,
1196 std::ostringstream stag; stag << tag;
1197 return replace (form, mark, stag.str());
1203 const std::string& what,
1205 const std::string& name,
1208 const std::string&
file ,
1209 const std::string&
func ,
1217 row =
replace (row,
"\\{msg\\}" , what);
1223 std::string letter(1,
_level_word .at(stage).at(0));
1224 row =
replace (row,
"\\{level_letter\\}" , letter);
1226 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1227 row =
replace (row,
"\\{name\\}" , name);
1230 std::ostringstream chevrons;
1232 chevrons << _depth_mark;
1234 row =
replace (row,
"\\{depth_marks\\}" , chevrons.str());
1239 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 1241 const std::string raw_row =
replace (row,
"\\x1B\\[([0-9]{1,2}(;[0-9]{1,2})?)?[m|K]" ,
"" );
1242 const std::string hfill_tag =
"{hfill}" ;
1243 const size_t hfill_pos = row.find(hfill_tag);
1244 const size_t raw_hfill_pos = raw_row.find(hfill_tag);
1245 const size_t nb_columns = std::max(std::min((
size_t )_nb_columns, _hfill_max), _hfill_min);
1246 if (hfill_pos != std::string::npos) {
1247 assert(raw_hfill_pos != std::string::npos);
1248 if (nb_columns > 0) {
1249 const size_t left_len = raw_hfill_pos;
1250 const size_t right_len = raw_row.size() - raw_hfill_pos - hfill_tag.size();
1251 if (right_len+left_len > nb_columns) {
1253 if (right_len < nb_columns) {
1255 const std::string hfill(std::max((
size_t )0, nb_columns-right_len), _hfill_char);
1256 const std::string hfill_styled = _hfill_fmt(hfill);
1257 row =
replace (row,
"\\{hfill\\}" ,
"\n" +hfill_styled);
1260 const std::string hfill(1, _hfill_char);
1261 const std::string hfill_styled = _hfill_fmt(hfill);
1262 row =
replace (row,
"\\{hfill\\}" ,
"\n" +hfill_styled);
1266 const std::string hfill(std::max((
size_t )0, nb_columns - (right_len+left_len)), _hfill_char);
1267 const std::string hfill_styled = _hfill_fmt(hfill);
1268 row =
replace (row,
"\\{hfill\\}" , hfill_styled);
1272 const std::string hfill(1, _hfill_char);
1273 const std::string hfill_styled = _hfill_fmt(hfill);
1274 row =
replace (row,
"\\{hfill\\}" , hfill_styled);
1279 const std::string hfill(1, _hfill_char);
1280 const std::string hfill_styled = _hfill_fmt(hfill);
1281 row =
replace (row,
"\\{hfill\\}" , hfill_styled);
1289 const std::string& what,
1290 const std::string&
file ,
const std::string&
func ,
size_t line 1296 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1299 line , scope.depth );
1314 const In container_begin,
const In container_end,
1315 const std::string&
file ,
const std::string&
func ,
size_t line ,
1316 const std::string& filename_template =
"dump_{n}.dat" ,
1323 const std::string tag =
"\\{n\\}" ;
1324 const std::regex re(tag);
1325 std::string outfile =
"" ;
1328 if (std::regex_search(filename_template, re)) {
1332 outfile =
replace (filename_template, tag, n);
1334 }
while ( fs::exists( outfile ) );
1197 const std::regex re(mark);
1198 return std::regex_replace(form, re, tag);
1203 const std::string& form,
1204 const std::string& mark,
1208 std::ostringstream stag; stag << tag;
1209 return replace (form, mark, stag.str());
1215 const std::string& what,
1217 const std::string& name,
1220 const std::string&
file ,
1221 const std::string&
func ,
1229 row =
replace (row,
"\\{msg\\}" , what);
1235 std::string letter(1,
_level_word .at(stage).at(0));
1236 row =
replace (row,
"\\{level_letter\\}" , letter);
1240 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1241 row =
replace (row,
"\\{name\\}" , name);
1244 std::ostringstream chevrons;
1246 chevrons << _depth_mark;
1248 row =
replace (row,
"\\{depth_marks\\}" , chevrons.str());
1253 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL 1255 const std::string raw_row =
replace (row,
"\\x1B\\[([0-9]{1,2}(;[0-9]{1,2})?)?[m|K]" ,
"" );
1256 const std::string hfill_tag =
"{hfill}" ;
1257 const size_t hfill_pos = row.find(hfill_tag);
1258 const size_t raw_hfill_pos = raw_row.find(hfill_tag);
1259 const size_t nb_columns = std::max(std::min((
size_t )_nb_columns, _hfill_max), _hfill_min);
1260 if (hfill_pos != std::string::npos) {
1261 assert(raw_hfill_pos != std::string::npos);
1262 if (nb_columns > 0) {
1263 const size_t left_len = raw_hfill_pos;
1264 const size_t right_len = raw_row.size() - raw_hfill_pos - hfill_tag.size();
1265 if (right_len+left_len > nb_columns) {
1267 if (right_len < nb_columns) {
1269 const std::string hfill(std::max((
size_t )0, nb_columns-right_len), _hfill_char);
1270 const std::string hfill_styled = _hfill_fmt(hfill);
1271 row =
replace (row,
"\\{hfill\\}" ,
"\n" +hfill_styled);
1274 const std::string hfill(1, _hfill_char);
1275 const std::string hfill_styled = _hfill_fmt(hfill);
1276 row =
replace (row,
"\\{hfill\\}" ,
"\n" +hfill_styled);
1280 const std::string hfill(std::max((
size_t )0, nb_columns - (right_len+left_len)), _hfill_char);
1281 const std::string hfill_styled = _hfill_fmt(hfill);
1282 row =
replace (row,
"\\{hfill\\}" , hfill_styled);
1286 const std::string hfill(1, _hfill_char);
1287 const std::string hfill_styled = _hfill_fmt(hfill);
1288 row =
replace (row,
"\\{hfill\\}" , hfill_styled);
1293 const std::string hfill(1, _hfill_char);
1294 const std::string hfill_styled = _hfill_fmt(hfill);
1295 row =
replace (row,
"\\{hfill\\}" , hfill_styled);
1303 const std::string& what,
1304 const std::string&
file ,
const std::string&
func ,
size_t line 1310 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1313 line , scope.depth );
1328 const In container_begin,
const In container_end,
1329 const std::string&
file ,
const std::string&
func ,
size_t line ,
1330 const std::string& filename_template =
"dump_{n}.dat" ,
1338 outfile = filename_template;
1337 const std::string tag =
"\\{n\\}" ;
1338 const std::regex re(tag);
1339 std::string outfile =
"" ;
1341 std::ofstream fd(outfile);
1344 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1347 line , scope.depth );
1356 std::copy(container_begin, container_end,
1357 std::ostream_iterator<typename In::value_type>(fd, sep.c_str()));
1368 #else // not WITH_CLUTCHLOG 1342 if (std::regex_search(filename_template, re)) {
1346 outfile =
replace (filename_template, tag, n);
1348 }
while ( fs::exists( outfile ) );
1352 outfile = filename_template;
1355 std::ofstream fd(outfile);
1358 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1361 line , scope.depth );
1377 #pragma GCC diagnostic push 1378 #pragma GCC diagnostic ignored "-Wreturn-type" 1383 enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
1387 enum class typo { reset, bold, underline, inverse, none}
style ;
1388 enum class fg { black, red, green, yellow, blue, magenta, cyan, white, bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white, none}
fore ;
1389 enum class bg { black, red, green, yellow, blue, magenta, cyan, white, bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white, none }
back ;
1391 friend std::ostream&
operator<< (std::ostream&,
const std::tuple<fg,bg,typo>&) {}
1398 virtual bool is_set ()
const = 0;
1399 virtual std::ostream&
print_on ( std::ostream&)
const = 0;
1402 struct color_256 :
public color {
1407 std::ostream&
print_on ( std::ostream&)
const {}
1409 struct fg_256 :
public color_256 {
1414 struct bg_256 :
public color_256 {
1419 struct color_16M :
public color {
1420 short red , green, blue;
1424 bool is_set ()
const {
return red > -1 and green > -1 and blue > -1;}
1425 std::ostream&
print_on ( std::ostream&)
const {}
1427 struct fg_16M :
public color_16M {
1433 struct bg_16M :
public color_16M {
1450 fmt (
const short fr,
const short fg ,
const short fb,
1451 const short gr,
const short gg,
const short gb,
1452 typo s = typo::none)
1455 const short gr,
const short gg,
const short gb,
1456 typo s = typo::none)
1458 fmt (
const short fr,
const short fg ,
const short fb,
1461 fmt (
const short fr,
const short fg ,
const short fb,
1462 typo s = typo::none)
1465 fmt (
const std::string& f,
const std::string& b,
typo s = typo::none)
1467 fmt (
fg ,
const std::string& b,
typo s = typo::none)
1469 fmt (
const std::string& f,
bg ,
typo s = typo::none)
1471 fmt (
const std::string& f,
typo s = typo::none)
1474 std::ostream&
print_on ( std::ostream&)
const {}
1476 friend std::ostream&
operator<< (std::ostream&,
const fmt &) {}
1477 std::string
operator() (
const std::string&)
const {}
1478 std::string
str ()
const {}
1482 void operator=(
clutchlog const &) =
delete ;
1370 std::copy(container_begin, container_end,
1371 std::ostream_iterator<typename In::value_type>(fd, sep.c_str()));
1382 #else // not WITH_CLUTCHLOG 1391 #pragma GCC diagnostic push 1392 #pragma GCC diagnostic ignored "-Wreturn-type" 1397 enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
1401 enum class typo { reset, bold, underline, inverse, none}
style ;
1402 enum class fg { black, red, green, yellow, blue, magenta, cyan, white, bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white, none}
fore ;
1403 enum class bg { black, red, green, yellow, blue, magenta, cyan, white, bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white, none }
back ;
1405 friend std::ostream&
operator<< (std::ostream&,
const std::tuple<fg,bg,typo>&) {}
1412 virtual bool is_set ()
const = 0;
1413 virtual std::ostream&
print_on ( std::ostream&)
const = 0;
1416 struct color_256 :
public color {
1421 std::ostream&
print_on ( std::ostream&)
const {}
1423 struct fg_256 :
public color_256 {
1428 struct bg_256 :
public color_256 {
1433 struct color_16M :
public color {
1434 short red , green, blue;
1438 bool is_set ()
const {
return red > -1 and green > -1 and blue > -1;}
1439 std::ostream&
print_on ( std::ostream&)
const {}
1441 struct fg_16M :
public color_16M {
1447 struct bg_16M :
public color_16M {
1464 fmt (
const short fr,
const short fg ,
const short fb,
1465 const short gr,
const short gg,
const short gb,
1466 typo s = typo::none)
1469 const short gr,
const short gg,
const short gb,
1470 typo s = typo::none)
1472 fmt (
const short fr,
const short fg ,
const short fb,
1475 fmt (
const short fr,
const short fg ,
const short fb,
1476 typo s = typo::none)
1479 fmt (
const std::string& f,
const std::string& b,
typo s = typo::none)
1481 fmt (
fg ,
const std::string& b,
typo s = typo::none)
1483 fmt (
const std::string& f,
bg ,
typo s = typo::none)
1485 fmt (
const std::string& f,
typo s = typo::none)
1488 std::ostream&
print_on ( std::ostream&)
const {}
1490 friend std::ostream&
operator<< (std::ostream&,
const fmt &) {}
1491 std::string
operator() (
const std::string&)
const {}
1492 std::string
str ()
const {}
1495 void format (
const std::string&) {}
1496 std::string
format ()
const {}
1501 void out (std::ostream&) {}
1502 std::ostream&
out () {}
1504 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1505 void depth(
size_t ) {}
1506 size_t depth()
const {}
1508 void depth_mark(
const std::string) {}
1509 std::string depth_mark()
const {}
1510 void strip_calls(
const size_t ) {}
1511 size_t strip_calls()
const {}
1513 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1 1514 void hfill_mark(
const char ) {}
1515 char hfill_mark()
const {}
1516 void hfill_fmt(fmt) {}
1517 fmt hfill_fmt()
const {}
1518 void hfill_min(
const size_t ) {}
1519 size_t hfill_min() {}
1520 void hfill_max(
const size_t ) {}
1521 size_t hfill_max() {}
1527 const std::map<std::string,level>
levels ()
const {}
1530 void file (std::string) {}
1531 void func (std::string) {}
1532 void line (std::string) {}
1534 #pragma GCC diagnostic push 1535 #pragma GCC diagnostic ignored "-Wunused-parameter" 1538 const std::string& in_function=
".*" ,
1539 const std::string& in_line=
".*" 1542 #pragma GCC diagnostic pop 1543 template <
class ... FMT>
1496 void operator=(
clutchlog const &) =
delete ;
1509 void format (
const std::string&) {}
1510 std::string
format ()
const {}
1515 void out (std::ostream&) {}
1516 std::ostream&
out () {}
1518 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 1519 void depth(
size_t ) {}
1520 size_t depth()
const {}
1522 void depth_mark(
const std::string) {}
1523 std::string depth_mark()
const {}
1524 void strip_calls(
const size_t ) {}
1525 size_t strip_calls()
const {}
1527 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1 1528 void hfill_mark(
const char ) {}
1529 char hfill_mark()
const {}
1530 void hfill_fmt(fmt) {}
1531 fmt hfill_fmt()
const {}
1532 void hfill_min(
const size_t ) {}
1533 size_t hfill_min() {}
1534 void hfill_max(
const size_t ) {}
1535 size_t hfill_max() {}
1541 const std::map<std::string,level>
levels ()
const {}
1544 void file (std::string) {}
1545 void func (std::string) {}
1546 void line (std::string) {}
1548 #pragma GCC diagnostic push 1549 #pragma GCC diagnostic ignored "-Wunused-parameter" 1552 const std::string& in_function=
".*" ,
1553 const std::string& in_line=
".*" 1556 #pragma GCC diagnostic pop 1557 template <
class ... FMT>
1582 const std::string&,
const std::string&,
size_t 1590 const std::string&,
const std::string&,
size_t ,
1596 #pragma GCC diagnostic pop 1597 #endif // WITH_CLUTCHLOG 1599 #endif // CLUTCHLOG_H 1596 const std::string&,
const std::string&,
size_t 1604 const std::string&,
const std::string&,
size_t ,
1610 #pragma GCC diagnostic pop 1611 #endif // WITH_CLUTCHLOG 1613 #endif // CLUTCHLOG_H friend std::ostream & operator<<(std::ostream &os, const std::tuple< fg, bg, typo > &fbs)
Output stream operator for a 3-tuple of 16-colors mode tags.
static std::string default_depth_mark
Default mark for stack depth.
std::string _format_log
Current format of the standard output.
std::string _format_log
Current format of the standard output.
color_16M(ground t, const std::string &srgb)
Hex triplet string constructor.
std::map< level, fmt > _level_fmt
Dictionary of level identifier to their format.
void log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
Print a log message IF the location matches the given one.
std::map< level, fmt > _level_fmt
Dictionary of level identifier to their format.
void log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
Print a log message IF the location matches the given one.
enum clutchlog::fmt::bg back
Background color.
std::string str() const
Return the formatting code as a string.
Foreground in 256-colors mode.
void line(std::string line)
Set the regular expression filtering the line location.
void line(std::string line)
Set the regular expression filtering the line location.
friend std::ostream & operator<<(std::ostream &os, const color &c)
Print the actually encoded escaped color sequence on the given stream.
friend std::ostream & operator<<(std::ostream &os, const typo &s)
Output stream operator for a typo tag alone, in 16-colors mode.
static std::string dump_default_format
Default format of the comment line in file dump.
void out(std::ostream &out)
Set the output stream on which to print.
void out(std::ostream &out)
Set the output stream on which to print.
bool is_set() const
Returns true if the underying representation encodes an existing color.
fg_16M(const fg &)
Conversion constructor from 16-colors mode.
static std::string dump_default_sep
Default item separator for dump.
std::string format(std::string row, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const
Substitute all tags in the format string with the corresponding information and apply the style corre...
std::string format(std::string row, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const
Substitute all tags in the format string with the corresponding information and apply the style corre...
Background in 256-colors mode.
#define CLUTCHLOG_DEFAULT_DEPTH_MARK
Compile-time default mark for stack depth.
static unsigned int default_strip_calls
Number of call stack levels to remove from depth display by default.
static size_t default_hfill_min
Default minimum width (number of characters) at which to fill for right-aligning the right part of me...
std::string replace(const std::string &form, const std::string &mark, const std::string &tag) const
Replace mark by tag in form.
std::string replace(const std::string &form, const std::string &mark, const std::string &tag) const
Replace mark by tag in form.
color_256(ground t)
Constructor.
clutchlog::fmt::bg_16M back_16M
Current background in 16M-colors mode.
Interface class for colors representation.
@ colors_16
16 colors mode.
background in 256-colors mode.
static char default_hfill_char
Default character used as a filling for right-align the right part of messages with "{hfill}".
bool matches
Everything is compatible.
bool matches
Everything is compatible.
enum clutchlog::fmt::typo style
Typographic style.
Abstract base class for 16M colors objects (24-bits ANSI).
fg_256(const fg &)
Conversion constructor from 16-colors mode.
void format_comment(const std::string &format)
Set the template string for dumps.
void format_comment(const std::string &format)
Set the template string for dumps.
bg_16M(const std::string &srgb)
Hex triplet string constructor.
void file(std::string file)
Set the regular expression filtering the file location.
scope_t locate(const level &stage, const std::string &file, const std::string &func, const size_t line) const
Gather information on the current location of the call.
void file(std::string file)
Set the regular expression filtering the file location.
scope_t locate(const level &stage, const std::string &file, const std::string &func, const size_t line) const
Gather information on the current location of the call.
clutchlog::fmt::fg_16M fore_16M
Current foreground in 16M-colors mode.
Abstract base class for 256 colors objects (8-bits ANSI).
fmt()
Empty constructor, only useful for a no-op formatter.
void style(level stage, fmt style)
Set the style (color and typo) of the given log level, passing a fmt instance.
void threshold(level l)
Set the log level (below which logs are not printed) with an identifier.
level threshold() const
Get the log level below which logs are not printed.
void style(level stage, fmt style)
Set the style (color and typo) of the given log level, passing a fmt instance.
void threshold(level l)
Set the log level (below which logs are not printed) with an identifier.
level threshold() const
Get the log level below which logs are not printed.
virtual bool is_set() const =0
Should return true if the underying representation encodes an existing color.
std::map< level, std::string > _level_short
dictionary of level identifier to their 4-letters representation.
level
Available log levels.
color_256(ground t, const short i)
Constructor.
std::ostream & print_on(std::ostream &os) const
Print the color index on the given stream.
color_16M(ground t)
Constructor.
static size_t default_hfill_max
Default maximum width (number of characters) for which to fill for right-aligning the right part of m...
std::regex _in_func
Current function location filter.
std::regex _in_func
Current function location filter.
static std::string default_format
Default format of the messages.
bg_16M(short r, short g, short b)
Numeric triplet constructor.
static clutchlog & logger()
Get the logger instance.
Foreground in 256-colors mode.
void dump(const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=dump_default_sep) const
Dump a serializable container after a comment line with log information.
void dump(const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=dump_default_sep) const
Dump a serializable container after a comment line with log information.
clutchlog::fmt::fg_256 fore_256
Current foreground in 256-colors mode.
enum clutchlog::fmt::fg fore
Foreground color.
enum clutchlog::fmt::color::ground type
Type of color (foreground or background).
Color and style formatter for ANSI terminal escape sequences.
short index
The encoded color index in 4-bits ANSI.
bg_256()
Empty constructor: no color.
void func(std::string func)
Set the regular expression filtering the function location.
std::string format() const
Get the template string.
std::regex _in_file
Current file location filter.
void style(level stage, FMT... styles)
Set the style (color and typo) of the given log level.
void func(std::string func)
Set the regular expression filtering the function location.
std::string format() const
Get the template string.
std::regex _in_file
Current file location filter.
void style(level stage, FMT... styles)
Set the style (color and typo) of the given log level.
bg_256(const bg &)
Conversion constructor from 16-colors mode.
fg_16M()
Empty constructor: no color.
level level_of(const std::string name)
Return the log level tag corresponding to the given pre-configured name.
const std::map< level, std::string > _level_word
Dictionary of level identifier to their string representation.
level level_of(const std::string name)
Return the log level tag corresponding to the given pre-configured name.
const std::map< level, std::string > _level_word
Dictionary of level identifier to their string representation.
std::string operator()(const std::string &msg) const
Format the given string with the currently encoded format.
color_16M(ground t, short r, short g, short b)
Numeric triplet constructor.
std::ostream & print_on(std::ostream &os) const
Print the color RGB triplet on the given stream.
bg
Background color codes.
#define CLUTCHLOG_DEFAULT_FORMAT
Compile-time default format of the messages (debug mode: with absolute location).
std::regex _in_line
Current line location filter.
std::regex _in_line
Current line location filter.
fg_256(const short f)
Constructor.
@ colors_256
256 colors mode.
enum clutchlog::fmt::ansi mode
Current ANSI color mode.
std::string replace(const std::string &form, const std::string &mark, const size_t tag) const
Replace mark by tag in form, converting tag to its string representation first.
std::string format_comment() const
Get the template string for dumps.
std::string replace(const std::string &form, const std::string &mark, const size_t tag) const
Replace mark by tag in form, converting tag to its string representation first.
std::string format_comment() const
Get the template string for dumps.
fg_256()
Empty constructor: no color.
@ colors_16M
16 millions ("true") colors mode.
std::string _format_dump
Current format of the file output.
std::string _format_dump
Current format of the file output.
#define CLUTCHDUMP_DEFAULT_SEP
Compile-time default item separator for dump.
bg_256(const short b)
Constructor.
ground
Codes for representing foreground or background.
Structure holding a location matching.
Structure holding a location matching.
#define CLUTCHLOG_DEFAULT_HFILL_MARK
Character used as a filling for right-align the right part of messages with "{hfill}".
std::ostream & print_on(std::ostream &os) const
Print the currently encoded format escape code on the given output stream.
bool is_set() const
Returns true if the underying representation encodes an existing color.
std::ostream * _out
Standard output.
std::ostream & out()
Get the output stream on which to print.
void threshold(const std::string &l)
Set the log level (below which logs are not printed) with a string.
std::ostream * _out
Standard output.
std::ostream & out()
Get the output stream on which to print.
void threshold(const std::string &l)
Set the log level (below which logs are not printed) with a string.
virtual std::ostream & print_on(std::ostream &os) const =0
Should print the underlying representation on the given stream.
const std::map< std::string, level > & levels() const
Get the map of available log levels string representations toward their identifier....
size_t _strip_calls
Current number of call stack levels to remove from depth display.
level stage
Current log level.
bool there
Location is compatible.
const std::map< std::string, level > & levels() const
Get the map of available log levels string representations toward their identifier....
size_t _strip_calls
Current number of call stack levels to remove from depth display.
level stage
Current log level.
bool there
Location is compatible.
fg_16M(const std::string &srgb)
Hex triplet string constructor.
#define CLUTCHLOG_STRIP_CALLS
Compile-time number of call stack levels to remove from depth display by default.
friend std::ostream & operator<<(std::ostream &os, const fmt &fmt)
Output stream overload.
bg_16M(const bg &)
Conversion constructor from 16-colors mode.
bg_16M()
Empty constructor: no color.
std::map< std::string, level > _word_level
Dictionary of level string to their identifier.
level _stage
Current log level.
fmt style(level stage) const
Get the configured fmt instance of the given log level.
std::map< std::string, level > _word_level
Dictionary of level string to their identifier.
level _stage
Current log level.
fmt style(level stage) const
Get the configured fmt instance of the given log level.
typo
Typographic style codes.
void location(const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")
Set the regular expressions filtering the location.
void location(const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")
Set the regular expressions filtering the location.
#define CLUTCHLOG_HAVE_UNIX_SYSINFO
True if POSIX headers necessary for stack depth management are available.
The single class which holds everything.
ansi
ANSI code configuring the available number of colors.
-
tests → clutchlog Relation tests → clutchlog Relation
diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html
index 6e36d3a..a7a9646 100644
--- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html
+++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html
@@ -93,7 +93,8 @@ $(document).ready(function(){initNavTree('dir_59425e443f801f1f2fd8bbe4959a3ccf.h
diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5
index 02d5eb8..1c6fad9 100644
--- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5
+++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5
@@ -1 +1 @@
-898e9fe86e58c83c8b2acb43f3d5c59b
\ No newline at end of file
+85501d07f252f4cafc04b7ed02612fff
\ No newline at end of file
diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.svg b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.svg
index 0a914a4..791a1a5 100644
--- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.svg
+++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.svg
@@ -32,8 +32,8 @@
dir_59425e443f801f1f2fd8bbe4959a3ccf->dir_c318bd5cf14aaa5601e6029e0b5b4048
-9
+
+10
t-color.cpp t-color16M.cpp t-color256.cpp t-demo.cpp t-dump.cpp t-fmt-constructors.cpp t-log.cpp t-one-line-if.cpp t-demo-extravagant.cpp t-demo.cpp t-dump.cpp t-fmt-constructors.cpp t-log.cpp t-one-line-if.cpp _level_fmt
: clutchlog
+_level_short
+: clutchlog
+
_level_word
: clutchlog
diff --git a/docs/functions_vars.html b/docs/functions_vars.html
index 3c355d7..189a389 100644
--- a/docs/functions_vars.html
+++ b/docs/functions_vars.html
@@ -105,6 +105,9 @@ $(document).ready(function(){initNavTree('functions_vars.html',''); initResizabl
_level_fmt
: clutchlog
+_level_short
+: clutchlog
+
_level_word
: clutchlog
diff --git a/docs/group___main.js b/docs/group___main.js
index 21f8906..f4cc55e 100644
--- a/docs/group___main.js
+++ b/docs/group___main.js
@@ -51,6 +51,7 @@ var group___main =
[ "_strip_calls", "classclutchlog.html#a356df86455409193792b6ed550dfd09e", null ],
[ "_level_word", "classclutchlog.html#ab1c377a376e6772fe1746ff7147c125f", null ],
[ "_word_level", "classclutchlog.html#abd4625bf211bfbaa30d9c126fa3d7888", null ],
+ [ "_level_short", "classclutchlog.html#a08e8a817a75a4e9f0159231c941e0dae", null ],
[ "_level_fmt", "classclutchlog.html#ab805ac5c33885459f9f752518a4aa735", null ],
[ "_format_log", "classclutchlog.html#a7c6e3fc082bc6f55d50131ed2b32e81e", null ],
[ "_format_dump", "classclutchlog.html#a5f4ddb57ce42e8be86a7c7d269f7bae5", null ],
diff --git a/docs/index.html b/docs/index.html
index 38f626a..78e4023 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -159,7 +159,9 @@ Example
log.threshold("Info" );
log.file("algebra/.*" );
log.func("(mul|add|sub|div)" );
-For more detailled examples, see the "Usage" sections below and the tests directory.
+Example of a real-life log session (as seen in the frictionlesser software):
+Demo showing fancy styling:
+For more detailled examples, see the "Usage" sections below and the tests directory.
Most of existing logging systems targets service events storage, like fast queuing of transactions in a round-robin database. Their aim is to provide a simple interface to efficiently store messages somewhere, which is appropriated when you have a well known service running and you want to be able to trace complex users interactions across its states.
@@ -224,6 +226,7 @@ Output Configuration
{msg}: the logged message,{level}: the current log level (i.e. Critical, Error, Warning, Progress, Note, Info, Debug or XDebug),{level_letter}: the first letter of the current log level,{level_short}: the current log level, printed in only four letters,{file}: the current file (absolute path),{func}: the current function,{line}: the current line number,Structure holding a location matching.
-
Definition at line 1050 of file clutchlog.h .
+
Definition at line 1062 of file clutchlog.h .
clutchlog: t-demo-extravagant.cpp Source File
+
+
+
+
+
+
+ clutchlog
+ 0.13
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
3 #include "../clutchlog/clutchlog.h"
+
+
+
+
7 CLUTCHLOG (progress,
"Reset data structures..." );
+
+
+
10 CLUTCHLOG (critical,
"Impossible to reset, I cannot recover." );
+
+
+
+
+
15 CLUTCHLOG (note,
"Filling up data of size: " << 0);
+
16 CLUTCHLOG (error,
"Cannot parse input, I will reset stuff." );
+
+
18 CLUTCHLOG (xdebug,
"Last seen state: " << 0);
+
+
+
+
+
+
+
+
+
+
+
29 CLUTCHLOG (progress,
"Initialize data structures..." );
+
+
31 CLUTCHLOG (progress,
"Initialize functors..." );
+
+
+
+
+
36 int main(
const int argc,
char * argv[])
+
+
+
+
+
+
+
+
+
+
46 log.style(level::critical, 197);
+
47 log.style(level::error, 202);
+
48 log.style(level::warning, 208);
+
49 log.style(level::progress, 34);
+
50 log.style(level::note, 35);
+
51 log.style(level::info, 36);
+
52 log.style(level::debug, 39);
+
53 log.style(level::xdebug, 45);
+
54 std::ostringstream format;
+
55 fmt reset(typo::reset);
+
56 fmt discreet(fg::black);
+
57 fmt bold(fmt::typo::bold);
+
+
+
+
+
+
+
64 const short dark = 238;
+
65 const short lite = 250;
+
+
+
68 << fmt(dark,lite) <<
"{name}"
+
69 << fmt(lite,dark) <<
""
+
70 << fmt(fg::none,dark) <<
"{level_fmt}" <<
" {level_short} " << reset
+
71 << fmt(dark,bg::none) <<
"" << reset
+
72 << fmt(dark,bg::none) <<
"{depth_marks}" << reset
+
+
+
75 << discreet(
" {hfill} " )
+
76 << fmt(dark,bg::none) <<
""
+
77 << fmt(fg::none,dark) <<
"{level_fmt} {func} "
+
78 << fmt(lite,dark) <<
""
+
79 << fmt(dark,lite) <<
"{file}" << reset
+
80 << fmt(dark,lite) <<
""
+
81 << fmt(lite,dark) <<
"{line}" << reset
+
+
83 log.format(format.str());
+
+
+
+
+
+
89 CLUTCHLOG (warning,
"Log level not indicated, will default to xdebug" );
+
90 log.threshold(level::xdebug);
+
+
+
93 log.threshold(log.level_of(argv[1]));
+
94 }
catch (std::out_of_range& err) {
+
+
+
+
+
+
+
+
+
+
+
+
level
Available log levels.
static clutchlog & logger()
Get the logger instance.
Color and style formatter for ANSI terminal escape sequences.
bg
Background color codes.
#define CLUTCHLOG(LEVEL, WHAT)
Log a message at the given level.
typo
Typographic style codes.
fg
Foreground color codes.
+
+ tests t-demo-extravagant.cpp
+
+
+#include "../clutchlog/clutchlog.h"
+
+void i()
+{
+ CLUTCHLOG(progress, "Reset data structures...");
+ CLUTCHLOG(debug, "OK");
+ CLUTCHLOG(info, "Reset functors...");
+ CLUTCHLOG(critical, "Impossible to reset, I cannot recover.");
+}
+
+void h()
+{
+ CLUTCHLOG(note, "Filling up data of size: " << 0);
+ CLUTCHLOG(error, "Cannot parse input, I will reset stuff.");
+ i();
+ CLUTCHLOG(xdebug, "Last seen state: " << 0);
+}
+
+void g()
+{
+ CLUTCHLOG(warning, "Input size < " << 1);
+ h();
+}
+
+void f()
+{
+ CLUTCHLOG(progress, "Initialize data structures...");
+ CLUTCHLOG(debug, "OK");
+ CLUTCHLOG(progress, "Initialize functors...");
+ CLUTCHLOG(debug, "OK");
+ g();
+}
+
+int main(const int argc, char* argv[])
+{
+ using level = clutchlog::level;
+ using fmt = clutchlog::fmt;
+ using fg = clutchlog::fmt::fg;
+ using bg = clutchlog::fmt::bg;
+ using typo = clutchlog::fmt::typo;
+
+ auto& log = clutchlog::logger();
+
+ log.style(level::critical, 197);
+ log.style(level::error, 202);
+ log.style(level::warning, 208);
+ log.style(level::progress, 34);
+ log.style(level::note, 35);
+ log.style(level::info, 36);
+ log.style(level::debug, 39);
+ log.style(level::xdebug, 45);
+ std::ostringstream format;
+ fmt reset(typo::reset);
+ fmt discreet(fg::black);
+ fmt bold(fmt::typo::bold);
+
+ log.depth_mark("| ");
+ log.hfill_min(400);
+ log.hfill_max(500);
+ log.hfill_mark('-');
+
+ const short dark = 238;
+ const short lite = 250;
+
+ format
+ << fmt(dark,lite) << "{name}"
+ << fmt(lite,dark) << ""
+ << fmt(fg::none,dark) << "{level_fmt}" << " {level_short} " << reset
+ << fmt(dark,bg::none) << "" << reset
+ << fmt(dark,bg::none) << "{depth_marks}" << reset
+ << "{level_fmt}"
+ << bold("{msg}")
+ << discreet(" {hfill} ")
+ << fmt(dark,bg::none) << ""
+ << fmt(fg::none,dark) << "{level_fmt} {func} "
+ << fmt(lite,dark) << ""
+ << fmt(dark,lite) << "{file}" << reset
+ << fmt(dark,lite) << ""
+ << fmt(lite,dark) << "{line}" << reset
+ << "\n";
+ log.format(format.str());
+
+ log.out(std::clog);
+ log.strip_calls(4);
+
+ if(argc <= 2) {
+ CLUTCHLOG(warning, "Log level not indicated, will default to xdebug");
+ log.threshold(level::xdebug);
+ } else {
+ try {
+ log.threshold(log.level_of(argv[1]));
+ } catch(std::out_of_range& err) {
+ CLUTCHLOG(critical,err.what());
+ exit(100);
+ }
+ }
+
+ CLUTCHLOG(progress,"Start something");
+ f();
+ CLUTCHLOG(progress,"I have stopped");
+}
+