logging.hpp

Go to the documentation of this file.

/* Copyright 2017 - 2026 R. Thomas
 * Copyright 2017 - 2026 Quarkslab
 *
 * 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 LIEF_LOGGING_H
#define LIEF_LOGGING_H
 
#include "LIEF/visibility.h"
#include <string_view>
 
#include <cstdint>
#include <memory>
#include <string>
#include <vector>
 
namespace spdlog {
class logger;
}
 
 
namespace LIEF::logging {

enum class Level : uint32_t {
  Off = 0,
 
  Trace,
  Debug,
  Info,
  Warn,
  Err,
  Critical,
};

LIEF_API Level get_level();
 
LIEF_API const char* to_string(Level e);

LIEF_API void disable();

LIEF_API void enable();

LIEF_API void set_level(Level level);

LIEF_API void set_path(const std::string& path);

LIEF_API void log(Level level, std::string_view msg);
 
LIEF_API void log(Level level, std::string_view fmt,
                  const std::vector<std::string>& args);
 
template<typename... Args>
void log(Level level, std::string_view fmt, const Args&... args) {
  std::vector<std::string> vec_args;
  vec_args.insert(vec_args.end(),
                  {static_cast<decltype(vec_args)::value_type>(args)...});
  return log(level, fmt, vec_args);
}
 
LIEF_API void set_logger(std::shared_ptr<spdlog::logger> logger);
 
LIEF_API void reset();
 
inline void enable_debug() {
  set_level(Level::Debug);
}
 
inline void debug(std::string_view msg) {
  log(Level::Debug, msg);
}
 
inline void debug(std::string_view fmt, const std::vector<std::string>& args) {
  log(Level::Debug, fmt, args);
}
 
template<typename... Args>
void debug(std::string_view fmt, const Args&... args) {
  std::vector<std::string> vec_args;
  vec_args.insert(vec_args.end(),
                  {static_cast<decltype(vec_args)::value_type>(args)...});
  return debug(fmt, vec_args);
}
 
// -----------------------------------------------------------------------------
 
inline void info(std::string_view msg) {
  log(Level::Info, msg);
}
 
inline void info(std::string_view fmt, const std::vector<std::string>& args) {
  log(Level::Info, fmt, args);
}
 
template<typename... Args>
void info(std::string_view fmt, const Args&... args) {
  std::vector<std::string> vec_args;
  vec_args.insert(vec_args.end(),
                  {static_cast<decltype(vec_args)::value_type>(args)...});
  return info(fmt, vec_args);
}
 
// -----------------------------------------------------------------------------
 
inline void warn(std::string_view msg) {
  log(Level::Warn, msg);
}
 
inline void warn(std::string_view fmt, const std::vector<std::string>& args) {
  log(Level::Warn, fmt, args);
}
 
template<typename... Args>
void warn(std::string_view fmt, const Args&... args) {
  std::vector<std::string> vec_args;
  vec_args.insert(vec_args.end(),
                  {static_cast<decltype(vec_args)::value_type>(args)...});
  return warn(fmt, vec_args);
}
 
// -----------------------------------------------------------------------------
 
inline void err(std::string_view msg) {
  log(Level::Err, msg);
}
 
inline void err(std::string_view fmt, const std::vector<std::string>& args) {
  log(Level::Err, fmt, args);
}
 
template<typename... Args>
void err(std::string_view fmt, const Args&... args) {
  std::vector<std::string> vec_args;
  vec_args.insert(vec_args.end(),
                  {static_cast<decltype(vec_args)::value_type>(args)...});
  return err(fmt, vec_args);
}
 
// -----------------------------------------------------------------------------
 
inline void critical(std::string_view msg) {
  log(Level::Critical, msg);
}
 
inline void critical(std::string_view fmt, const std::vector<std::string>& args) {
  log(Level::Critical, fmt, args);
}
 
template<typename... Args>
void critical(std::string_view fmt, const Args&... args) {
  std::vector<std::string> vec_args;
  vec_args.insert(vec_args.end(),
                  {static_cast<decltype(vec_args)::value_type>(args)...});
  return critical(fmt, vec_args);
}
 
// -----------------------------------------------------------------------------
namespace named {
LIEF_API Level get_level(const char* name);

LIEF_API void disable(const char* name);

LIEF_API void enable(const char* name);

LIEF_API void set_level(const char* name, Level level);

LIEF_API void set_path(const char* name, const std::string& path);

LIEF_API void log(const char* name, Level level, std::string_view msg);

LIEF_API void set_logger(const char* name, std::shared_ptr<spdlog::logger> logger);
 
LIEF_API spdlog::logger& get_sink(const char* name);

LIEF_API void reset(const char* name);

inline void enable_debug(const char* name) {
  set_level(name, Level::Debug);
}
 
inline void debug(const char* name, std::string_view msg) {
  log(name, Level::Debug, msg);
}
 
inline void info(const char* name, std::string_view msg) {
  log(name, Level::Info, msg);
}
 
inline void warn(const char* name, std::string_view msg) {
  log(name, Level::Warn, msg);
}
 
inline void err(const char* name, std::string_view msg) {
  log(name, Level::Err, msg);
}
 
inline void critical(const char* name, std::string_view msg) {
  log(name, Level::Critical, msg);
}
}
 
 
class Scoped {
  public:
  Scoped(const Scoped&) = delete;
  Scoped& operator=(const Scoped&) = delete;
 
  Scoped(Scoped&&) = delete;
  Scoped& operator=(Scoped&&) = delete;
 
  explicit Scoped(Level level) :
    level_(get_level()) {
    set_level(level);
  }
 
  explicit Scoped(Level level, std::string name) :
    level_(get_level()),
    name_(std::move(name)) {
    set_level(level);
  }
 
  const Scoped& set_level(Level lvl) const {
    if (name_.empty()) {
      logging::set_level(lvl);
    } else {
      logging::named::set_level(name_.c_str(), lvl);
    }
    return *this;
  }
 
  void reset() {
    set_level(level_);
  }
 
  ~Scoped() {
    reset();
  }
 
  private:
  Level level_ = Level::Info;
  std::string name_;
};
 
 
}
 
 
#endif