recdirreader v0.1.4

node-recdirreader

Recursive Directory Reader for Node.js

Installation

$ npm install recdirreader

How to include

    var RecDirReader = require('recdirreader');

Methods

RecDirReader ( dir: Array ): RecDirReader
RecDirReader ( dir: String ): RecDirReader
RecDirReader ( dir: Array, filter: RegExp ): RecDirReader
RecDirReader ( dir: String, filter: RegExp ): RecDirReader
RecDirReader.dir ( dir: Array ): RecDirReader
RecDirReader.dir ( dir: String ): RecDirReader
RecDirReader.filter ( filter: RegExp ): RecDirReader

Available events

• directory for directories
• file for files
• symboliclink for symlinks
• blockdevice for block devices
• characterdevice for character devices
• fifo for named pipes
• socket for sockets
• any for any of above event
• empty for empty directories

Every event listener (except of error) becomes two arguments passed: the file path and its fs.Stat object.

Examples

Let's start with this simple piece of code, which simply prints all files (not directories) from /home/myname:

    RecDirReader('/home/myname').on('file', function(file, stat) {
      // print file path and size
      console.log('File: ' + file + ' (' + stat.size + ')');
    }).scan();

Alternatively you can pass the directory /home/myname directly to the scan() method:

    RecDirReader().on('file', function(file, stat) {
      console.log('File: ' + file + ' (' + stat.size + ')');
    }).scan('/home/myname');

As you can see: both, RecDirReader() and its scan() method accept a directory string as first argument. But you can also pass an Array with Strings. Like in this example:

    RecDirReader(['/home/myname/Pictures', '/home/myname/Videos'])
      .on('file', function(file) {
        console.log('File:', file);
      }).scan();

How about filters? Let's say you want to have only *.jpg and/or *.png files from /home/myname/Pictures:

    RecDirReader('/home/myname/Pictures',  /\.(jpg|png)$/).on('file', function(file, stat) {
      console.log('Picture found:', file);
    }).scan();

If you want to have only directories, listen to the directory event:

    RecDirReader().on('directory', function(file) {
      console.log('Directory found:', file);
    }).scan('/home/myname');

Get only symbolic links:

    RecDirReader().on('symboliclink', function(file) {
      console.log('Symlink found:', file);
    }).scan('/home/myname');

Get all empty directories:

    var emptyDirectories = [];
    RecDirReader().on('empty', function(dir) {
      emptyDirectories.push(dir);
    }).on('end', function() {
      console.log('Empty Directories:', emptyDirectories);
    }).scan('/home/myname');

Or just listen to the any event to capture any file/directory:

    RecDirReader().on('any', function(file) {
      console.log(file);
    }).scan('/home/myname');