logging.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
#pragma once
 
#include <entropic/entropic_export.h>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>
#include <chrono>
#include <filesystem>
#include <memory>
#include <string>
 
namespace entropic::log {
 
ENTROPIC_EXPORT void init(spdlog::level::level_enum level = spdlog::level::info);
 
ENTROPIC_EXPORT void add_file_sink(const std::filesystem::path& path);
 
ENTROPIC_EXPORT std::shared_ptr<spdlog::logger> get(const std::string& name);
 
ENTROPIC_EXPORT void setup_session(const std::filesystem::path& log_dir);
 
ENTROPIC_EXPORT void set_console_enabled(bool enabled);
 
ENTROPIC_EXPORT void register_handle_log(
    int handle_id,
    const std::filesystem::path& log_dir);
 
ENTROPIC_EXPORT void unregister_handle_log(int handle_id);
 
class ENTROPIC_EXPORT HandleLogScope {
public:
    explicit HandleLogScope(int handle_id);
    ~HandleLogScope();
    HandleLogScope(const HandleLogScope&) = delete;
    HandleLogScope& operator=(const HandleLogScope&) = delete;
private:
    int prev_id_;
};
 
ENTROPIC_EXPORT int current_handle_id();
 
// ── Timing utilities ──────────────────────────────────────────
 
inline auto now() { return std::chrono::steady_clock::now(); }
 
inline double elapsed_ms(
    std::chrono::steady_clock::time_point start,
    std::chrono::steady_clock::time_point end)
{
    auto us = std::chrono::duration_cast<std::chrono::microseconds>(
        end - start);
    return static_cast<double>(us.count()) / 1000.0;
}
 
// ── Content escaping ──────────────────────────────────────────
 
ENTROPIC_EXPORT std::string escape_content(const std::string& text);
 
// ── Formatting helpers ────────────────────────────────────────
 
ENTROPIC_EXPORT void log_content(
    const std::shared_ptr<spdlog::logger>& logger,
    spdlog::level::level_enum level,
    const std::string& label,
    const std::string& text);
 
ENTROPIC_EXPORT void log_timing(
    const std::shared_ptr<spdlog::logger>& logger,
    const std::string& label,
    double ms);
 
ENTROPIC_EXPORT void log_tokens(
    const std::shared_ptr<spdlog::logger>& logger,
    int count,
    double time_ms);
 
ENTROPIC_EXPORT void log_decision(
    const std::shared_ptr<spdlog::logger>& logger,
    const std::string& label,
    const std::string& key,
    const std::string& value);
 
} // namespace entropic::log