Lint lesscss files with grunt
npm install grunt-lesshint> Lint LESSCSS files with grunt
~0.4.5If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
``shell`
npm install grunt-lesshint --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
`js`
grunt.loadNpmTasks( 'grunt-lesshint' );
to the data object passed into grunt.initConfig().
`js
grunt.initConfig({
lesshint: {
options: {
// Task-specific options go here.
},
your_target: {
// Target-specific file lists and/or options go here.
},
},
});
`
Options
#### force
Type:
Default value: falseSet
to true to report lesshint errors but not fail the task.#### reporter
Type:
ObjectRefer to the lesshint docs for more examples: https://github.com/lesshint/lesshint#writing-your-own-reporter
Define your own custom reporter:
javascript
options {
reporter: {
name: "foo-reporter", // optional but recommended
report: function(errors) {
errors.forEach(function(error) {
console.log(error);
// error object looks like:
// {
// column: 5,
// file: 'file.less',
// fullPath: 'path/to/file.less',
// line: 1,
// linter: 'spaceBeforeBrace',
// message: 'Opening curly brace should be preceded by one space.',
// severity: 'warning',
// source: '.foo{'
// }
});
}
}
}
`#### lesshintrc
Type:
or true
Default: nullIf set to
, no config will be sent to lesshint and lesshint will search for .lesshintrc files relative to the files being linted.If a filename is specified, options and globals defined therein will be used. The
lesshintrc file must be valid JSON and looks something like this:`json
{
"spaceAfterPropertyColon": "no_space",
"spaceBeforeBrace": "no_space"
}
`#### allowWarnings
Type:
Default value: falseSet
to true to allow the task to succeed if only warnings occur.Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.Release History
|Date|Version|Changes|
|---|---|---|
|2017-04-21|1.5.1|Fix so we don't break if Lesshint changes config setup in the future|
|2017-03-12|1.5.0|- Update lesshint to 3.0.0
- Update grunt-mocha-test to 0.13.2
- Update mocha to 3.2.0
|
|2016-10-10|1.4.0|Added support for allowing warnings without exiting. Thanks @mmckenziedev!|
|2016-09-22|1.3.0|Added support for custom reporters. Thanks @scttdavs!|
|2016-09-05|1.2.0|- Update grunt to 1.0.0
- Update lesshint to 2.0.0
- Added node 6.* to Travis
|
|2016-01-26|1.1.1|Update grunt-contrib-jshint to 0.12.0|
|2015-10-20|1.1.0|- Update lesshint to 1.0.0
- Switch lesshint back to ^ to ~
- Update mocha to 2.3.3
- Update grunt-contrib-jshint to 0.11.3
|
|2015-09-08|1.0.0|Switch lesshint dependency from ^ to ~ because of the Caret: Major Zero issue. Note: Bumping to 1.0.0 to avoid the issue for this repo|
|2015-09-01|0.9.1|Fix readme and version for 0.9.0 and 0.9.1|
|2015-09-01|0.9.0|- Update lesshint to 0.8.0
- Update mocha to 2.3.0
|
|2015-08-27|0.8.0|- Update lesshint to 0.8.0
- Update spawn-sync to 1.0.11
- Update chalk to 1.1.1
|
|2015-06-25|0.7.0|- Update lesshint to 0.7.0
- Move grunt-lesshint to it's new home
|
|2015-06-28|0.6.1|Update lesshint to 0.6.2|
|2015-05-28|0.6.0|Update lesshint to 0.6.1|
|2015-05-25|0.5.1|Fix readme and version for 0.5.0|
|2015-05-25|0.5.0|Add CI support with Travis-ci and some experimental coveralls.io support|
|2015-05-25|0.4.0|Add support for using custom `.lesshintrc`` files|--force grunt parameterLesshint instead of LessHint