Mila::Logging::FileSink Class Reference

Thread-safe logging sink that writes formatted records to a file. More...

Inheritance diagram for Mila::Logging::FileSink:

Public Member Functions
	FileSink (const FileSink &)=delete
	FileSink (const std::filesystem::path &path, LogLevel initialLevel=LogLevel::Info)
	Opens path for writing and sets the minimum log level.
	FileSink (FileSink &&)=delete
	~FileSink () override
	Flushes and closes the log file.
LogLevel	getLevel () const override
	Returns the current minimum log level.
bool	isEnabled (LogLevel level) const override
	Returns true if records at level would be emitted.
void	log (std::string_view message, LogLevel level, const std::source_location &location=std::source_location::current()) override
	Emits a record at an explicitly specified level.
void	log_critical (std::string_view message, const std::source_location &location=std::source_location::current()) override
	Emits a record at Critical level. Explicitly flushes after write.
void	log_debug (std::string_view message, const std::source_location &location=std::source_location::current()) override
	Emits a record at Debug level.
void	log_error (std::string_view message, const std::source_location &location=std::source_location::current()) override
	Emits a record at Error level.
void	log_info (std::string_view message, const std::source_location &location=std::source_location::current()) override
	Emits a record at Info level.
void	log_trace (std::string_view message, const std::source_location &location=std::source_location::current()) override
	Emits a record at Trace level.
void	log_warning (std::string_view message, const std::source_location &location=std::source_location::current()) override
	Emits a record at Warning level.
FileSink &	operator= (const FileSink &)=delete
FileSink &	operator= (FileSink &&)=delete
const std::filesystem::path &	path () const
	Returns the path of the log file this sink is writing to.
void	setIncludeSourceLocation (bool include)
	Controls whether source location (file, line, function) is prepended to each record.
void	setIncludeTimestamp (bool include)
	Controls whether a timestamp prefix is prepended to each record.
void	setLevel (LogLevel level) override
	Sets the minimum level at which records are emitted.
Public Member Functions inherited from Mila::Logging::Logger
	Logger (const Logger &)=delete
	Logger (Logger &&)=delete
Logger &	operator= (const Logger &)=delete
Logger &	operator= (Logger &&)=delete

Additional Inherited Members
Static Public Member Functions inherited from Mila::Logging::Logger
static void	critical (std::string_view message, const std::source_location &location=std::source_location::current())
	Emits a record at Critical level via the default logger.
static void	debug (std::string_view message, const std::source_location &location=std::source_location::current())
	Emits a record at Debug level via the default logger.
static Logger &	defaultLogger ()
	Returns a reference to the registered default logger.
static void	error (std::string_view message, const std::source_location &location=std::source_location::current())
	Emits a record at Error level via the default logger.
static void	info (std::string_view message, const std::source_location &location=std::source_location::current())
	Emits a record at Info level via the default logger.
static void	setDefaultLogger (Logger *logger)
	Registers a sink as the process-wide default logger.
static void	trace (std::string_view message, const std::source_location &location=std::source_location::current())
	Emits a record at Trace level via the default logger.
static void	warning (std::string_view message, const std::source_location &location=std::source_location::current())
	Emits a record at Warning level via the default logger.

Detailed Description

Thread-safe logging sink that writes formatted records to a file.

The output file is opened with std::ios::trunc on construction so each process run produces a clean log. If the file cannot be opened the constructor throws std::runtime_error; the logger is never left in a half-open state.

Records below Error level are terminated with '\n'. Critical records receive an explicit flush to maximise visibility before a potential process termination.

// Typical wiring for the FastAPI inference server:
auto sink = std::make_shared<Mila::Logging::FileSink>(
    "mila.log", Mila::Logging::LogLevel::Info );
Mila::Logging::Logger::setDefaultLogger( sink.get() );

Constructor & Destructor Documentation

FileSink()

Mila::Logging::FileSink::FileSink ( const std::filesystem::path & path, LogLevel initialLevel = LogLevel::Info )

inlineexplicit

Opens path for writing and sets the minimum log level.

The file is truncated on open. Parent directories must already exist.

Parameters

path	Path to the log file.
initialLevel	Records below this level are silently discarded.

Exceptions

std::runtime_error

if the file cannot be opened.

Member Function Documentation

getLevel()

LogLevel Mila::Logging::FileSink::getLevel ( ) const

inlineoverridevirtual

Returns the current minimum log level.

Implements Mila::Logging::Logger.

isEnabled()

bool Mila::Logging::FileSink::isEnabled ( LogLevel level ) const

inlineoverridevirtual

Returns true if records at level would be emitted.

Parameters

level

The level to test.

Implements Mila::Logging::Logger.

log()

void Mila::Logging::FileSink::log ( std::string_view message, LogLevel level, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at an explicitly specified level.

Parameters

message	The log message.
level	The severity level for this record.
location	Automatically captured call-site location.

Implements Mila::Logging::Logger.

log_critical()

void Mila::Logging::FileSink::log_critical ( std::string_view message, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at Critical level. Explicitly flushes after write.

Implements Mila::Logging::Logger.

log_debug()

void Mila::Logging::FileSink::log_debug ( std::string_view message, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at Debug level.

Implements Mila::Logging::Logger.

log_error()

void Mila::Logging::FileSink::log_error ( std::string_view message, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at Error level.

Implements Mila::Logging::Logger.

log_info()

void Mila::Logging::FileSink::log_info ( std::string_view message, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at Info level.

Implements Mila::Logging::Logger.

log_trace()

void Mila::Logging::FileSink::log_trace ( std::string_view message, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at Trace level.

Implements Mila::Logging::Logger.

log_warning()

void Mila::Logging::FileSink::log_warning ( std::string_view message, const std::source_location & location = std::source_location::current() )

inlineoverridevirtual

Emits a record at Warning level.

Implements Mila::Logging::Logger.

path()

const std::filesystem::path & Mila::Logging::FileSink::path ( ) const

inline

Returns the path of the log file this sink is writing to.

Returns

The filesystem path passed at construction.

setIncludeSourceLocation()

void Mila::Logging::FileSink::setIncludeSourceLocation ( bool include )

inline

Controls whether source location (file, line, function) is prepended to each record.

Parameters

include

Pass false to suppress location info.

setIncludeTimestamp()

void Mila::Logging::FileSink::setIncludeTimestamp ( bool include )

inline

Controls whether a timestamp prefix is prepended to each record.

Parameters

include

Pass false to suppress timestamps.

setLevel()

void Mila::Logging::FileSink::setLevel ( LogLevel level )

inlineoverridevirtual

Sets the minimum level at which records are emitted.

Implements Mila::Logging::Logger.

---

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

• Mila/Src/Logging/FileSink.ixx