Logs messages to files with date-based rotation and automatic deletion of old logs. More...

#include <FileLogger.hpp>

Inheritance diagram for logit::FileLogger:

Classes
struct	Config
	Configuration for the file logger. More...

Public Member Functions
	FileLogger ()
	Default constructor that uses default configuration.

	FileLogger (const Config &config)
	Constructor with custom configuration.

	FileLogger (const std::string &directory, const bool &async=true, const int &auto_delete_days=30)
	Constructor with directory and asynchronous flag.

virtual	~FileLogger ()
	Destructor to stop logging and close file.

void	log (const LogRecord &record, const std::string &message) override
	Logs a message to a file with thread safety.

std::string	get_string_param (const LoggerParam &param) const override
	Retrieves a string parameter from the logger.

int64_t	get_int_param (const LoggerParam &param) const override
	Retrieves an integer parameter from the logger.

double	get_float_param (const LoggerParam &param) const override
	Retrieves a floating-point parameter from the logger.

void	set_log_level (LogLevel level) override
	Sets the minimal log level for this logger.

LogLevel	get_log_level () const override
	Gets the minimal log level for this logger.

void	wait () override
	Waits for all asynchronous tasks to complete.

Public Member Functions inherited from logit::ILogger
virtual	~ILogger ()=default

Private Member Functions
void	start_logging ()
	Starts the logging process by initializing the file and directory.

void	stop_logging ()
	Stops the logging process by closing the file and waiting for tasks.

void	initialize_directory ()
	Initializes the logging directory.

std::string	get_directory_path () const
	Gets the full path to the logging directory.

void	open_log_file (const int64_t &date_ts)
	Opens a new log file based on the provided date timestamp.

std::string	create_file_path (int64_t date_ts) const
	Creates a file path for the log file based on the date timestamp.

void	write_log (const std::string &message, const int64_t &timestamp_ms)
	Writes a log message to the file.

void	remove_old_logs ()
	Removes old log files based on the auto-delete days configuration.

bool	is_valid_log_filename (const std::string &filename) const
	Checks if the filename matches the log file naming pattern.

int64_t	get_date_ts_from_filename (const std::string &filename) const
	Extracts the date timestamp from the log filename.

int64_t	get_current_utc_date_ts () const
	Gets the current UTC date timestamp in seconds.

int64_t	current_timestamp_ms () const
	Gets the current timestamp in milliseconds.

std::string	get_last_log_file_path () const
	Retrieves the last log file path.

std::string	get_last_log_file_name () const
	Retrieves the last log file name.

int64_t	get_last_log_ts () const
	Retrieves the timestamp of the last log.

int64_t	get_time_since_last_log () const
	Retrieves the time since the last log.

Private Attributes
std::mutex	m_mutex
	Mutex to protect file operations.

Config	m_config
	Configuration for the file logger.

std::ofstream	m_file
	Output file stream for logging.

std::mutex	m_file_path_mutex
	Mutex to protect file path operations.

std::string	m_file_path
	Path of the currently open log file.

std::string	m_file_name
	Name of the currently open log file.

int64_t	m_current_date_ts = 0
	Timestamp of the current log file's date.

std::atomic< int64_t >	m_last_log_ts = ATOMIC_VAR_INIT(0)
	Timestamp of the last log.

std::atomic< int >	m_log_level = ATOMIC_VAR_INIT(static_cast<int>(LogLevel::LOG_LVL_TRACE))

Detailed Description

Logs messages to files with date-based rotation and automatic deletion of old logs.

This logger writes logs to files organized by date. It supports asynchronous logging and manages old files based on a configurable retention period.

Key Features:

Date-based file rotation.
Automatic cleanup of old files.
Synchronous or asynchronous operation.

Definition at line 59 of file FileLogger.hpp.

Constructor & Destructor Documentation

◆ FileLogger() [1/3]

logit::FileLogger::FileLogger ( )

inline

Default constructor that uses default configuration.

Definition at line 71 of file FileLogger.hpp.

◆ FileLogger() [2/3]

logit::FileLogger::FileLogger ( const Config & config )

inline

Constructor with custom configuration.

Parameters

config The configuration for the logger.

Definition at line 77 of file FileLogger.hpp.

◆ FileLogger() [3/3]

logit::FileLogger::FileLogger	(	const std::string &	directory,
		const bool &	async = true,
		const int &	auto_delete_days = 30 )

inline

Constructor with directory and asynchronous flag.

Parameters

directory	The directory where log files will be stored.
async	Boolean flag for asynchronous logging.
auto_delete_days	Number of days after which old log files are deleted.

Definition at line 85 of file FileLogger.hpp.

◆ ~FileLogger()

virtual logit::FileLogger::~FileLogger ( )

inlinevirtual

Destructor to stop logging and close file.

Definition at line 96 of file FileLogger.hpp.

Member Function Documentation

◆ create_file_path()

std::string logit::FileLogger::create_file_path ( int64_t date_ts ) const

inlineprivate

Creates a file path for the log file based on the date timestamp.

Parameters

date_ts The timestamp representing the date for the log file.

Returns: The path to the log file.

Definition at line 261 of file FileLogger.hpp.

◆ current_timestamp_ms()

int64_t logit::FileLogger::current_timestamp_ms ( ) const

inlineprivate

Gets the current timestamp in milliseconds.

Returns: The current timestamp in milliseconds.

Definition at line 348 of file FileLogger.hpp.

◆ get_current_utc_date_ts()

int64_t logit::FileLogger::get_current_utc_date_ts ( ) const

inlineprivate

Gets the current UTC date timestamp in seconds.

Returns: The current UTC date timestamp in seconds.

Definition at line 342 of file FileLogger.hpp.

◆ get_date_ts_from_filename()

int64_t logit::FileLogger::get_date_ts_from_filename ( const std::string & filename ) const

inlineprivate

Extracts the date timestamp from the log filename.

Parameters

filename The filename to extract the date from.

Returns: The date timestamp.

Definition at line 335 of file FileLogger.hpp.

◆ get_directory_path()

std::string logit::FileLogger::get_directory_path ( ) const

inlineprivate

Gets the full path to the logging directory.

Returns: The path to the logging directory.

Definition at line 229 of file FileLogger.hpp.

◆ get_float_param()

double logit::FileLogger::get_float_param ( const LoggerParam & param ) const

inlineoverridevirtual

Retrieves a floating-point parameter from the logger.

Parameters

param The parameter type to retrieve.

Returns: A double representing the requested parameter, or 0.0 if the parameter is unsupported.

Implements logit::ILogger.

Definition at line 160 of file FileLogger.hpp.

◆ get_int_param()

int64_t logit::FileLogger::get_int_param ( const LoggerParam & param ) const

inlineoverridevirtual

Retrieves an integer parameter from the logger.

Parameters

param The parameter type to retrieve.

Returns: An integer representing the requested parameter, or 0 if the parameter is unsupported.

Implements logit::ILogger.

Definition at line 147 of file FileLogger.hpp.

◆ get_last_log_file_name()

std::string logit::FileLogger::get_last_log_file_name ( ) const

inlineprivate

Retrieves the last log file name.

Returns: The last log file name.

Definition at line 361 of file FileLogger.hpp.

◆ get_last_log_file_path()

std::string logit::FileLogger::get_last_log_file_path ( ) const

inlineprivate

Retrieves the last log file path.

Returns: The last log file path.

Definition at line 354 of file FileLogger.hpp.

◆ get_last_log_ts()

int64_t logit::FileLogger::get_last_log_ts ( ) const

inlineprivate

Retrieves the timestamp of the last log.

Returns: The last log timestamp.

Definition at line 368 of file FileLogger.hpp.

◆ get_log_level()

LogLevel logit::FileLogger::get_log_level ( ) const

inlineoverridevirtual

Gets the minimal log level for this logger.

Implements logit::ILogger.

Definition at line 176 of file FileLogger.hpp.

◆ get_string_param()

std::string logit::FileLogger::get_string_param ( const LoggerParam & param ) const

inlineoverridevirtual

Retrieves a string parameter from the logger.

Parameters

param The parameter type to retrieve.

Returns: A string representing the requested parameter.

Implements logit::ILogger.

Definition at line 132 of file FileLogger.hpp.

◆ get_time_since_last_log()

int64_t logit::FileLogger::get_time_since_last_log ( ) const

inlineprivate

Retrieves the time since the last log.

Returns: The time in milliseconds since the last log.

Definition at line 374 of file FileLogger.hpp.

◆ initialize_directory()

void logit::FileLogger::initialize_directory ( )

inlineprivate

Initializes the logging directory.

Definition at line 223 of file FileLogger.hpp.

◆ is_valid_log_filename()

bool logit::FileLogger::is_valid_log_filename ( const std::string & filename ) const

inlineprivate

Checks if the filename matches the log file naming pattern.

Parameters

filename The filename to check.

Returns: True if the filename matches the pattern, false otherwise.

Definition at line 327 of file FileLogger.hpp.

◆ log()

void logit::FileLogger::log	(	const LogRecord &	record,
		const std::string &	message )

inlineoverridevirtual

Logs a message to a file with thread safety.

If asynchronous logging is enabled, the message is added to the task queue; otherwise, it is logged directly.

Parameters

record	The log record containing log information.
message	The formatted log message.

Implements logit::ILogger.

Definition at line 107 of file FileLogger.hpp.

◆ open_log_file()

void logit::FileLogger::open_log_file ( const int64_t & date_ts )

inlineprivate

Opens a new log file based on the provided date timestamp.

Parameters

date_ts The timestamp representing the date for the log file.

Definition at line 239 of file FileLogger.hpp.

◆ remove_old_logs()

void logit::FileLogger::remove_old_logs ( )

inlineprivate

Removes old log files based on the auto-delete days configuration.

Definition at line 281 of file FileLogger.hpp.

◆ set_log_level()

void logit::FileLogger::set_log_level ( LogLevel level )

inlineoverridevirtual

Sets the minimal log level for this logger.

Implements logit::ILogger.

Definition at line 171 of file FileLogger.hpp.

◆ start_logging()

void logit::FileLogger::start_logging ( )

inlineprivate

Starts the logging process by initializing the file and directory.

Definition at line 198 of file FileLogger.hpp.

◆ stop_logging()

void logit::FileLogger::stop_logging ( )

inlineprivate

Stops the logging process by closing the file and waiting for tasks.

Definition at line 214 of file FileLogger.hpp.

◆ wait()

void logit::FileLogger::wait ( )

inlineoverridevirtual

Waits for all asynchronous tasks to complete.

Implements logit::ILogger.

Definition at line 181 of file FileLogger.hpp.

◆ write_log()

void logit::FileLogger::write_log	(	const std::string &	message,
		const int64_t &	timestamp_ms )

inlineprivate

Writes a log message to the file.

Parameters

message	The log message to write.
timestamp_ms	The timestamp of the log message in milliseconds.

Definition at line 269 of file FileLogger.hpp.

Member Data Documentation

◆ m_config

Config logit::FileLogger::m_config

private

Configuration for the file logger.

Definition at line 188 of file FileLogger.hpp.

◆ m_current_date_ts

int64_t logit::FileLogger::m_current_date_ts = 0

private

Timestamp of the current log file's date.

Definition at line 193 of file FileLogger.hpp.

◆ m_file

std::ofstream logit::FileLogger::m_file

private

Output file stream for logging.

Definition at line 189 of file FileLogger.hpp.

◆ m_file_name

std::string logit::FileLogger::m_file_name

private

Name of the currently open log file.

Definition at line 192 of file FileLogger.hpp.

◆ m_file_path

std::string logit::FileLogger::m_file_path

private

Path of the currently open log file.

Definition at line 191 of file FileLogger.hpp.

◆ m_file_path_mutex

std::mutex logit::FileLogger::m_file_path_mutex

mutableprivate

Mutex to protect file path operations.

Definition at line 190 of file FileLogger.hpp.

◆ m_last_log_ts

std::atomic<int64_t> logit::FileLogger::m_last_log_ts = ATOMIC_VAR_INIT(0)

private

Timestamp of the last log.

Definition at line 194 of file FileLogger.hpp.

◆ m_log_level

std::atomic<int> logit::FileLogger::m_log_level = ATOMIC_VAR_INIT(static_cast<int>(LogLevel::LOG_LVL_TRACE))

private

Definition at line 195 of file FileLogger.hpp.

◆ m_mutex

std::mutex logit::FileLogger::m_mutex

mutableprivate

Mutex to protect file operations.

Definition at line 187 of file FileLogger.hpp.

The documentation for this class was generated from the following file:

include/logit_cpp/logit/loggers/FileLogger.hpp

Classes

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ FileLogger() [1/3]

◆ FileLogger() [2/3]

◆ FileLogger() [3/3]

◆ ~FileLogger()

Member Function Documentation

◆ create_file_path()

◆ current_timestamp_ms()

◆ get_current_utc_date_ts()

◆ get_date_ts_from_filename()

◆ get_directory_path()

◆ get_float_param()

◆ get_int_param()

◆ get_last_log_file_name()

◆ get_last_log_file_path()

◆ get_last_log_ts()

◆ get_log_level()

◆ get_string_param()

◆ get_time_since_last_log()

◆ initialize_directory()

◆ is_valid_log_filename()

◆ log()

◆ open_log_file()

◆ remove_old_logs()

◆ set_log_level()

◆ start_logging()

◆ stop_logging()

◆ wait()

◆ write_log()

Member Data Documentation

◆ m_config

◆ m_current_date_ts

◆ m_file

◆ m_file_name

◆ m_file_path

◆ m_file_path_mutex

◆ m_last_log_ts

◆ m_log_level

◆ m_mutex