Struct FileLogWriter 

pub struct FileLogWriter { /* private fields */ }

Writes structured log entries to a JSONL file on disk.

Each line in the output file is a single JSON-serialized LogEntry. The file is opened in append mode so existing content is preserved across restarts.

Implementations

impl FileLogWriter

pub fn new(path: impl Into<PathBuf>) -> Result<Self>

Opens (or creates) the file at path in append mode.

Errors

Returns an IO error if the file cannot be opened or created.

pub fn write_entry(&self, entry: &LogEntry) -> Result<()>

Serializes entry as JSON and writes it as a single line.

The underlying buffer is flushed after every entry so that readers see output promptly.

Errors

Returns an IO error if serialization or writing fails.

Panics

Panics if the internal mutex is poisoned.

pub fn write_line( &self, stream: LogStream, message: &str, source: LogSource, ) -> Result<()>

Convenience method that constructs a LogEntry with Utc::now() as the timestamp, then writes it.

Errors

Returns an IO error if writing fails.

pub fn path(&self) -> &Path

Returns the file path this writer is appending to.