@putout/engine-loader

????Putout loader for plugins and processors.

Install

npm i @putout/engine-loader

Plugins

Loader supports two kinds of plugins:

☝️ Simple
☝️ Nested

Simple Plugin

Simplest type of plugin support by @putout/engine-runner, contains one rule.

Nested Plugin

Nested contains one or more rules:

import * as removeDebugger from '@putout/plugin-remove-debugger';

export const rules = {
    'remove-debugger': removeDebugger,
};

When you want to make it disabled by default, use:

import * as removeDebugger from '@putout/plugin-remove-debugger';

export const rules = {
    'remove-debugger': ['off', removeDebugger],
};

So when someone using your plugin, he needs to enable it:

{
    "rules": {
        "nested/remove-debugger": "on"
    },
    "plugins": ["nested"]
}

Env Variables

When you need to get things working with Yarn OnP, and using custom plugins formatters or processors, add env variable PUTOUT_YARN_PNP with name of a package that contains dependencies you need.

If you want to load from custom directory (for Visual Studio Code Extension, for example) use PUTOUT_LOAD_DIR.

API

loadPlugins

import {loadPlugins} from '@putout/engine-loader';

const pluginNames = [
    'remove-unusede-variables',
];

const rules = {
    'remove-unused-variables': 'on',
};

const plugins = loadPlugins({
    pluginNames,
    rules,
});

`import`

You can also use schema like this one:

import:escover/plugin

const plugins = loadPlugins({
    pluginNames: [
        'import:commonjs-putout-plugin',
    ],
});

loadPluginsAsync

Load ESM plugins:

import {loadPluginsAsync} from '@putout/engine-loader';

const pluginNames = [
    'remove-unusede-variables',
];

const rules = {
    'remove-unused-variables': 'on',
};

const plugins = await loadPluginsAsync({
    pluginNames,
    rules,
});

`import`

You can also use schema like this one:

import:escover/plugin

const plugins = await loadPluginsAsync({
    pluginNames: [
        'import:escover/plugin',
    ],
});

Or when used putoutAsync:

import {putoutAsync} from 'putout';

await putoutAsync(`module.exports.hello = 'world'`, {
    plugins: [
        'import:escover/plugin',
    ],
});

Which is the same as:

import {putoutAsync} from 'putout';
import * as plugin from 'escover/plugin';

await putoutAsync(`module.exports.hello = 'world'`, {
    plugins: [
        ['escover/plugin', plugin],
    ],
});

Or used inside .putout.json:

{
    "plugins": [
        "import:escover/plugin"
    ]
}

loadProcessorsAsync

import {loadProcessors} from '@putout/engine-loader';

const optionalLoad = async (a) => await import(a);

const plugins = await loadProcessorsAsync({
    processors: [
        ['javascript', 'on'],
        ['markdown', 'off'],
    ],
}, optionalLoad);

createAsyncLoader

Gives ability to create loader for processor or formatter.

import {createAsyncLoader} from '@putout/engine-loader';

const {loadProcessor} = createAsyncLoader('processor');

// load @putout/processor-markdown
await loadProcessors('markdown');
// load @putout/processor-json using custom loader
await loadProcess('json', () => {
    return Promise.resolve(`will be called instead of 'import'`);
});

validateRules

import {validateRules} from '@putout/engine-loader';

const pluginNames = [];
const rules = {
    'remove-unused-variables': 'on',
};

validateRules({
    pluginNames,
    rules,
});

// throws since there is no plugin name passed that matches rule 'remove-unused-variables'

@putout/engine-loader

Install

Plugins

Simple Plugin

Nested Plugin

Env Variables

API

loadPlugins

`import`

loadPluginsAsync

`import`

loadProcessorsAsync

createAsyncLoader

validateRules

License

Current Tags

119 Versions