less-files

0.1.4 • Public • Published

less-files

Compile LESS files

Installation

npm install less-files

Usage

file(inputFile, outputFile, [options], [callback])

  • inputFile - file to compile
  • outputFile - path in which to write compiled file
  • options - options for less.render() plus the following:
    • sourceMap - enable source map, writing it to this file
    • noWrite - do not write files, only return result
  • callback - function that will be called with (err, { outputFile, outputData, sourceMapFile, sourceMapData })

glob(patterns, base, outputDir, [options], [callback], [updateCallback], [removeCallback])

Uses the mirror-glob module to compile a group of files and possibly watch them for changes afterwards.

  • patterns - a glob pattern or array of glob patterns to process
  • base - an options object to pass to glob() or the base folder in which to search for the patterns (equivalent to options.cwd)
  • outputDir- the directory in which to write the processed files
  • options
    • watch - (default: false) whether the files should be watched for changes
    • sourceMapDir - enable source maps, writing them to the specified directory
    • noWrite - do not write files, only return results
  • callback - function to be called after the initial processing is finished, with (err, results)
  • updateCallback - function to be called after processing is finished due to a file being changed or added. only called when options.watch is true
  • removeCallback - function to be called after a file is removed. only called when options.watch is true

Example

var less = require('less-files');

less.file('f1.less', 'f1.css', function(err, result) {
  // result == { outputFile: 'f1.css', outputData: '...' }
})

less.file('f1.less', 'f1.css', { sourceMap: 'f1.map' }, function(err, result) {
  // result == { outputFile: 'f1.css', outputData: '...', sourceMapFile: 'f1.map', sourceMapData: '...' }
})

less.glob('*.less', 'src', 'build', {}, function(err, result) {
  // result == [ { outputFile, outputData }, { outputFile, outputData }, ... ]
})

less.glob('*.less', 'src', 'build', { watch: true, sourceMapDir: 'maps' }, function(err, result) {
  // console.log("Finished initial processing")
  // result == [ { outputFile, outputData, sourceMapFile, sourceMapData },  ... ]
}, function(err, success) {
  console.log("File reprocessed");
  // success == { outputFile, outputData, sourceMapFile, sourceMapData}
}, function(err) {
  console.log("File removed");
  // err is not null if an error ocurred while unlinking the file
});

TODO

Some of this functionality should probably exported by the less.js module, since the lessc binary also compiles files to files.

Readme

Keywords

none

Package Sidebar

Install

npm i less-files

Weekly Downloads

1

Version

0.1.4

License

MIT

Last publish

Collaborators

  • manuelcabral