@springernature/eslint-config

eslint-config-springernature

ESLint shareable config used at Springer Nature.

Installation

Our default export contains all of our ESLint rules, and includes the following plugins:

• eslint-plugin-import
• eslint-plugin-no-use-extend-native
• eslint-plugin-node
• eslint-plugin-promise
• eslint-plugin-unicorn

Using Yarn

1. run npm info "@springernature/eslint-config@latest" peerDependencies to list the peer dependencies and versions
2. run yarn add --dev <dependency>@<version> for each listed peer dependency

Using NPM

Install the correct versions of each package, which are listed by the command:

npm info "@springernature/eslint-config@latest" peerDependencies

If using npm 5+, use this shortcut

npx install-peerdeps --dev @springernature/eslint-config

If using npm < 5, Linux/OSX users can run

(
  export PKG=@springernature/eslint-config;
  npm info "$PKG@latest" peerDependencies --json | command sed 's/[\{\},]//g ; s/: /@/g' | xargs npm install --save-dev "$PKG@latest"
)

Which produces and runs a command like:

npm install --save-dev @springernature/eslint-config eslint@^#.#.# eslint-plugin-node@^#.#.# eslint-plugin-import@^#.#.# eslint-plugin-o-use-extend-native@^#.#.# eslint-plugin-promise@^#.#.# eslint-plugin-unicorn@^#.#.#

If using npm < 5, Windows users can either install all the peer dependencies manually, or use the install-peerdeps cli tool.

npm install -g install-peerdeps
install-peerdeps --dev @springernature/eslint-config

The cli will produce and run a command like:

npm install --save-dev @springernature/eslint-config eslint@^#.#.# eslint-plugin-node@^#.#.# eslint-plugin-import@^#.#.# eslint-plugin-o-use-extend-native@^#.#.# eslint-plugin-promise@^#.#.# eslint-plugin-unicorn@^#.#.#

Usage

Create an .eslintrc file in our project and include the following:

{
  "extends": "@springernature/eslint-config",
  "rules": {
    // Additional, per-project rules...
  }
}

Ignore files/folders

You can optionally create an .eslintignore file to ignore file paths. The .eslintignore file is a plain text file where each line is a glob pattern indicating which paths should be omitted from linting. For example, the following will ignore all files in the tests and coverage folders:

**/tests/*
**/coverage/*

Environments

By default the following environments are set by the config:

• browser - browser global variables
• node - Node.js global variables and Node.js scoping
• es6 - enable all ECMAScript 6 features except for modules (this automatically sets the ecmaVersion parser option to 6)

Contributing

For information on how to contribute to this config, please see the Contributing guidelines.

We should be maintaining this config by updating plugins to the latest versions, and upgrading ESLint when a new version is available in order to keep up to date with new rules and syntax changes.

Changelog

0.1.0 (2018-03-05)

• Common linting rules
• Extends eslint:recommended
• Includes plugins
  • eslint-plugin-import
  • eslint-plugin-no-use-extend-native
  • eslint-plugin-node
  • eslint-plugin-promise
  • eslint-plugin-unicorn