Incremental utilities for NodeJS File System API.
Provides the ability to watch an entire tree of
fsu = require 'fs-util'watcher = fsuwatch desired_pathregex_patternrecursive_notifications
The path to the
file you wanna watch.
The regex to filter only the files you wanna watch.
true notifications will be fired for all files. If you delete a
that has many
sub dirs and
delete events will be
dispatched for all the children
files as well.
false, only one event will be dispatched for the
dir that was actually
deleted. It can save you an overhead of events popping up when a
big ammount of
files is deleted.
Bellow is a very basic usage example that can be found in the examples folder.
fsu = require 'fs-util'watcher = fsuwatch 'desired/path'/.coffee$/mtruewatcheron 'watch' consolelog 'WATCHED ' + ftypeflocationwatcheron 'unwatch' consolelog 'UNWATCHED ' + ftypeflocationwatcheron 'create' consolelog 'CREATED ' + ftypeflocationwatcheron 'change' consolelog 'CHANGED ' + ftypeflocationwatcheron 'delete' consolelog 'DELETED ' + ftypeflocationwatcherclose
All callbacks receives only one argument which is the related
It has the following properties:
location of the item.
type, can be
Last stat of the file, it's an instance of fs.Stats.
Current stat of the file, it's an instance of fs.Stats.
tree of subitems (
dirs) under that point.
Besides all the Event Emiter inherited methods, the
watcher class has one more:
When called, this method will forcely close all persistent watcher's process and
removes all previously added listeners. Every file and folder is
events will pop normally for them, and after that the instance becomes useless.
Provides functionalities such as
fsu = require 'fs-util'fsumkdirp dir_pathfsutouch file_pathencoding='utf-8'fsucopy from_pathto_pathfsufind pathregex_patterninclude_dirsfsuls pathfsurm_rm path
Absolute or relative
paths are accepted, you take care of your things.
file encoding when
Your search pattern, i.e.
true will include the
dirs in the search, otherwise only
Remembers that you need to install fs-util locally in order to use it as a LIB.
You will need to
require 'fs-util in you script, there's no reason to install
it globally with
fs-util won't work directly in the command line.
At least for now.
npm install fs-util
In order to contribute you will need to
clone and initialize the env.
git clone email@example.com:[username]/fs-utilcd fs-util && npm install
src/*.coffee files to
Continuously building in
Running tests suite.