lesshint

lesshint

lesshint is a tool to aid you in writing clean and consistent Less.

• Requirements
• Installation
• Configuration
• CLI usage
• Reporters
• Known issues

Requirements

Node.js 0.10 (or later) or io.js 1.0 (or later).

Installation

Run the following command from the command line (add -g to install globally):

npm install lesshint

Configuration

lesshint is customizable and we highly recommend you to look at the available options to tailor it to your needs.

Start by creating a .lesshintrc file in your project root and add your settings to it. It will be automatically loaded and merged with the default values.

Each option is then specifed by it's own JSON object, for example:

"fileExtensions": [".less", ".css"],

"excludedFiles": ["vendor.less"],

"spaceAfterPropertyColon": {
    "enabled": true,
    "style": "one_space" // Comments are allowed
}

Options

fileExtensions

Array of file extensions to check. Either an array of extensions or "*" to allow all files. For example:

"fileExtensions": [".less", ".css"] // Allow ".less" and ".css" files. Can be passed with or without a dot.

"fileExtensions": "*" // Allow all files

excludedFiles

Array of minimatch glob patterns or a file to exclude. For example:

"excludedFiles": ["vendor/*.less"] // Ignore all files in "vendor/"

"excludedFiles": ["vendor.less"] // Ignore a file named "vendor.less"

CLI usage

Run lesshint from the command-line by passing one or more files/directories to recursively scan.

lesshint src/less/ lib/style.less

Available Flags	Description
-c/--config	Specify the configuration file to use (will be merged with defaults).
-e/--exclude	A minimatch glob pattern or a file to exclude form being linted.
-r/--reporter	The reporter to use. See "Reporters" below for possible values.
-V/--version	Show version.

Reporters

As of 0.8.0 the ability to specify custom reporters has been added. These can do anything from just printing something to the terminal to generate custom reports.

There are three ways to load a reporter.

1. Pass the name of a core reporter. See below for a complete listing.
2. Pass the name of a Node module. If lesshint is installed globally only globally installed reporters are available (the normal Node module loading rules apply).
3. Pass a absolute or relative path to a custom reporter anywhere on the disk. Relative paths will be resolved against process.cwd().

Core reporters

• stylish - Colored print of all errors to the console.

Writing your own reporter

In it's simplest form, a reporter is just a function accepting some input. The most basic reporter possible:

module.exports = function (errors) {
    console.log(errors.length ? 'Errors found' : 'No errors');
};

The reporter will be passed an array objects representing each error:

{
    column: 5,
    file: 'test.less',
    line: 1,
    linter: 'spaceBeforeBrace',
    message: 'Opening curly brace should be preceded by one space.',
    severity: 'warning',
    source: '.foo{'
}

It's then up to the reporter to do something with the errors. No returns or anything is needed. lesshint will handle everything like exit codes etc.

Take a look at the default reporter for more information.

Known issues

We are aware of some instances where some Less features won't be properly parsed. In those cases the whole file will simply be ignored by lesshint.

• Using variables in @media directives are not supported. Related issue.
• Using variables in selectors are not supported. Related issue.
• Using double parentheses around calculations etc. are not supported. Related issue.

Changelog

1.0.0 (2015-10-19)

• Complete linter refactor. (92bb70a)
• Merged spaceAfterComma and spaceBeforeComma into spaceAroundComma (28497b0).
• Merged leadingZero and trailingZero into decimalZero (12d34a5).
• Removed the quote style option from attributeQuotes. (c0b229e)
• The comment linter is now disabled by default. (c93121f)
• The default value for zeroUnit is now keep_unit. (0c9ef81)
• The following changes has been made to propertyUnits: (8b85210)
  • Renamed global to valid.
  • Added an invalid option.
• Lint results are now sorted by line and column numbers. (50d223f)
• Better handling of parse errors, they are now returned together with the lint results. (f6efb3c)
• Updated gonzales-pe to 3.x. (ac47970, 9cba245)
• Updated other dependencies. (acb5e10, fcdf05d)