explorer

Explore directories in various ways.

explorer

Explore directories in various ways.

explore returns an EventEmitter. It recursively goes through the directories under root, and while doing so, emits the following events:

  • directory (root, entryName, stat)
  • file (root, entryName, stat)
  • symlink (root, entryName, stat)
  • start
  • end
  • error (error)

The explore function starts doing it work on the next tick, so you are able to bind event listeners.

Each function takes an optional options object as second-last argument. Currently, the following options are available:

  • ignoreNodeModules - ignore node_modules directory
  • ignoreVersionControl - ignore version control directories: .git, .svn, .hg
  • sort - entries in each directory are processed in alphabetical order
  • ignoreDirectories - array with names of directories to ignore. This array is augmented with any directories following from other options.

The initial structure of this module was generated by Jumpstart, using the Jumpstart Black Coffee template.

The interface for the explore function - on which the other functions rely - was inspired by node-walk by AJ ONeal

explorer is released under the MIT License.
Copyright (c) 2013 Meryn Stol