JSPM – less-stream@0.1.4

Package Exports

less-stream

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (less-stream) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

#less-stream Streaming less compiler, with support for sourcemaps. Uses less.Parser.parse() to correctly interpret global and modify vars.

##installation Add to your devDependencies:

  "dependencies": {...},
  "devDependencies": {
    "less-stream": "~0.1.4"
  },
  ...

or install directly:

npm install --save-dev less-stream

Then import in your build script:

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

##usage As a simple streaming compiler:

var less = require('less-stream'),
  fs = require('fs');

fs.createReadStream('path/to/less/src')
  .pipe(less())
  .pipe(fs.createWriteStream('path/to/css'));

With streaming build tools like gulp:

var gulp = require('gulp'),
  less = require('less-stream'),  // gulp-less uses less.render() & can't support global/modify vars
  sourcemaps = require('gulp-sourcemaps');

// Basic compile
gulp.task('less', function () {
  return gulp.src('path/to/less/*.less')
    .pipe(less())
    .pipe(gulp.dest('path/to/css/'));
});

// With sourcemaps
gulp.task('less:sourcemap', function () {
  return gulp.src('path/to/less/*.less')
    .pipe(sourcemaps.init())
    .pipe(less())
    .pipe(sourcemaps.write())
    .pipe(gulp.dest('path/to/css/'));
});

##api

less(options)

Accepts the same options hash as the lessc compiler, and returns a Writable stream.