NVIDIA Holoscan SDK v0.4.0
v0.4.0

Program Listing for File logger.hpp

Return to documentation for file (include/holoscan/core/logger.hpp)

Copy
Copied!
            

/* * SPDX-FileCopyrightText: Copyright (c) 2022 NVIDIA CORPORATION & AFFILIATES. All rights reserved. * SPDX-License-Identifier: Apache-2.0 * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef HOLOSCAN_CORE_LOGGER_HPP #define HOLOSCAN_CORE_LOGGER_HPP #include <fmt/format.h> #include <chrono> #include <memory> #include <string> #include <string_view> #include <utility> #define HOLOSCAN_LOG_LEVEL_TRACE 0 #define HOLOSCAN_LOG_LEVEL_DEBUG 1 #define HOLOSCAN_LOG_LEVEL_INFO 2 #define HOLOSCAN_LOG_LEVEL_WARN 3 #define HOLOSCAN_LOG_LEVEL_ERROR 4 #define HOLOSCAN_LOG_LEVEL_CRITICAL 5 #define HOLOSCAN_LOG_LEVEL_OFF 6 // Please define (or call CMake's `set_compile_definitions` with) HOLOSCAN_LOG_ACTIVE_LEVEL before // including to one of the above levels if you want to skip logging at // a certain level at compile time. // // E.g., // #define HOLOSCAN_LOG_ACTIVE_LEVEL 3 // #include // ... // // Then, it will only log at the WARN(3)/ERROR(4)/CRITICAL(5) levels. // Workaround for zero-arguments // (https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0306r2.html) // If __VA_OPT__ is supported (since C++20), we could use it to use compile-time format string check // : FMT_STRING(format) // (https://fmt.dev/latest/api.html#compile-time-format-string-checks) #define HOLOSCAN_LOG_CALL(level, ...) \ ::holoscan::Logger::log( \ __FILE__, __LINE__, static_cast<const char*>(__FUNCTION__), level, __VA_ARGS__) // clang-format off #if HOLOSCAN_LOG_ACTIVE_LEVEL <= HOLOSCAN_LOG_LEVEL_TRACE # define HOLOSCAN_LOG_TRACE(...) HOLOSCAN_LOG_CALL(::holoscan::LogLevel::TRACE, __VA_ARGS__) #else # define HOLOSCAN_LOG_TRACE(...) (void)0 #endif #if HOLOSCAN_LOG_ACTIVE_LEVEL <= HOLOSCAN_LOG_LEVEL_DEBUG # define HOLOSCAN_LOG_DEBUG(...) HOLOSCAN_LOG_CALL(::holoscan::LogLevel::DEBUG, __VA_ARGS__) #else # define HOLOSCAN_LOG_DEBUG(...) (void)0 #endif #if HOLOSCAN_LOG_ACTIVE_LEVEL <= HOLOSCAN_LOG_LEVEL_INFO # define HOLOSCAN_LOG_INFO(...) HOLOSCAN_LOG_CALL(::holoscan::LogLevel::INFO, __VA_ARGS__) #else # define HOLOSCAN_LOG_INFO(...) (void)0 #endif #if HOLOSCAN_LOG_ACTIVE_LEVEL <= HOLOSCAN_LOG_LEVEL_WARN # define HOLOSCAN_LOG_WARN(...) HOLOSCAN_LOG_CALL(::holoscan::LogLevel::WARN, __VA_ARGS__) #else # define HOLOSCAN_LOG_WARN(...) (void)0 #endif #if HOLOSCAN_LOG_ACTIVE_LEVEL <= HOLOSCAN_LOG_LEVEL_ERROR # define HOLOSCAN_LOG_ERROR(...) HOLOSCAN_LOG_CALL(::holoscan::LogLevel::ERROR, __VA_ARGS__) #else # define HOLOSCAN_LOG_ERROR(...) (void)0 #endif #if HOLOSCAN_LOG_ACTIVE_LEVEL <= HOLOSCAN_LOG_LEVEL_CRITICAL # define HOLOSCAN_LOG_CRITICAL(...) \ HOLOSCAN_LOG_CALL(::holoscan::LogLevel::CRITICAL, __VA_ARGS__) #else # define HOLOSCAN_LOG_CRITICAL(...) (void)0 #endif // clang-format on namespace holoscan { enum class LogLevel { TRACE = 0, DEBUG = 1, INFO = 2, WARN = 3, ERROR = 4, CRITICAL = 5, OFF = 6, }; class Logger { public: static void load_env_level(); static void set_level(LogLevel level); static LogLevel level(); static void set_pattern(std::string pattern); static bool should_backtrace(); static void disable_backtrace(); static void enable_backtrace(size_t n_messages); static void dump_backtrace(); static void flush(); static LogLevel flush_level(); static void flush_on(LogLevel level); template <typename FormatT, typename... ArgsT> static void log(const char* file, int line, const char* function_name, LogLevel level, const FormatT& format, ArgsT&&... args) { log_message(file, line, function_name, level, format, fmt::make_args_checked<ArgsT...>(format, args...)); } template <typename FormatT, typename... ArgsT> static void log(LogLevel level, const FormatT& format, ArgsT&&... args) { log_message(level, format, fmt::make_args_checked<ArgsT...>(format, args...)); } private: static void log_message(const char* file, int line, const char* function_name, LogLevel level, fmt::string_view format, fmt::format_args args); static void log_message(LogLevel level, fmt::string_view format, fmt::format_args args); }; inline void load_env_log_level() { Logger::load_env_level(); } inline void set_log_level(LogLevel level) { Logger::set_level(level); } inline LogLevel log_level() { return Logger::level(); } inline void set_log_pattern(std::string pattern) { // https://spdlog.docsforge.com/v1.x/0.faq/#colors-do-not-appear-when-using-custom-format Logger::set_pattern(pattern); } template <typename FormatT, typename... ArgsT> inline void log_trace(const FormatT& format, ArgsT&&... args) { Logger::log(LogLevel::TRACE, format, std::forward<ArgsT>(args)...); } template <typename FormatT, typename... ArgsT> inline void log_debug(const FormatT& format, ArgsT&&... args) { Logger::log(LogLevel::DEBUG, format, std::forward<ArgsT>(args)...); } template <typename FormatT, typename... ArgsT> inline void log_info(const FormatT& format, ArgsT&&... args) { Logger::log(LogLevel::INFO, format, std::forward<ArgsT>(args)...); } template <typename FormatT, typename... ArgsT> inline void log_warn(const FormatT& format, ArgsT&&... args) { Logger::log(LogLevel::WARN, format, std::forward<ArgsT>(args)...); } template <typename FormatT, typename... ArgsT> inline void log_error(const FormatT& format, ArgsT&&... args) { Logger::log(LogLevel::ERROR, format, std::forward<ArgsT>(args)...); } template <typename FormatT, typename... ArgsT> inline void log_critical(const FormatT& format, ArgsT&&... args) { Logger::log(LogLevel::CRITICAL, format, std::forward<ArgsT>(args)...); } } // namespace holoscan #endif/* HOLOSCAN_CORE_LOGGER_HPP */

© Copyright 2022, NVIDIA. Last updated on Jun 28, 2023.