eslint-plugin-putout

ESLint plugin for 🐊Putout with built-in rules from @putout/eslint-config.

Installation

npm i putout eslint eslint-plugin-putout -D

☝️If you installed eslint globally (using the -g flag) then you must also install putout and eslint-plugin-putout globally.

Usage

Plugin

To use putout as ESLint plugin you can use in eslint.config.js

1import putout from 'eslint-plugin-putout';
2
3export default [
4    rules: {
5        'putout/putout': 'error',
6    },
7    plugins: {
8        putout,
9    },
10];

Preset

Also you can import one of predefined preset:

• ✅ recommended - all rules enabled;
• ✅ safe - dangerous rules disabled;
• ✅ safeAlign - dangerous rules disabled + add whitespaces on empty lines;

Here is how it can look like:

1import {recommended} from 'eslint-plugin-putout';
2
3export default recommended;

Or with defineConfig:

1import {defineConfig} from 'eslint/config';
2import putout from 'eslint-plugin-putout';
3
4export default defineConfig({
5    plugins: {
6        putout,
7    },
8    extends: [
9        "putout/recommended",
10    ]
11});

Then configure the rules you want to use under the rules section.

1{
2    "rules": {
3        "putout/add-newlines-between-types-in-union": "error",
4        "putout/add-newlines-between-specifiers": "error",
5        "putout/add-newline-before-return": "error",
6        "putout/add-newline-before-function-call": "error",
7        "putout/add-newline-after-function-call": "error",
8        "putout/putout": "error",
9        "putout/array-element-newline": "error",
10        "putout/single-property-destructuring": "error",
11        "putout/multiple-properties-destructuring": "error",
12        "putout/long-properties-destructuring": "error",
13        "putout/destructuring-as-function-argument": "error",
14        "putout/align-spaces": "error",
15        "putout/newline-function-call-arguments": "error",
16        "putout/function-declaration-paren-newline": "error",
17        "putout/remove-newline-after-default-import": "error",
18        "putout/remove-newline-between-declarations": "error",
19        "putout/remove-newline-from-empty-object": "error",
20        "putout/remove-empty-newline-before-first-specifier": "error",
21        "putout/remove-empty-newline-after-last-specifier": "error",
22        "putout/remove-empty-newline-after-last-element": "error",
23        "putout/remove-empty-newline-after-import": "error",
24        "putout/remove-empty-specifiers": "error",
25        "putout/objects-braces-inside-array": "error",
26        "putout/object-property-newline": "error",
27        "putout/tape-add-newline-between-tests": "error",
28        "putout/tape-add-newline-before-assertion": "error",
29        "putout/tape-remove-newline-before-t-end": "error"
30    }
31}

Rules

🐊 Putout

• ✅ Putout
• ✅ Evaluate

📼 Supertape

• ✅ add newline before assertion
• ✅ add newline between tests
• ✅ remove newline before t.end()

TypeScript

• ✅ Add newlines between types in union
• ✅ Object property newline

ESM

• ✅ No unresolved
• ✅ Remove duplicate extension
• ✅ Add newlines between specifiers

Formatting

• ✅ Add newline before return
• ✅ Add newline before function call
• ✅ Add newline after function call
• ✅ Align spaces
• ✅ Array element newline
• ✅ Single property destructuring
• ✅ Multiple properties destructuring
• ✅ For-of multiple properties destructuring
• ✅ Long properties destructuring
• ✅ Destructuring as function argument
• ✅ Newline function call arguments
• ✅ Function declaration paren newline
• ✅ Remove newline between declarations
• ✅ Remove newline after default import
• ✅ Remove newline from empty object
• ✅ Remove empty newline before first specifier
• ✅ Remove empty newline after last specifier
• ✅ Remove empty newline after last element
• ✅ Remove empty newline after import
• ✅ Remove empty specifiers
• ✅ Objects braces inside array
• ✅ Nonblock statement body newline

Safe mode

When using 🐊Putout in IDE with --fix on save, or when you want to disable the most dangerous rules, use:

1import {safe} from 'eslint-plugin-putout';
2
3export default safe;

Disabled ESLint rules:

• ❌ no-useless-return
• ❌ no-implicit-coercion
• ❌ putout/remove-newline-from-empty-object

Disabled 🐊Putout rules:

• ❌ apply-template-literals;
• ❌ convert-template-to-string;
• ❌ remove-empty;
• ❌ merge-duplicate-functions;
• ❌ nodejs/remove-process-exit;
• ❌ remove-unused-variables;
• ❌ typescript/remove-unused-types;
• ❌ remove-unused-expressions;
• ❌ remove-unreferenced-variables;
• ❌ remove-useless-arguments;
• ❌ return/remove-useless;
• ❌ remove-useless-spread;
• ❌ remove-useless-variables;
• ❌ tape/remove-skip;
• ❌ tape/remove-only;
• ❌ remove-console;
• ❌ remove-debugger;
• ❌ remove-unreachable-code;
• ❌ for-of/for;
• ❌ for-of/remove-useless;
• ❌ for-of/remove-unused-variables;
• ❌ maybe/noop;
• ❌ remove-useless-push;

safeAlign

When you want to enable ability to align spaces on empty lines, while have all benefits of safe preset: use safeAlign.

jsx

When you need to support jsx in files using js extension, use:

1import {jsx} from 'eslint-plugin-putout;
2
3export default jsx;

License

MIT