Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

lesshint

Package Overview
Dependencies
Maintainers
2
Versions
91
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

lesshint

A tool to aid you in writing clean and consistent Less.

  • 2.0.0
  • Source
  • npm
  • Socket score

Version published
Maintainers
2
Created
Source

lesshint

npm Build Status Build status Coverage Status Dependency Status devDependency Status

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

Requirements

Node.js 0.12 (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 specified by it's own JSON object, for example:

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

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

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

Inline configuration

It's also possible to configure rules using inline comments in your .less files. For example:

// lesshint spaceBeforeBrace: false
.foo{ // This line won't be reported
    color: red;
}

It's also possible to disable rules on a single line using a trailing comment:

.bar {
    color:red; // lesshint spaceAfterPropertyColon: false
}

If you wish to enable a rule that's disabled in your .lesshintrc you need to specify any other options too. But rules without options can be enabled by just setting it to true. For example:

.lesshintrc:

{
    "emptyRule": false,
    "spaceAfterPropertyName": false
}

file.less

// lesshint spaceAfterPropertyName: { enabled: true, style: "one_space" }, emptyRule: true
.foo {
    color : red; // Won't report the extra space before ":"
}

.bar {

}

The options format is a less strict form of JSON. Keys doesn't need any quotes but string values need double quotes.

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"
linters

It's also possible to define your own linters to add to the built-in list. These can be the linters themselves or require paths relative to your current working directory. For example:

"linters": [
    "./plugins/linters/sampleLinter",
    require("./plugins/linters/otherSampleLinter")
]

Custom linters

Since 2.0.0 it's possible to create your own linters when needed for something team/project specfic or something that's out of scope for lesshint.

To work properly, all linters are required to expose a few things.

  • name - The name of the linter. While we don't enforce namespaces, we recommend it to prevent naming collisions.
  • nodeTypes - An array of PostCSS node types that the linter wants to check.
  • lint - The main lint method which will be called with the following arguments.
    • config - The config object for this linter.
    • node - The current node to lint.

If the linter doesn't find any errors or doesn't need/want to check the passed node for some reason it should return undefined. If it finds something it should return an array of result objects which looks like this:

{
    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{'
}

If a linter doesn't set a value for a property, lesshint will set it. Most of the time, you'll only want to set column, line, and message while leaving the rest to lesshint.

A simple linter example:

module.exports = {
    name: 'my-namespace/my-super-awesome-linter',
    nodeTypes: ['decl'],
    lint: function (config, node) {
        var results = [];

        if (true) { // Nothing to lint, return early
            return;
        }

        // Check some things...

        // Return the results
        return results;
    }

We highly recommend the following resources which are all included with lesshint.

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 FlagsDescription
-c/--configSpecify the configuration file to use (will be merged with defaults).
-e/--excludeA minimatch glob pattern or a file to exclude form being linted.
-l/--lintersRequire paths of custom linters to add to the built-in list.
-r/--reporterThe reporter to use. See "Reporters" below for possible values.
-V/--versionShow version.

Exit status codes

Depending on the linter results and options supplied, the exit status code returned by the CLI will differ.

Exit status codeDescription
0Everything is alright, no linting errors found.
1One or more linting errors with a severity of warning was found.
2One or more linting errors with a severity of error was found.
66No files to lint were supplied.
70An unknown error occurred within lesshint, possibly a bug. Please file an issue!
78Something is wrong with the config file, most likely invalid JSON.

These codes were chosen with regards to the preferable exit codes.

Reporters

Reporters can be used to perform actions with the lint results, for example printing something to the terminal or generate custom reports.

The reporter loading steps

  1. If nothing is passed, a simple, default reporter will be used. This will just print all the warnings/errors found.
  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().

These steps always apply, no matter whether you're using the CLI or calling lesshint from code.

Using reporters from the CLI

lesshint --reporter my-super-awesome-reporter file.less
lesshint --reporter /path/to/my/super/awesome/reporter.js file.less

Using reporters from code

If you're writing code which utilizes lesshint, for example a Gulp plugin you can use the getReporter method on the lesshint object to load a reporter using the same logic as lesshint does.

Pass the name of a module or a path to the getReporter method like this:

var Lesshint = require('lesshint');

var lesshint = new Lesshint();
var reporter = lesshint.getReporter('my-super-awesome-reporter');

var errors = lesshint.checkFile('file.less');
reporter.report(errors);

Writing your own reporter

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

module.exports = {
    name: 'my-super-awesome-reporter', // Not required, but recommended
    report: function (errors) {
        console.log(errors.length ? 'Errors found' : 'No errors');
    }
};

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

{
    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{'
}

It's then up to the reporter to do something with the errors. No returns or anything is needed. If running from the CLI, lesshint will handle the setting of correct exit codes.

Take a look at the default reporter for more information.

Keywords

FAQs

Package last updated on 13 Jul 2016

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc