Wondering what’s next for npm?Check out our public roadmap! »

    @huydd/fs-tail-stream

    1.1.0 • Public • Published

    fs-tail-stream

    fs.createReadStream that supports ongoing tailing of files

    build status

    The built in fs.createReadStream function stops streaming once the file has come to an end.

    If you want to tail the file so that it keeps streaming data when the file grows then you're out of luck.

    This module adds a { tail: true } option to the options which will keep streaming data as data is added to the file, or until the .close() method is called on the read stream.

    Because this module wraps the underlying fs.createReadStream function all the options work as expected.

    Installation

    This module is installed via npm:

    $ npm install fs-tail-stream

    Example Usage

    var fst = require('fs-tail-stream');
    var fs = require('fs');
    var ws = fs.createWriteStream(tmpFile, { flags: 'a' });
     
    // file with the text 'hello' in it
    var tmpFile = '/tmp/my-temp-file.txt';
     
    // same parameters as `fs.createReadStream`, but pass through `tail: true`
    fst.createReadStream(tmpFile, { encoding: 'utf8', start: 80, tail: true })
      .on('sync', function () {
        // called when at the end of the file
        var self = this;
        // write some new data to the file
        ws.write('world', 'utf8', function (err) {
          // stop watching for files, and let the file stream end
          // otherwise the file watching will be indefinite and the process
          // won't' exit
          self.close();
        });
      })
      // will print out both the existing contents of the file, plus the
      // newly added data
      .on('data', console.log);
      // prints out:
      //   hello
      //   world

    Install

    npm i @huydd/fs-tail-stream

    DownloadsWeekly Downloads

    1

    Version

    1.1.0

    License

    BSD-3-Clause

    Unpacked Size

    11.2 kB

    Total Files

    7

    Last publish

    Collaborators

    • avatar