Ready to take your JavaScript development to the next level? Meet npm Enterprise - the ultimate in enterprise JavaScript. Learn more »

eslint-plugin-ember-suave

1.0.0 • Public • Published

eslint-plugin-ember-suave

Build Status

This ESLint plugin exports custom linting rules and a recommended configuration based on DockYard's styleguide. It is tailored for Ember apps specifically, and may be used in conjunction with ember-cli-eslint, or with the ESLint CLI.

Using the plugin with Ember CLI

Installation

Install the plugin as a dev dependency in your Ember CLI project.

npm install --save-dev eslint-plugin-ember-suave

This will make the plugin available to ESLint.

Next, install the ember-cli-eslint addon so that your app can be linted during development and testing. This will also uninstall ember-cli-jshint since there is no need to have both linters running at the same time.

ember install ember-cli-eslint

Configuration

The ember-cli-eslint addon blueprint generates a .eslintrc.js configuration file at the root of the project. By default, it is set to extend ESLint's recommended subset of core linting rules.

Add the plugin's recommended configuration to the list of extensions:

// .eslintrc.js
 
module.exports = {
  // ...
  extends: [
    'eslint:recommended',
    'plugin:ember-suave/recommended'
  ],
  rules: {
  }
};

Overriding Rules

Both core rules (provided by ESLint) and custom rules (prefixed by ember-suave/) from the plugin's recommended configuration can be turned off or modified, if desired.

// .eslintrc.js
 
module.exports = {
  // ...
  extends: [
    'eslint:recommended',
    'plugin:ember-suave/recommended'
  ],
  rules: {
    'quotes': ['error', 'double'],
    'ember-suave/no-const-outside-module-scope': 'off'
  }
};

Working with Editors and the CLI

If you use ESLint in an editor or from the command line, you'll need to install eslint-plugin-ember-suave globally too.

npm install -g eslint-plugin-ember-suave

Rules

A list of custom rules and documentation can be found here.

Development

The provided Yeoman generator should be used for creating rules. In doing do, each rule will have a rule, documentation and test file created automatically. All rules should be tested!

Tests can be run using npm test. Additionally, AST Explorer is a great way to look into the structure of a node to determine what to expect.

Authors

Contributors

Versioning

This library follows Semantic Versioning

Legal

DockYard, Inc. © 2016

@dockyard

Licensed under the MIT license

install

npm i eslint-plugin-ember-suave

Downloadsweekly downloads

4,455

version

1.0.0

license

MIT

last publish

collaborators

  • avatar
  • avatar
Report a vulnerability