file_tailer 1.0.0

Watch for file changes

file_tailer

A cross-platform file tailing library for Dart.

The file_tailer package provides functionality to read the stream the contents of a file to which data might be appended. This is especially useful for log files.

Using

The file_tailer library was designed to be used without a prefix.

import 'package:file_tailer/file_tailer.dart';

The most common way to use this library to stream log files is by handling the data that is emitted by tailing a file:

import 'dart:convert' show LineSplitter, utf8;
import 'dart:io' show File, stderr, stdout;

import 'package:file_tailer/file_tailer.dart' show tailFile;

void main(List<String> arguments) {
  if (arguments.length != 1) {
    stderr.write('You need to provide exactly one file to be tailed.\n');
    return 1;
  }
  final (stream, _) = tailFile(File(arguments.first));
  stream
      .transform(utf8.decoder)
      .transform(const LineSplitter())
      .forEach((line) async => stdout.write('$line\n'));
}