gulp-recess

Lint CSS and LESS with RECESS

Issues with the output should be reported on the RECESS issue tracker.

Install

$ npm install --save-dev gulp-recess

Usage

var gulp = require('gulp');
var recess = require('gulp-recess');

gulp.task('default', function () {
    return gulp.src('src/app.css')
        .pipe(recess())
        .pipe(recess.reporter())
        .pipe(gulp.dest('dist'));
});

API

Options can be specified programmatically as part of the task configuration using the options below. Additionally or alternatively, you can use a .recessrc file to specify the options.

The compress and compile options from RECESS are intentionally missing. Separate tasks like gulp-csso and gulp-less will do a much better job.

recess(options)

Run recess on each file

// default options
includePath: []                // Additional paths to look for `@import`'ed LESS files.
strictPropertyOrder: true    // Complains if not strict property order
noIDs: true                    // Doesn't complain about using IDs in your stylesheets
noJSPrefix: true            // Doesn't complain about styling .js- prefixed classnames
noOverqualifying: true        // Doesn't complain about overqualified selectors (ie: div#foo.bar)
noUnderscores: true            // Doesn't complain about using underscores in your class names
noUniversalSelectors: true    // Doesn't complain about using the universal * selector
zeroUnits: true                // Doesn't complain if you add units to values of 0

Writes .recess object to each vinyl object:

{
    success: true,            // Did it succeed?
    status: 'Perfect!',        // Recess status
    failureCount: 0,        // Number of errors
    results: [],            // Recess failure details
    errors: [],                // Recess errors
    options: {}                // The options passed to Recess
}

recess.reporter(options)

Write the report on each failing file. (Passing files write no output.)

// default options
fail: true                    // If true, it writes error event on failure
minimal: false                // If true, it only lists failure filenames omitting details

License

MIT © Sindre Sorhus