logger_config_builder.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include <kcenon/logger/core/logger_config.h>
#include <kcenon/logger/core/error_codes.h>
 
namespace kcenon::logger {
 
class logger_config_builder {
public:
    logger_config_builder() = default;
 
    // =========================================================================
    // Preset Configurations
    // =========================================================================
 
    logger_config_builder& use_default_config() {
        config_ = logger_config::default_config();
        return *this;
    }
 
    logger_config_builder& use_production_defaults() {
        config_ = logger_config::production();
        return *this;
    }
 
    logger_config_builder& use_debug_defaults() {
        config_ = logger_config::debug_config();
        return *this;
    }
 
    logger_config_builder& use_high_performance_defaults() {
        config_ = logger_config::high_performance();
        return *this;
    }
 
    logger_config_builder& use_low_latency_defaults() {
        config_ = logger_config::low_latency();
        return *this;
    }
 
    // =========================================================================
    // Basic Settings
    // =========================================================================
 
    logger_config_builder& set_async(bool enabled) {
        config_.async = enabled;
        return *this;
    }
 
    logger_config_builder& set_buffer_size(std::size_t size) {
        config_.buffer_size = size;
        return *this;
    }
 
    logger_config_builder& set_min_level(log_level level) {
        config_.min_level = level;
        return *this;
    }
 
    // =========================================================================
    // Performance Settings
    // =========================================================================
 
    logger_config_builder& set_batch_size(std::size_t size) {
        config_.batch_size = size;
        return *this;
    }
 
    logger_config_builder& set_flush_interval(std::chrono::milliseconds interval) {
        config_.flush_interval = interval;
        return *this;
    }
 
    logger_config_builder& use_lock_free(bool enabled) {
        config_.use_lock_free = enabled;
        return *this;
    }
 
    logger_config_builder& set_max_writers(std::size_t max) {
        config_.max_writers = max;
        return *this;
    }
 
    logger_config_builder& enable_batch_writing(bool enabled) {
        config_.enable_batch_writing = enabled;
        return *this;
    }
 
    logger_config_builder& set_writer_thread_count(std::size_t count) {
        config_.writer_thread_count = count;
        return *this;
    }
 
    // =========================================================================
    // Feature Flags
    // =========================================================================
 
    logger_config_builder& enable_metrics(bool enabled) {
        config_.enable_metrics = enabled;
        return *this;
    }
 
    logger_config_builder& enable_crash_handler(bool enabled) {
        config_.enable_crash_handler = enabled;
        return *this;
    }
 
    logger_config_builder& enable_structured_logging(bool enabled) {
        config_.enable_structured_logging = enabled;
        return *this;
    }
 
    logger_config_builder& enable_color_output(bool enabled) {
        config_.enable_color_output = enabled;
        return *this;
    }
 
    logger_config_builder& enable_timestamp(bool enabled) {
        config_.enable_timestamp = enabled;
        return *this;
    }
 
    logger_config_builder& enable_source_location(bool enabled) {
        config_.enable_source_location = enabled;
        return *this;
    }
 
    logger_config_builder& enable_compression(bool enabled) {
        config_.enable_compression = enabled;
        return *this;
    }
 
    // =========================================================================
    // Queue Settings
    // =========================================================================
 
    logger_config_builder& set_max_queue_size(std::size_t size) {
        config_.max_queue_size = size;
        return *this;
    }
 
    logger_config_builder& set_overflow_policy(logger_config::overflow_policy policy) {
        config_.queue_overflow_policy = policy;
        return *this;
    }
 
    // =========================================================================
    // File Output Settings
    // =========================================================================
 
    logger_config_builder& set_max_file_size(std::size_t size) {
        config_.max_file_size = size;
        return *this;
    }
 
    logger_config_builder& set_max_file_count(std::size_t count) {
        config_.max_file_count = count;
        return *this;
    }
 
    logger_config_builder& set_log_directory(const std::string& directory) {
        config_.log_directory = directory;
        return *this;
    }
 
    logger_config_builder& set_log_file_prefix(const std::string& prefix) {
        config_.log_file_prefix = prefix;
        return *this;
    }
 
    // =========================================================================
    // Network Settings
    // =========================================================================
 
    logger_config_builder& set_remote_logging(const std::string& host, uint16_t port) {
        config_.remote_host = host;
        config_.remote_port = port;
        return *this;
    }
 
    logger_config_builder& set_network_timeout(std::chrono::milliseconds timeout) {
        config_.network_timeout = timeout;
        return *this;
    }
 
    logger_config_builder& set_network_retry_count(std::size_t count) {
        config_.network_retry_count = count;
        return *this;
    }
 
    // =========================================================================
    // Build Methods
    // =========================================================================
 
    result<logger_config> build() const {
        auto validation_result = config_.validate();
        if (!validation_result.is_ok()) {
            return result<logger_config>{
                logger_error_code::invalid_configuration,
                "Configuration validation failed: " + validation_result.error().message};
        }
        return result<logger_config>(config_);
    }
 
    logger_config build_unchecked() const {
        return config_;
    }
 
    logger_config_builder& reset() {
        config_ = logger_config{};
        return *this;
    }
 
private:
    logger_config config_;
};
 
} // namespace kcenon::logger