pattern_layout_test.cxx 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332
  1. //
  2. // pattern_layout_test.cxx
  3. // logger_test
  4. //
  5. // Created by Sam Jaffe on 4/13/19.
  6. //
  7. #include <thread>
  8. #include <gmock/gmock.h>
  9. #include "resource_factory/prototype_factory.hpp"
  10. #include "logger/detail/data_accessors.h"
  11. #include "logger/detail/layout.h"
  12. #include "logger/exception.h"
  13. #include "logger/log_manager.h"
  14. #include "logger/logpacket.h"
  15. #include "logger/properties.h"
  16. // Thursday, April 4, 2019 6:17:20 PM GMT
  17. namespace {
  18. constexpr const int NOW = 1554401840;
  19. }
  20. std::shared_ptr<logging::layout> GetPatternLayout(std::string const & fmt) {
  21. using namespace logging;
  22. using namespace logging::property;
  23. properties props{_obj({{"pattern", _v(fmt)}})};
  24. return layouts::instance().get("PatternLayout", props);
  25. }
  26. std::string DoFormat(std::string const & fmt, logging::logpacket const & pkt) {
  27. std::stringstream ss;
  28. GetPatternLayout(fmt)->format(ss, pkt);
  29. return ss.str();
  30. }
  31. using namespace logging;
  32. logpacket getpkt(std::string const & msg, location_info info = {}) {
  33. return logpacket{{}, level::error, info, "UNIT_TEST", msg};
  34. };
  35. TEST(PatternLayoutTest, EmptyFormatterCanParse) {
  36. EXPECT_NO_THROW(GetPatternLayout(""));
  37. }
  38. TEST(PatternLayoutTest, ThrowsForEndOfStringAfterPct) {
  39. EXPECT_THROW(GetPatternLayout("%"), logging::format_parsing_exception);
  40. }
  41. TEST(PatternLayoutTest, RawStringFmtReturnsSelf) {
  42. using testing::Eq;
  43. EXPECT_THAT(DoFormat("TEST STRING", {}), Eq("TEST STRING"));
  44. }
  45. TEST(PatternLayoutTest, NCharReturnsNewLine) {
  46. using testing::Eq;
  47. EXPECT_THAT(DoFormat("%n", {}), Eq("\n"));
  48. }
  49. TEST(PatternLayoutTest, DoublePctIsLiteral) {
  50. using testing::Eq;
  51. EXPECT_THAT(DoFormat("%%", {}), Eq("%"));
  52. }
  53. TEST(PatternLayoutTest, CatchesRawContentBeforeFmt) {
  54. using testing::Eq;
  55. EXPECT_THAT(DoFormat("TEST%%", {}), Eq("TEST%"));
  56. }
  57. TEST(PatternLayoutTest, CatchesRawContentAfterFmt) {
  58. using testing::Eq;
  59. EXPECT_THAT(DoFormat("%%TEST", {}), Eq("%TEST"));
  60. }
  61. TEST(PatternLayoutTest, HandlesDateFormatter) {
  62. using testing::Eq;
  63. EXPECT_THAT(DoFormat("%d", {{NOW, 0}}), Eq("2019-04-04 18:17:20,000"));
  64. }
  65. TEST(PatternLayoutTest, FormatsMilliseconds) {
  66. using testing::Eq;
  67. EXPECT_THAT(DoFormat("%d", {{NOW, 123000}}), Eq("2019-04-04 18:17:20,123"));
  68. }
  69. TEST(PatternLayoutTest, ThrowsIfCustomFmtUnterminated) {
  70. using testing::Eq;
  71. EXPECT_THROW(GetPatternLayout("%d{%"), logging::format_parsing_exception);
  72. }
  73. TEST(PatternLayoutTest, SupportsCustomFormatWithBrace) {
  74. using testing::Eq;
  75. EXPECT_THAT(DoFormat("%d{%Y}", {{NOW, 0}}), Eq("2019"));
  76. }
  77. TEST(PatternLayoutTest, FormatsCustomMilliseconds) {
  78. using testing::Eq;
  79. EXPECT_THAT(DoFormat("%d{%_ms}", {{NOW, 123000}}), Eq("123"));
  80. }
  81. MATCHER(IsTimeZoneOffsetLike, "") {
  82. if (arg[0] != '+' && arg[0] != '-') {
  83. (*result_listener) << "A timezone should be +/- hhmm";
  84. return false;
  85. }
  86. int const hours = std::stoi(arg.substr(1, 2));
  87. int const minutes = std::stoi(arg.substr(3, 2));
  88. return hours <= 12 && minutes < 60;
  89. }
  90. TEST(PatternLayoutTest, FormatsTimeZone) {
  91. EXPECT_THAT(DoFormat("%d{%z}", {{NOW, 0}}), IsTimeZoneOffsetLike());
  92. }
  93. TEST(PatternLayoutTest, SupportsISO8601Format) {
  94. using testing::Eq;
  95. EXPECT_THAT(DoFormat("%d{ISO8601}", {{NOW, 0}}),
  96. Eq("2019-04-04T18:17:20.000Z"));
  97. }
  98. TEST(PatternLayoutTest, SupportsSingleDayFormat) {
  99. using testing::Eq;
  100. EXPECT_THAT(DoFormat("%d{ABSOLUTE}", {{NOW, 0}}), Eq("18:17:20,000"));
  101. }
  102. TEST(PatternLayoutTest, SupportsHumanDateFormat) {
  103. using testing::Eq;
  104. EXPECT_THAT(DoFormat("%d{DATE}", {{NOW, 0}}), Eq("04 Apr 2019 18:17:20,000"));
  105. }
  106. TEST(PatternLayoutTest, LoggerIdIsCToken) {
  107. using testing::Eq;
  108. EXPECT_THAT(DoFormat("%c", getpkt("HELLO")), Eq("UNIT_TEST"));
  109. }
  110. TEST(PatternLayoutTest, LogLevelIsPToken) {
  111. using testing::Eq;
  112. EXPECT_THAT(DoFormat("%p", getpkt("HELLO")), Eq("ERROR"));
  113. }
  114. TEST(PatternLayoutTest, LogMessageIsMToken) {
  115. using testing::Eq;
  116. EXPECT_THAT(DoFormat("%m", getpkt("HELLO")), Eq("HELLO"));
  117. }
  118. MATCHER_P2(Near, value, error, "") { return std::abs(arg - value) < error; }
  119. TEST(PatternLayoutTest, CanOutputTimeSinceCreation) {
  120. // Because we're passing in a timestamp of {0, 0} with getpkt(), %r should
  121. // produce -1 * time_since_epoch_in_milliseconds().
  122. // Since time(NULL) returns seconds, whereas %r returns milliseconds, we
  123. // allow a margin of error of +/- 1 second
  124. EXPECT_THAT(std::stoll(DoFormat("%r", getpkt(""))),
  125. Near(-time(NULL) * 1000, 1000));
  126. }
  127. TEST(PatternLayoutTest, CanOutputLineNumber) {
  128. EXPECT_THAT(std::stoi(DoFormat("%L", getpkt("", log_here))),
  129. testing::Eq(__LINE__ - 1));
  130. }
  131. TEST(PatternLayoutTest, CanOutputFileName) {
  132. EXPECT_THAT(DoFormat("%F", getpkt("", log_here)),
  133. testing::EndsWith("pattern_layout_test.cxx"));
  134. }
  135. TEST(PatternLayoutTest, CanOutputCallingMethod) {
  136. EXPECT_THAT(DoFormat("%M", getpkt("", log_here)), testing::Eq("TestBody"));
  137. }
  138. logging::logpacket packet() { return getpkt("", log_here); }
  139. struct stub {
  140. std::map<int, int> rval;
  141. std::map<int, int> operator()(logging::logpacket & out) {
  142. out = getpkt("", log_here);
  143. return rval;
  144. }
  145. std::map<int, int> const & operator()(logging::logpacket & out) const {
  146. out = getpkt("", log_here);
  147. return rval;
  148. }
  149. logging::logpacket operator()() { return getpkt("", log_here); }
  150. static logging::logpacket packet() { return getpkt("", log_here); }
  151. };
  152. namespace ns {
  153. logging::logpacket packet() { return getpkt("", log_here); }
  154. struct stub {
  155. logging::logpacket operator()() { return getpkt("", log_here); }
  156. static logging::logpacket packet() { return getpkt("", log_here); }
  157. };
  158. }
  159. TEST(PatternLayoutTest, CanOutputClassName) {
  160. EXPECT_THAT(DoFormat("%C", getpkt("", log_here)),
  161. testing::Eq("PatternLayoutTest_CanOutputClassName_Test"));
  162. }
  163. TEST(PatternLayoutTest, GlobalNamespaceClassIsEmptyString) {
  164. EXPECT_THAT(DoFormat("%C", packet()), testing::Eq(""));
  165. }
  166. TEST(PatternLayoutTest, NamespacesActLikeClassName) {
  167. EXPECT_THAT(DoFormat("%C", ns::packet()), testing::Eq("ns"));
  168. }
  169. TEST(PatternLayoutTest, StaticMethodClassIsClass) {
  170. EXPECT_THAT(DoFormat("%C", stub::packet()), testing::Eq("stub"));
  171. }
  172. TEST(PatternLayoutTest, NCMethodReturningComplexTypeReturnsCorrectClass) {
  173. logging::logpacket pkt;
  174. stub st{};
  175. (void)st(pkt);
  176. EXPECT_THAT(DoFormat("%C", pkt), testing::Eq("stub"));
  177. }
  178. TEST(PatternLayoutTest, ConstMethodReturningComplexTypeReturnsCorrectClass) {
  179. logging::logpacket pkt;
  180. stub const st{};
  181. (void)st(pkt);
  182. EXPECT_THAT(DoFormat("%C", pkt), testing::Eq("stub"));
  183. }
  184. TEST(PatternLayoutTest, CanLimitClassToNTokens) {
  185. EXPECT_THAT(DoFormat("%C{1}", ns::stub{}()), testing::Eq("stub"));
  186. EXPECT_THAT(DoFormat("%C{2}", ns::stub{}()), testing::Eq("ns::stub"));
  187. }
  188. TEST(PatternLayoutTest, CanOutputLocation) {
  189. auto message = DoFormat("%l", getpkt("", log_here));
  190. std::string regex = "PatternLayoutTest_CanOutputLocation_Test::TestBody "
  191. "..*pattern_layout_test.cxx, [1-9][0-9]*.";
  192. EXPECT_THAT(message, testing::MatchesRegex(regex));
  193. }
  194. TEST(PatternLayoutTest, CanOutputThreadInfoAsThreadId) {
  195. using testing::Eq;
  196. std::stringstream ss;
  197. ss << std::this_thread::get_id();
  198. EXPECT_THAT(DoFormat("%t", getpkt("")), Eq(ss.str()));
  199. }
  200. TEST(PatternLayoutTest, OutputsThreadNameIfAvailable) {
  201. using testing::Eq;
  202. ::logging::detail::thread_info_helper::set_name("main");
  203. EXPECT_THAT(DoFormat("%t", getpkt("")), Eq("main"));
  204. ::logging::detail::thread_info_helper::set_name("");
  205. }
  206. TEST(PatternLayoutTest, ThreadNameIsThreadLocalStorage) {
  207. using testing::Ne;
  208. ::logging::detail::thread_info_helper::set_name("main");
  209. std::thread tr([]() { EXPECT_THAT(DoFormat("%t", getpkt("")), Ne("main")); });
  210. tr.join();
  211. ::logging::detail::thread_info_helper::set_name("");
  212. }
  213. TEST(PatternLayoutTest, ThrowsOnUnknownToken) {
  214. using testing::Eq;
  215. EXPECT_THROW(GetPatternLayout("%q"), logging::unknown_format_specifier);
  216. }
  217. TEST(PatternLayoutTest, TokenCanBeTruncatedInFormat) {
  218. using testing::Eq;
  219. EXPECT_THAT(DoFormat("%.3m", getpkt("HELLO")), Eq("HEL"));
  220. EXPECT_THAT(DoFormat("%.5c", getpkt("HELLO")), Eq("UNIT_"));
  221. EXPECT_THAT(DoFormat("%.2t", getpkt("HELLO")), Eq("0x"));
  222. }
  223. TEST(PatternLayoutTest, TokenCanBeLeftPadded) {
  224. using testing::Eq;
  225. EXPECT_THAT(DoFormat("%6m", getpkt("HELLO")), Eq(" HELLO"));
  226. }
  227. TEST(PatternLayoutTest, TokenCanBeRightPadded) {
  228. using testing::Eq;
  229. EXPECT_THAT(DoFormat("%-6m", getpkt("HELLO")), Eq("HELLO "));
  230. }
  231. TEST(PatternLayoutTest, TokenCanBeSizeBound) {
  232. using testing::Eq;
  233. EXPECT_THAT(DoFormat("%6.8m", getpkt("HELLO")), Eq(" HELLO"));
  234. EXPECT_THAT(DoFormat("%6.8m", getpkt("HELLO FRIEND")), Eq("HELLO FR"));
  235. }
  236. #include "header_test_obj.h"
  237. #include "logger/logger.h"
  238. using namespace logging;
  239. using namespace logging::property;
  240. // clang-format off
  241. properties const PATTERN_HEADER_SCHEMA{_obj({
  242. {"configuration", _obj({
  243. {"appenders", _obj({
  244. {"Stub", _obj({
  245. {"PatternLayout", _obj({
  246. {"pattern", _v("%m")},
  247. {"header", _v("HEADER-")},
  248. {"footer", _v("-FOOTER")}
  249. })}
  250. })}
  251. })},
  252. {"loggers", _obj({
  253. {"root", _obj({{"appenders", _obj({{"ref", _v("Stub")}})}})}
  254. })}
  255. })}
  256. })};
  257. // clang-format on
  258. using PatternLayoutHeaderTest = HeaderFooterTest;
  259. TEST_F(PatternLayoutHeaderTest, ProvidesHeader) {
  260. manager mgr;
  261. mgr.configure(PATTERN_HEADER_SCHEMA);
  262. using testing::Eq;
  263. EXPECT_THAT(appender->sstream.str(), Eq("HEADER-"));
  264. mgr.get().log(level::error, "HELLO");
  265. EXPECT_THAT(appender->sstream.str(), Eq("HEADER-HELLO"));
  266. }
  267. TEST_F(PatternLayoutHeaderTest, ProvidesFooter) {
  268. using testing::Eq;
  269. {
  270. manager mgr;
  271. mgr.configure(PATTERN_HEADER_SCHEMA);
  272. appender->sstream.str("");
  273. mgr.get().log(level::error, "HELLO");
  274. }
  275. EXPECT_THAT(appender->sstream.str(), Eq("HELLO-FOOTER"));
  276. }