eslint-plugin-no-relative-import-paths

Moving a file to different folder, could result in changing all imports statement in that file. This will not happen is the import paths are absolute. The eslint rule helps enforcing having absolute import paths.
Support eslint --fix to automatically change imports to absolute paths.

Installation

Install ESLint either locally or globally. (Note that locally, per project, is strongly preferred)

``sh
$ npm install eslint --save-dev
`

If you installed ESLint globally, you have to install this plugin globally too. Otherwise, install it locally.

`sh
$ npm install eslint-plugin-no-relative-import-paths --save-dev
`

Configuration

Add the plugin to the plugins section, and configure the rule options.

`json
{
"plugins": ["no-relative-import-paths"],
"rules": {
"no-relative-import-paths/no-relative-import-paths": [
"warn",
{ "allowSameFolder": true }
]
}
}
`

Using the new flat config

Here is an example of how to use with the new flat config.

`ts
import noRelativeImportPaths from 'eslint-plugin-no-relative-import-paths';

export default [
{
plugins: {
'no-relative-import-paths': noRelativeImportPaths,
},
rules: {
'no-relative-import-paths/no-relative-import-paths': 'error',
},
},
]
`

Rule options

`json
...
"no-relative-import-paths/no-relative-import-paths": [
"warn",
{ "allowSameFolder": true, "rootDir": "src", "prefix": "" }
]
...
`

- enabled: for enabling the rule. 0=off, 1=warn, 2=error. Defaults to 0.
- ignorePureComponents: optional boolean set to true to allow relative import paths for imported files from the same folder (default to false).

$3

When true the rule will ignore relative import paths for imported files from the same folder

Examples of code for this rule:

`js
// when true this will be ignored
// when false this will generate a warning
import Something from "./something";

// will always generate a warning
import Something from "../modules/something";
`

$3

Useful when auto-fixing and the rootDir should not be included in the absolute path.

Examples of code for this rule:

`js
// when not configured:
import Something from "../../components/something";

// will result in
import Something from "src/components/something";
`

`js
// when configured as { "rootDir": "src" }
import Something from "../../components/something";

// will result in
import Something from "components/something";
// ^- no 'src/' prefix is added
`

$3

Useful when auto-fixing and a prefix should be included in the absolute path.

Examples of code for this rule:

`js
// when not configured:
import Something from "../../components/something";

// will result in
import Something from "src/components/something";
`

`js
// when configured as { "prefix": "@" }
import Something from "../../components/something";

// will result in
import Something from "@/components/something";
`

$3

Used to allow some relative imports of certain depths.

Examples of code for this rule:

`js
// when configured as { "allowedDepth": 1 }

// will NOT generate a warning
import Something from "../components/something";

// will generate a warning
import Something from "../../components/something";
`

`js
// when configured as { "allowedDepth": 2 }

// will NOT generate a warning
import Something from "../../components/something";

// will generate a warning
import Something from "../../../components/something";
``