comon_logger_file 0.1.2

File-based log handler for comon_logger with log rotation.

comon_logger_file

Rotating file handler for comon_logger.

Features

• automatic rotation by file size
• max file retention
• plain text or JSON lines mode
• custom formatter support
• append-on-restart behavior

Installation

dart pub add comon_logger_file

Quick Start

import 'package:comon_logger/comon_logger.dart';
import 'package:comon_logger_file/comon_logger_file.dart';

final fileHandler = FileLogHandler(
  directory: '/path/to/logs',
  maxFileSize: 5 * 1024 * 1024,
  maxFiles: 5,
);

await fileHandler.init();
Logger.root.addHandler(fileHandler);

Configuration

Parameter	Default	Description
directory	required	Target directory for log files
baseFileName	comon_log	Base file name without extension
extension	.txt	File extension
maxFileSize	5 MB	Rotation threshold
maxFiles	5	Max rotated files kept on disk
writeAsJson	false	Write each record as JSON
formatter	SimpleLogFormatter	Formatter used for text mode

Lifecycle

await fileHandler.init();
fileHandler.flush();
await fileHandler.close();

Related packages

Package	Adds
comon_logger	Core logger, filters, handlers, and console formatters