logging.hpp

 
// File: logging.hpp                                                          //
// Project: respond                                                           //
// Created Date: 2025-06-02                                                   //
// Author: Matthew Carroll                                                    //
// -----                                                                      //
// Last Modified: 2025-07-30                                                  //
// Modified By: Matthew Carroll                                               //
// -----                                                                      //
// Copyright (c) 2025 Syndemics Lab at Boston Medical Center                  //
#ifndef RESPOND_LOGGING_HPP_
#define RESPOND_LOGGING_HPP_
 
#include <string>
 
#include <respond/logging_config.hpp>
 
namespace respond {
 
enum class LogType : int {
    kInfo = 0,  // Information Messages
    kWarn = 1,  // Warning Messages
    kError = 2, // Error Messages
    kDebug = 3, // Debug Messages
    kCount = 4  // Enum Counter
};
 
enum class CreationStatus : int {
    kError = -1,     // Error Creating Logger
    kSuccess = 0,    // Logger Created Successfully
    kExists = 1,     // Logger Already Exists
    kNotCreated = 2, // Logger Not Created
    kCount = 4       // Enum Counter
};
 
enum class LogPattern : int {
    kSimple = 0,   // Minimal: [%n] %v
    kStandard = 1, // Default: [%H:%M:%S %z] [%n] [%^---%L---%$] [thread %t] %v
    kDetailed = 2, // Full: [%Y-%m-%d %H:%M:%S.%e] [%n] [%^%L%$] [thread %t] %v
    kThreadSafe =
        3 // With sequence number: [%H:%M:%S] [seq %i] [%n] [%^---%L---%$] %v
};
 
// ============================================================================
// Core Logger Creation and Management
// ============================================================================
 
CreationStatus CreateFileLogger(const std::string &logger_name,
                                const std::string &filepath);
 
CreationStatus ConfigureLogger(const LoggingConfig &config);
 
// ============================================================================
// Parallel Execution Support: Shared File Sink
// ============================================================================
 
CreationStatus CreateSharedFileSink(const std::string &filepath);
 
CreationStatus CreateSharedLogger(const std::string &logger_name);
 
void SetLogPattern(LogPattern pattern);
 
LogPattern GetLogPattern();
 
void SetFlushInterval(int seconds);
 
void FlushAllLoggers();
 
// ============================================================================
// Logging Functions
// ============================================================================
 
void LogInfo(const std::string &logger_name, const std::string &message);
 
void LogWarning(const std::string &logger_name, const std::string &message);
 
void LogError(const std::string &logger_name, const std::string &message);
 
void LogDebug(const std::string &logger_name, const std::string &message);
 
// ============================================================================
// Utility Functions
// ============================================================================
 
CreationStatus CheckLoggerExists(const std::string &logger_name);
 
std::string GetLoggerInfo(const std::string &logger_name);
 
void SetLoggerLevel(const std::string &logger_name, int level);
 
} // namespace respond
 
#endif // RESPOND_LOGGING_HPP_