eslint-plugin-dependency-cruiser

Runs Dependency Cruiser as an ESLint rule and reports import rule violations.

Installation

1npm install --save-dev eslint-plugin

or

1yarn add --dev eslint-plugin-dependency-cruiser

eslint-plugin-dependency-cruiser does not install Dependency Cruiser or ESLint for you. You must install these yourself.

Then, in your .eslintrc.js or .eslintrc.json:

1{
2  "plugins": ["dependency-cruiser"],
3  "extends": ["plugin:dependency-cruiser/all"]
4}

Configuration

By default the plugin looks for the Dependency Cruiser configuration and the baseline file in the default locations (.dependency-cruiser.js and .dependency-cruiser-known-violations.json). You can configure that using ESLint's settings, specifying dependency-cruiser key with a value of an object with config and knownViolations. Paths are relative to the project's root. For example:

1{
2  "plugins": ["dependency-cruiser"],
3  "extends": ["plugin:dependency-cruiser/all"],
4  "settings": {
5    "dependency-cruiser": {
6      "knownViolations": ".dependency-cruiser-baseline.json",
7      "config": ".dependency-cruiser.cjs"
8    }
9  }
10}

Limitations

The plugin is not exposing all validation features or configuration options of Dependency Cruiser's. Some things missing:

• Support for loading webpack configuration
• Support for detecting violations that require cruising the whole dependency tree, e.g. circular dependencies
• Support for rule types other than forbidden (i.e. allowed and required)