bos-watcherless

#Fork Watcherless Based#

Unsatisfied with the less file watchers on NPM, I've created watcherless to be a more reliable solution. Watcherless uses chokidar as the library for file watching which has better reliability than fs.watch or stalker.

When I started this project, there wasn't already one on NPM with the name "watchless", so I had to alter - hence the different name repo

##Install##

    npm install -g watcherless # to install global, include -g

##Usage##

###Command Line###

Usage: watcherless [options] <source> <destination>

  <source>             =   The source directory or less file to compile
  <destination>        =   The destination directory for the compiled CSS

  OPTIONS
     -e, --extension   =   The extension for the compiled CSS file, .min is prefixed if compression is enabled
     -c, --compress    =   Enable compress on compiled CSS
     -h, --help        =   This menu

In a typical watcher solution for package.json:

...

    {
        "scripts": {
            "watch-js": "watchify app/js/script.js -o app/static/bundle.min.js",
            "watch-less": "watcherless -c app/less app/css",
            "watch": "npm run watch-js & npm run watch-less"
        }
    }
...

npm run watch

###Node.js###

    var watcherless = require("watcherless");

    var options = {
        source: "app/less/test.less",
        destination: "app/css",
        compress: true
        };

    var watcher = watcherless(options); // When source and destination are supplied in the options, watch starts automatically

    var watcherless = require("watcherless");

    var options = {
        compress: true
        };

    var watcher = watcherless(options);

    watcher.watch("app/less", "app/css"); // The watcher can be started by calling watch. If the source or destination aren't supplied, they are pulled from the options

    watcher.stop(); // Stop watching files