dirwalker v0.0.4

DirWalker

A directory tree walker that broadcasts event as files are found.

Installation

sudo npm install dirwalker

Usage

# a temp directory for this example  
TMP = "#{__dirname}/tmp"

DirWalker = require('dirwalker')

#instantiate with the root path to start walking from
dirwalker = new DirWalker(TMP)

# set up some listeners
dirwalker.on('File', (filepath, stat) ->
  console.log("File: #{filepath} is found!")
)

dirwalker.on('Directory', (filepath, stat) ->
  console.log("Directory: #{filepath} is found!")
)

# start the walking process
dirwalker.walk()

File Types

7 file types are supported and DirWalker emits corresponding events.

Note those event names are capitalized.

File Directory BlockDevice FIFO Socket CharacterDevice SymbolicLink

Other file types will still be found and marked Unknown.

Listener functions will have filepath and stats from fs.lstat()

dirwalker.on('File, (filepath, stat) -> console.log("FilePath: #{filepath}") console.log("Stats: #{stats}")
)

Events

In addition to the 8 file found events above, DirWalker broadcasts the following events as well.

# when the walking is done, it emits "end" with an object that contains lists of all the files found under each file type as a key
dirwalker.on('end, (data) ->
  # list all the files found
  console.log(data.File)
  
  # list all the symbolic links found
  console.log(data.SymbolicLink)
)

# if the given root directory doesn't exist, the walking operation cannot be initiated
dirwalker.on('nofile, (err) ->
  console.log(err)
)

# if the given root is not a directory, the walking operation still cannot be initiated
dirwalker.on('not dir, (filepath, stats) ->
  console.log("#{filepath} is not a directory!")
  console.log(stats)
)

Filter Function

A filter function can be set to ignore files and directories. If a directory is ignored, DirWalker doesn't go into that directory, so the sub contents under the directorey are all ignored, thus unreported.

dirwalker.setFilter((filepath, stat) ->
  return filepath is "#{TMP}/ignore.coffee"
)

Running Tests

Run tests with mocha

make

License

DirWalker is released under the MIT License. - see LICENSE file