putout 31.2.4 → 31.4.0

package/ChangeLog

@@ -1,3 +1,28 @@
+2023.08.24, v31.4.0
+
+fix:
+- 343c7448c @putout/engine-loader: loadPluginsAsync: disabled rule
+
+feature:
+- d239cf375 package: @putout/plugin-remove-useless-arguments v8.0.0
+- d9d55fab2 @putout/plugin-remove-useless-arguments: drop support of 🐊 < 31
+- bf4dd6331 @putout/plugin-remove-useless-arguments: destructuring: params length
+- c186080fa @putout/plugin-travis: convert to ESM
+- 3423767ec putout: add support of ESM plugins
+- c91c3d2a1 @putout/engine-loader: loadPluginsAsync: speed up with memoize
+- 5b67c34a1 @putout/plugin-putout: apply-namespace-speicifier: exclude alot imports
+
+2023.08.23, v31.3.0
+
+feature:
+- 783861f83 package: @putout/plugin-apply-entries v2.0.0
+- 137145031 putout: add putoutAsync
+- 347e572ad @putout/plugin-apply-entries: ESM
+- 66aecbf55 @putout/plugin-apply-namespace-specifier: create-test
+- e0be94d96 @putout/plugin-putout: apply-namespace-specifier: rules
+- 66434fb93 @putout/engine-loader: add loadPluginsAsync
+- 890558e38 eslint-plugin-putout: putout: esm
+
 2023.08.22, v31.2.4
 
 feature:

package/README.md

@@ -291,6 +291,28 @@ console.log(t);
 `;
 ```
 
+### putoutAsync(source, options)
+
+```js
+const {putoutAsync} = require('putout');
+
+const source = `
+    const t = 'hello';
+    const m = t + '!';
+    console.log(t);
+`;
+
+await putoutAsync(source, {
+    plugins: ['remove-unused-variables'],
+});
+
+// returns
+`
+const t = 'hello';
+console.log(t);
+`;
+```
+
 ## License
 
 MIT

package/lib/cli/process-file.js

@@ -1,8 +1,8 @@
 'use strict';
 
-const tryCatch = require('try-catch');
+const tryToCatch = require('try-to-catch');
 
-const putout = require('../..');
+const {putoutAsync} = require('../..');
 const merge = require('../merge');
 const parseMatch = require('../parse-options/parse-match');
 
@@ -20,7 +20,7 @@ module.exports = ({fix, fixCount, isFlow, logError, raw, printer}) => async ({na
     const isTS = /\.tsx?$/.test(name) || /{tsx?}$/.test(name);
     const matchedOptions = getMatchedOptions(name, options);
     
-    const [e, result] = tryCatch(putout, source, {
+    const [e, result] = await tryToCatch(putoutAsync, source, {
         fix,
         fixCount,
         isTS,

package/lib/putout-async.js

@@ -0,0 +1,160 @@
+'use strict';
+
+const {traverse, types} = require('@putout/babel');
+
+const loader = require('@putout/engine-loader');
+const runner = require('@putout/engine-runner');
+
+const {
+    parse,
+    print,
+    generate,
+    template,
+} = require('@putout/engine-parser');
+
+const {cutShebang, mergeShebang} = require('./shebang');
+
+const isString = (a) => typeof a === 'string';
+
+const defaultOpts = (opts = {}) => {
+    const {
+        parser = 'babel',
+        printer = opts.printer || 'putout',
+        fix = true,
+        fixCount = 2,
+        loadPlugins = loader.loadPlugins,
+        loadPluginsAsync = loader.loadPluginsAsync,
+        runPlugins = runner.runPlugins,
+    } = opts;
+    
+    return {
+        ...opts,
+        parser,
+        printer,
+        fix,
+        fixCount,
+        loadPlugins,
+        loadPluginsAsync,
+        runPlugins,
+    };
+};
+
+module.exports.putoutAsync = async (source, opts) => {
+    check(source);
+    opts = defaultOpts(opts);
+    
+    const {
+        parser,
+        isTS,
+        isFlow,
+        isJSX,
+        sourceFileName,
+        sourceMapName,
+        printer,
+    } = opts;
+    
+    const [clearSource, shebang] = cutShebang(source);
+    
+    const ast = parse(clearSource, {
+        sourceFileName,
+        parser,
+        isTS,
+        isFlow,
+        isJSX,
+        printer,
+    });
+    
+    const places = await transform(ast, source, opts);
+    
+    if (!opts.fix)
+        return {
+            code: source,
+            places,
+        };
+    
+    const printed = print(ast, {
+        sourceMapName,
+        printer,
+    });
+    
+    const code = mergeShebang(shebang, printed);
+    
+    return {
+        code,
+        places,
+    };
+};
+
+module.exports.findPlaces = async (ast, source, opts) => {
+    return await transform(ast, source, {
+        ...opts,
+        fix: false,
+    });
+};
+
+// why we pass 'source' to 'transform()'?
+// because we need to calculate position in a right way
+// and determine is shebang is exists
+//
+// 25     return {¬
+// 26         line: shebang ? line + 1 : line,¬
+// 27         column,¬
+// 28     };¬
+//
+module.exports.transform = transform;
+async function transform(ast, source, opts) {
+    opts = defaultOpts(opts);
+    
+    const {
+        plugins: pluginNames,
+        cache,
+        rules,
+        fix,
+        fixCount,
+        loadPluginsAsync,
+        runPlugins,
+    } = opts;
+    
+    const [, shebang] = cutShebang(source);
+    
+    const plugins = await loadPluginsAsync({
+        pluginNames,
+        cache,
+        rules,
+    });
+    
+    const places = runPlugins({
+        ast,
+        shebang,
+        fix,
+        fixCount,
+        plugins,
+    });
+    
+    return places;
+}
+
+module.exports.parse = parse;
+module.exports.print = print;
+module.exports.traverse = traverse;
+module.exports.types = types;
+module.exports.template = template;
+module.exports.generate = generate;
+module.exports.initReport = require('./cli/report');
+
+module.exports.operator = {
+    ...require('@putout/operate'),
+    ...require('@putout/compare'),
+    ...require('@putout/traverse'),
+    ...require('@putout/operator-declare'),
+    ...require('@putout/operator-regexp'),
+    ...require('@putout/operator-add-args'),
+};
+
+module.exports.ignores = require('./ignores');
+module.exports.codeframe = require('./codeframe');
+
+function check(source) {
+    if (!isString(source))
+        throw Error(`☝️ Looks like 'source' has type '${typeof source}', expected: 'string'`);
+}

package/lib/putout.js

@@ -13,6 +13,7 @@ const {
 } = require('@putout/engine-parser');
 
 const {cutShebang, mergeShebang} = require('./shebang');
+const {putoutAsync} = require('./putout-async');
 
 const isString = (a) => typeof a === 'string';
 
@@ -83,6 +84,8 @@ module.exports = (source, opts) => {
     };
 };
 
+module.exports.putoutAsync = putoutAsync;
+
 module.exports.findPlaces = (ast, source, opts) => {
     return transform(ast, source, {
         ...opts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "putout",
-  "version": "31.2.4",
+  "version": "31.4.0",
   "type": "commonjs",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "🐊 Pluggable and configurable code transformer with built-in ESLint, Babel and support of js, jsx, typescript, flow, markdown, yaml and json",
@@ -134,7 +134,7 @@
     "@putout/plugin-remove-unused-for-of-variables": "^3.0.0",
     "@putout/plugin-remove-unused-private-fields": "^2.0.0",
     "@putout/plugin-remove-unused-variables": "^6.0.0",
-    "@putout/plugin-remove-useless-arguments": "^7.0.0",
+    "@putout/plugin-remove-useless-arguments": "^8.0.0",
     "@putout/plugin-remove-useless-array-constructor": "^2.0.0",
     "@putout/plugin-remove-useless-array-entries": "^1.0.0",
     "@putout/plugin-remove-useless-assign": "^1.0.0",
@@ -201,6 +201,7 @@
     "unused"
   ],
   "devDependencies": {
+    "@putout/plugin-apply-entries": "^2.0.0",
     "c8": "^8.0.0",
     "currify": "^4.0.0",
     "escover": "^3.2.2",