putout 19.7.1 → 20.2.0

package/ChangeLog

@@ -1,3 +1,80 @@
+2021.09.16, v20.2.0
+
+fix:
+- chore(nycrc) exclude: fixture -> *fixture
+
+feature:
+- (eslint-plugin-putout) no-resolve: add support of import directory
+- (putout) export putout/eslint
+- (eslint-plugin-putout) add no-unresolved
+- (@putout/plugin-declare-undefined-variables) add support of basename, dirname, extname from path
+- (package) @putout/plugin-remove-useless-async v4.0.0
+- (@putout/plugin-remove-useless-async) drop support of node < 14
+- (@putout/plugin-remove-useless-async) report: Useless async should be avoided -> Avoid useless async
+- (@putout/plugin-declare-undefined-variables) add support of reImport, stopAll
+- (@putout/plugin-remove-duplicate-keys) add support of rename while destructuring
+- (eslint-plugin-putout) safe: disable remove-unused-for-of-variables
+
+
+2021.09.15, v20.1.0
+
+fix:
+- (eslint-plugin-putout) putout/ide -> putout/safe
+
+feature:
+- (help) improve help (#81) (thanks a lot to @egilll 🎉!)
+- (@putout/plugin-declare-undefined-variables) add support of Object.keys
+- (@putout/plugin-tape) add convert-called-with-args
+- (@putout/engine-loader) add ☝️  when cannot determine plugin type
+- (@putout/engine-runner) add support of "include" not a function in Includer
+- (package) @putout/plugin-eslint v2.0.0
+- (@putout/plugin-eslint) drop support of putout < 20
+- (@putout/plugin-eslint) add convert-ide-to-safe
+
+
+2021.09.12, v20.0.1
+
+fix:
+- (eslint-plugin-putout) putout/ide -> putout/safe
+
+feature:
+- (package) @putout/plugin-eslint v2.0.0
+- (@putout/plugin-eslint) drop support of putout < 20
+- (@putout/plugin-eslint) add covert-ide-to-safe
+- (@putout/engine-loader) parse-rules: validation: add ☝️
+- (package) eslint-plugin-putout v10.0.0
+
+
+2021.09.12, v20.0.0
+
+fix:
+- (eslint-plugin-putout) package: description: plagin -> plugin
+- (putout) export: putout/lib/parse-options -> putout/parse-options (#48)
+- (@putout/plugin-putout-config) examples
+- (@putout/test) homepage
+- (@putout/engine-runner) rm "☝️  " -> "☝️""
+- docs(@putout/test) add Autofix
+
+feature:
+- (putout) eslint-plugin-putout v10.0.0
+- (eslint-plugin-putout) drop support of putout < 20
+- (putout) add ability to import exit codes enum
+- (package) improve description
+- (putout) help: remove enabled by default options
+- (putout) cli: add `🐊` to error messages
+- (putout) cli: add ability to exit with error when ruler toggler used without a path
+- (@putout/plugin-putout-config) add remove-empty
+- (@putout/plugin-putout) add apply-processors-destructuring
+- (@putout/engine-runner) add ☝️
+- (@putout/plugin-putout) add convert-traverse-to-replace
+- (@putout/engine-runner) improve error message when visitor provided to Traverser is not a function (https://github.com/coderaiser/putout/tree/v19.7.1/packages/engine-runner#traverser)
+- (eslint-plugin-putout) ide: disable remove-unused-expressions
+- (@putout/plugin-tape) add convert-called-with-no-args-to-called-with
+- (@putout/plugin-putout) check-replace-code: __array: add support of CallExpression
+- (@putout/engine-loader) validate-rules: throw when passing options to nested plugin (instead of go nowhere) (coderaiser/estrace#4)
+- (@putout/engine-runner) throw error when no visitor
+
+
 2021.09.05, v19.7.1
 
 fix:

package/README.md

@@ -107,28 +107,26 @@ npm i putout -D
 
 ```
 Usage: putout [options] [path]
-Options
+Options:
    -h, --help                  display this help and exit
    -v, --version               output version information and exit
-   -f, --format                use a specific output format - default: progress-bar/dump on CI
+   -f, --format [formatter]    use a specific output format, the default is: 'progress-bar' localy and 'dump' on CI
    -s, --staged                add staged files when in git repository
    --fix                       apply fixes of errors to code
-   --fix-count                 count of fixes rounds (defaults to 10)
+   --fix-count [count = 10]    count of fixes rounds
    --rulesdir                  use additional rules from directory
-   --transform                 apply inline transform
-   --plugins                   plugins to use splited by comma
-   --enable                    enable rule by name in .putout.json
-   --disable                   disable rule by name in .putout.json
-   --enable-all                enable all rules in .putout.json
-   --disable-all               disable all rules in .putout.json
-   --match                     read .putout.json and convert "rules" to "match" using pattern
+   --transform [replacer]      apply Replacer, for example 'var __a = __b -> const __a = __b', read about Replacer https://git.io/JqcMn
+   --plugins [plugins list]    a comma-separated list of plugins to use
+   --enable [rule]             enable the rule and save it to '.putout.json' walking up parent directories
+   --disable [rule]            disable the rule and save it to '.putout.json' walking up parent directories
+   --enable-all                enable all found rules and save them to '.putout.json' walking up parent directories
+   --disable-all               disable all found rules (set baseline) and save them '.putout.json' walking up parent directories
+   --match [file name]         read .putout.json and convert 'rules' to 'match' using pattern
    --flow                      enable flow
-   --no-flow                   disable flow (default)
-   --cache                     enable cache to speed up processing (default)
    --fresh                     generate a fresh cache
-   --no-config                 avoid reading config file (.putout.json)
-   --no-ci                     disable CI detection
-   --no-cache                  disable cache
+   --no-config                 avoid reading '.putout.json'
+   --no-ci                     disable the CI detection
+   --no-cache                  disable the cache
 ```
 
 To find erros:

package/help.json

@@ -1,24 +1,22 @@
 {
     "-h, --help                 ": "display this help and exit",
     "-v, --version              ": "output version information and exit",
-    "-f, --format               ": "use a specific output format - default: progress-bar/dump on CI",
+    "-f, --format [formatter]   ": "use a specific output format, the default is: 'progress-bar' localy and 'dump' on CI",
     "-s, --staged               ": "add staged files when in git repository",
     "--fix                      ": "apply fixes of errors to code",
-    "--fix-count                ": "count of fixes rounds (defaults to 10)",
+    "--fix-count [count = 10]   ": "count of fixes rounds",
     "--rulesdir                 ": "use additional rules from directory",
-    "--transform                ": "apply inline transform",
-    "--plugins                  ": "plugins to use splited by comma",
-    "--enable                   ": "enable rule by name in .putout.json",
-    "--disable                  ": "disable rule by name in .putout.json",
-    "--enable-all               ": "enable all rules in .putout.json",
-    "--disable-all              ": "disable all rules in .putout.json",
-    "--match                    ": "read .putout.json and convert \"rules\" to \"match\" using pattern",
+    "--transform [replacer]     ": "apply Replacer, for example 'var __a = __b -> const __a = __b', read about Replacer https://git.io/JqcMn",
+    "--plugins [plugins list]   ": "a comma-separated list of plugins to use",
+    "--enable [rule]            ": "enable the rule and save it to '.putout.json' walking up parent directories",
+    "--disable [rule]           ": "disable the rule and save it to '.putout.json' walking up parent directories",
+    "--enable-all               ": "enable all found rules and save them to '.putout.json' walking up parent directories",
+    "--disable-all              ": "disable all found rules (set baseline) and save them '.putout.json' walking up parent directories",
+    "--match [file name]        ": "read .putout.json and convert 'rules' to 'match' using pattern",
     "--flow                     ": "enable flow",
-    "--no-flow                  ": "disable flow (default)",
-    "--cache                    ": "enable cache to speed up processing (default)",
     "--fresh                    ": "generate a fresh cache",
-    "--no-config                ": "avoid reading config file (.putout.json)",
-    "--no-ci                    ": "disable CI detection",
-    "--no-cache                 ": "disable cache"
+    "--no-config                ": "avoid reading '.putout.json'",
+    "--no-ci                    ": "disable the CI detection",
+    "--no-cache                 ": "disable the cache"
 
 }

package/lib/cli/exit-codes.js

@@ -12,5 +12,6 @@ module.exports = {
     CANNOT_LOAD_PROCESSOR: 8,
     UNHANDLED: 9,
     RULLER_WITH_FIX: 10,
+    RULLER_NO_FILES: 11,
 };
 

package/lib/cli/exit-codes.mjs

@@ -0,0 +1,13 @@
+export const OK = 0;
+export const PLACE = 1;
+export const STAGE = 2;
+export const NO_FILES = 3;
+export const NO_PROCESSORS = 4;
+export const NO_FORMATTER = 5;
+export const WAS_STOP = 6;
+export const INVALID_OPTION = 7;
+export const CANNOT_LOAD_PROCESSOR = 8;
+export const UNHANDLED = 9;
+export const RULLER_WITH_FIX = 10;
+export const RULLER_NO_FILES = 11;
+

package/lib/cli/help.js

@@ -5,7 +5,7 @@ module.exports = () => {
     const usage = 'Usage: putout [options] [path]';
     const result = [
         usage,
-        'Options',
+        'Options: ',
     ];
     
     for (const name of Object.keys(bin)) {

package/lib/cli/index.js

@@ -47,6 +47,7 @@ const {
     INVALID_OPTION,
     UNHANDLED,
     RULLER_WITH_FIX,
+    RULLER_NO_FILES,
 } = require('./exit-codes');
 
 const cwd = process.cwd();
@@ -257,7 +258,12 @@ module.exports = async ({argv, halt, log, write, logError, readFile, writeFile})
     if (e)
         return exit(NO_FILES, e);
     
-    if (!names.length)
+    const noFiles = !names.length;
+    
+    if (noFiles && (enableAll || disableAll))
+        return exit(RULLER_NO_FILES, Error('`path` is missing for ruler toggler (`--enable-all`, `--disable-all`)'));
+    
+    if (noFiles)
         return exit();
     
     const fileCache = await cacheFiles({
@@ -424,7 +430,7 @@ const getExit = ({halt, raw, logError}) => (code, e) => {
     if (!e)
         return halt(code);
     
-    const message = raw ? e : red(e.message || e);
+    const message = raw ? e : red(`🐊 ${e.message || e}`);
     
     logError(message);
     halt(code);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "putout",
-  "version": "19.7.1",
+  "version": "20.2.0",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
-  "description": "the pluggable code transformer",
+  "description": "🐊 Pluggable and configurable code transformer with built-in eslint, babel plugins and jscodeshift codemods support of js, jsx typescript, flow files, markdown, yaml and json",
   "homepage": "http://github.com/coderaiser/putout",
   "main": "./lib/putout.js",
   "exports": {
@@ -12,10 +12,11 @@
     },
     "./parse-options": "./lib/parse-options/index.js",
     "./parse-error": "./lib/cli/parse-error.js",
-    "./lib/parse-options": "./lib/parse-options/index.js",
     "./process-file": "./lib/cli/process-file.js",
+    "./exit-codes": "./lib/cli/exit-codes.mjs",
     "./cli": "./lib/cli/index.js",
     "./loader": "./lib/loader.js",
+    "./eslint": "./lib/cli/eslint/index.js",
     "./package.json": "./package.json"
   },
   "bin": {
@@ -97,7 +98,7 @@
     "@putout/plugin-convert-to-arrow-function": "^3.0.0",
     "@putout/plugin-convert-top-level-return": "^4.0.0",
     "@putout/plugin-declare-undefined-variables": "^2.0.0",
-    "@putout/plugin-eslint": "^1.0.0",
+    "@putout/plugin-eslint": "^2.0.0",
     "@putout/plugin-extract-object-properties": "^6.0.0",
     "@putout/plugin-extract-sequence-expressions": "^2.0.0",
     "@putout/plugin-github": "^1.0.0",
@@ -217,7 +218,7 @@
     "currify": "^4.0.0",
     "eslint": "^8.0.0-beta.0",
     "eslint-plugin-node": "^11.0.0",
-    "eslint-plugin-putout": "^9.0.0",
+    "eslint-plugin-putout": "^10.0.0",
     "just-camel-case": "^4.0.2",
     "lerna": "^4.0.0",
     "madrun": "^8.6.0",