Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including ember-cli-sass-lint with all npm packages installed. Try it out:

var emberCliSassLint = require("ember-cli-sass-lint")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

ember-cli-sass-lint v1.0.5

Pure Node.js sass/scss linting for Ember CLI projects

Ember CLI Sass Lint Build Status npm

This is a pure Node.js scss/scss linter for Ember CLI apps and addons.

Installation

ember install ember-cli-sass-lint

And that's it! This addon will automatically parse your sass/scss files.

Configuration

Linting configuration can be added in a .sass-lint.yml file as required by Sass Lint. For example:

# my-project/.sass-lint.yml

rules:
  extends-before-mixins: 2 # 2 throws error
  placeholders-in-extend: 1 # 1 logs warning
  extends-before-declarations: 0 # 0 means no errors or warnings

Here is a sample config file.

Options

Options can be passed in your ember-cli-build.js in the sassLint object. The defaults are shown below:

// my-project/ember-cli-build.js

var app = new EmberApp(defaults, {
  sassLint: {
    configPath: '.sass-lint.yml',
    shouldThrowExceptions: true,
    shouldLog: true
  }
});

configPath

TypeString
Default'.sass-lint.yml'

A name of the file your config is contained in. This should be a .yml file, preferrably in the root of the Broccoli project.

shouldThrowExceptions

TypeBoolean
Defaulttrue

By default, sass-lint throws exceptions when an error is encountered (note, warnings do not throw errors). Usually this is the preferred functionality.

However, you can stop errors being thrown and, therefore, errors stopping the build process by setting shouldThrowExceptions: false. Use with caution!

shouldLog

TypeBoolean
Defaulttrue

Whether to log warnings and errors to the console. When this is set to false you will not be notified or linting errors!

logError()

TypeFunction
ParamfileLint (Object)

You may override this plugin's default logError() function should you need to intercept file lint objects (e.g. when testing this plugin).

// my-project/ember-cli-build.js
var errors = [];

var app = new EmberApp(defaults, {
  sassLint: {
    logError: function(fileLint) {
      errors.push(fileLint);
    }
  }
});

fileLint is passed in the format returned by sass-lint's lintText() method. you can format it using the format() function in the sass-lint package (npm install --save-dev sass-lint).

Note, when you override logError() this plugin won't log any warnings or errors.

Development

All tests are currently contained in tests/runner.js. This uses Mocha/Chai, not Ember Testing. Tests can be ran with:

npm test

You should also check that the dummy app's styles are still correctly compiled by running the ember app using ember s.

PRs are welcomed and should be issued to the master branch.

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free