jsir 2.1.4 → 2.1.6

package/README.md

@@ -0,0 +1,49 @@
+# jsir: JavaScript Script Management Tool
+
+**jsir** is a command line tool designed to help manage and organize your JavaScript files. With **jsir**, you can edit, run, and compare JavaScript files, view file dependencies, and switch between different workspaces.
+
+## Installation
+
+You can install **jsir** globally using npm:
+
+```
+npm install -g jsir
+```
+
+## Getting Started
+
+To start using **jsir**, simply run the command:
+
+```
+jsir
+```
+
+This will open the **jsir** REPL interface where you can start managing your files.
+
+## Commands
+
+Here is a list of available commands in **jsir**:
+
+| Keyword | Short | Comment |
+| --- | --- | --- |
+| .add | .a | Add file |
+| .clear | .C | Clear task |
+| .compare | .c | Compare files |
+| .deps | .d | View file dependencies |
+| .edit | .e | Edit file |
+| .file | .f | Working file mode |
+| .get | .g | Get file |
+| .help | .h | Help documentation |
+| .list | .l | View file list |
+| .quit | .q | Exit |
+| .rename | .n | Rename file |
+| .repl | .p | Interactive interface |
+| .rm | .R | Remove file |
+| .run | .r | Quick execution |
+| .see | .s | View file |
+| .switch | .S | Switch workspace |
+| .uninstall | .u | Uninstall workspace |
+| .version | .v | View version |
+| .workspace | .w | Workspace Management |
+
+For detailed information on how to use each command, use the `.help` command followed by the short keyword of the command.

package/cmd/oaa.js

@@ -3,10 +3,10 @@ const $lib = require('../deps/util');
 const {
     getLibDataDir, trim, regEach, getConfig, mkdir, reget,
     getCbText, e, sleep, objDataFile, vl, md5, BigNumber,
-    info, warn, error, arrayDataFile, infoStr, warnStr, errorStack,
+    arrayDataFile, infoStr, warnStr, errorStack,
     getInfo, ei, pad, msgStr, getType,
     errorTag, isArgsMatch, draftQuery, setConfig,
-    $log, $draft, getTextComments, getOr, importG
+    $log, $draft, getTextComments, getOr, importG, requireG
 } = $lib;
 const _args = process.argv.slice(2).map(trim);
 const evalCode = require('../deps/evalCode')
@@ -15,8 +15,8 @@ const _chokidar = require('chokidar');
 const setting = require('../deps/setting')
 const _fs = require('fs')
 const readline = require("readline");
-const {requireG} = require("../deps/util");
-
+const packageJson = require("../package.json");
+const example = require("../deps/example");
 const _workspaceConfigFile = 'workspace.json';
 const _libDataDir = getLibDataDir()
 const _tipsOnRm = {}
@@ -30,43 +30,55 @@ const $config = {
     get: getConfig,
     set: setConfig
 }
+const CONSOLE = Object.assign({}, console);
+const info = (msg) => $lib.info(msg, CONSOLE);
+const warn = (msg) => $lib.warn(msg, CONSOLE);
+const error = (msg, tag) => $lib.error(msg, tag, CONSOLE);
 
 let _cmdMapFile = setting.name + 'CmdMap.json'
 let _cmdMap = {}
 let _rl
 let _rlHistory = []
 let _haveWrapperInput = true
-let _exit = false
 let _noAppendNextLine = true
 
-const _onGetMap = {}
+const _onLazyGetMap = {}
 const _data = {}
-const _tempTime = 60 * 1000
-const _dealOnGet = (key) => {
-    if (_noAppendNextLine || !_onGetMap[key]) {
+const _lazyTime = 5 * 60 * 1000
+const _dealOnLazyGet = (key) => {
+    if (_noAppendNextLine || !_onLazyGetMap[key]) {
         return _data[key]
     }
-    let item = _onGetMap[key]
+    let item = _onLazyGetMap[key]
     if (Date.now() <= item.startTime) {
-        item.startTime = Date.now() + _tempTime
+        item.startTime = Date.now() + _lazyTime
         return _data[key]
     }
-    let flag = _onGetMap[key].fn()
+    let flag = _onLazyGetMap[key].fn()
     if (getType(flag)=== 'Promise') {
         return new Promise(async (resolve, reject) => {
             try {
                 await flag
-                item.startTime = Date.now() + _tempTime
+                item.startTime = Date.now() + _lazyTime
                 resolve(_data[key])
             } catch (e) {
                 reject(e)
             }
         })
     } else {
-        item.startTime = Date.now() + _tempTime
+        item.startTime = Date.now() + _lazyTime
         return _data[key]
     }
 }
+const _dataSet = (key, val, onLazyGet) => {
+    if (onLazyGet) {
+        _onLazyGetMap[key] = {
+            fn: onLazyGet,
+            startTime: Date.now() + _lazyTime
+        }
+    }
+    return _data[key] = val
+}
 const $data = {
     get: (key, defaultVal) => {
         if (!vl(_data[key])) {
@@ -76,34 +88,26 @@ const $data = {
                 return _data[key]
             }
         }
-        return _dealOnGet(key)
+        return _dealOnLazyGet(key)
     },
-    gos: (key, defaultVal) => {
+    gos: (key, defaultVal, onLazyGet) => {
         if (!vl(_data[key])) {
             if (defaultVal !== undefined) {
-                _data[key] = defaultVal
-                return defaultVal
+                return _dataSet(key, defaultVal, onLazyGet)
             } else {
                 return _data[key]
             }
         }
-        return _dealOnGet(key)
-    },
-    set: (key, val, onGet) => {
-        if (onGet) {
-            _onGetMap[key] = {
-                fn: onGet,
-                startTime: Date.now() + _tempTime
-            }
-        }
-        return _data[key] = val
+        return _dealOnLazyGet(key)
     },
+    set: _dataSet,
     del: (key) => {
         let val = _data[key]
         delete _data[key]
         return val
     },
-    keys: () => Object.keys(_data)
+    keys: () => Object.keys(_data),
+    have: (key) => vl(_data[key])
 }
 const $homeDir = getLibDataDir()
 
@@ -171,7 +175,7 @@ async function getFileWatcher(workFilePath, text) {
         _fs.writeFileSync(workFilePath, text)
         let watcher = _chokidar.watch([workFilePath]);
         _fileWatcherMap[workFilePath] = watcher;
-        setTips("FILE", "FILE", () => {
+        setTips("FILE", null, () => {
             Object.keys(_fileWatcherMap).forEach(closeFileWatcher);
         })
         return watcher
@@ -209,7 +213,7 @@ async function watchFile(uniqueName) {
             text = newText;
             if (trim(exeStr)) {
                 try {
-                    console.log("\n" + infoStr("------ workFile run ------"))
+                    CONSOLE.log("\n" + infoStr("------ workFile run ------"))
                     await wrapperInput("# " + exeStr)
                 } catch (e) {
                     error(e)
@@ -270,13 +274,18 @@ function getExeStr(oldText, newText) {
     }
 }
 
-async function nextLine(callback, preStr, hidden) {
+async function nextLine(callback, promptStr, hidden) {
     return new Promise(resolve => {
-        _nextLine(callback, preStr, hidden, resolve)
+        _nextLine(callback, promptStr, hidden, resolve)
     })
 }
 
-function initRl(callback, preStr, hidden) {
+function defaultPromptStr(showKey = false) {
+    return [getTipStr(showKey), $defaultSpace].filter(i => i).join(':') + `> `;
+}
+
+function initRl(callback, promptStr, hidden) {
+    let origin_writeToOutput;
     if (!_rl) {
         _rl = readline.createInterface({
             input: process.stdin,
@@ -284,8 +293,10 @@ function initRl(callback, preStr, hidden) {
         })
         _rl.on("SIGINT", async () => {
             if (_noAppendNextLine) {
+                delTips();
                 process.exit(0);
             } else {
+                _rl._writeToOutput = origin_writeToOutput;
                 _haveWrapperInput = true;
                 _rl.clearLine(0)
                 nextLine();
@@ -293,12 +304,11 @@ function initRl(callback, preStr, hidden) {
         });
         _rl.history = _rlHistory
     }
-
-    let promptStr = preStr
+    origin_writeToOutput = _rl._writeToOutput
     if (promptStr !== '') {
-        promptStr = (preStr
+        promptStr = (promptStr
             || ((callback && callback !== wrapperInput) ? "-> ":"")
-            || [Object.values(global.$tips).map(trim).filter(i => i).map(i => i.replace(/,/g, '-')).join(','), $defaultSpace].filter(i => i).join(':') + `> `)
+            || defaultPromptStr())
         promptStr = infoStr(promptStr)
     }
     if (hidden) {
@@ -318,69 +328,88 @@ function initRl(callback, preStr, hidden) {
     _rl.setPrompt(promptStr);
 }
 
+function getTipStr(showKey = false) {
+    let items = [];
+    for (let key of Object.keys(global.$tips)) {
+        let val = global.$tips[key].map(i => trim(i).replace(/,/g, '-')).join("|");
+        key = trim(key)
+
+        let item
+        if (!showKey && vl(val)) {
+            item = val;
+        } else if (vl(key)) {
+            item = key
+        }
+        if (item) {
+            items.push(item)
+        }
+    }
+    return items.join(',');
+}
+
 function closeRl() {
     _rlHistory = _rl.history;
     _rl.close();
     _rl = null;
 }
 
-function _nextLine(callback, preStr, hidden, resolve, end) {
+function _nextLine(callback, promptStr, hidden, resolve, end, isText) {
     end = trim(end)
     if (!_haveWrapperInput) {
         return
     }
-    initRl(callback, preStr, hidden);
+    initRl(callback, promptStr, hidden);
     _haveWrapperInput = false
     let inputStr = ''
-    let lineHander = async line => {
+    let lineHandler = async line => {
         let textLine = line
         line = trim(line)
-        if (end) {
-            if (line !== end) {
+        if (isText) {
+            if (!end) {
+                end = line
+                line = ''
+            } else if (line !== end) {
                 inputStr += textLine + '\n'
             }
         } else {
             inputStr = line
-            if (/^\s+$/.test(textLine) && (!callback || wrapperInput === callback)) {
-                process.stdout.write('\033[2J\033[H');
-                listCmd();
-            }
         }
-        if (line && (hidden || (callback && callback !== wrapperInput))) {
+        if (trim(textLine) && (hidden || (callback && callback !== wrapperInput))) {
             _rl.history = _rl.history.slice(1)
         }
-        if (!end || line === end) {
+        if (!isText || line === end) {
             _haveWrapperInput = true;
             closeRl()
             inputStr = inputStr.replace(/\s+$/, '');
 
             let pro = (callback || wrapperInput)(inputStr);
-
             resolve && resolve(inputStr);
-            let currCallback = callback;
-            callback = null;
-            hidden = false;
-            end = null;
-            inputStr = '';
-
             try {
                 await pro;
             } finally {
-                if ((currCallback || wrapperInput) === wrapperInput) {
-                    _noAppendNextLine || nextLine()
+                if ((callback || wrapperInput) === wrapperInput) {
+                    if (!_noAppendNextLine) {
+                        if (/^\s+$/.test(textLine)) {
+                            process.stdout.write('\033[2J\033[H');
+                            listCmd();
+                            nextLine(null, defaultPromptStr(true))
+                        } else {
+                            nextLine()
+                        }
+                    }
                 }
             }
         }
     }
 
     _rl.removeAllListeners('line')
-    _rl.on('line', lineHander)
+    _rl.on('line', lineHandler)
     _rl.prompt()
 }
 
 async function nextText(callback, end, hidden) {
     return new Promise(resolve => {
-        _nextLine(callback, '', hidden, resolve, end)
+        _nextLine(callback, '', hidden, resolve, end, true)
     })
 }
 
@@ -397,30 +426,9 @@ async function save(args) {
     }
     let resp;
     if (args[0] === 'e') {
-        resp = `/*
-A test exe script
- */
- 
-$defArgs({
-    arg: '必填参数',
-    _arg: '非必填参数'
-})
-
-let {} = $lib // 引用内置资源
-
-console.log($args)
-
-return {}
-`;
+        resp = example.exeFile;
     } else if (args[0] === 'i') {
-        resp = `/*
-A test init script
- */
-
-let {} = $lib // 引用内置资源
-
-return {}
-`;
+        resp = example.initFile;
     } else {
         resp = await getCbText();
     }
@@ -447,8 +455,15 @@ function rename(dir, oldName, newName) {
     listCmd()
 }
 
-function listCmd() {
-    let items = Object.values(_cmdMap)
+function listCmd(tmpMap) {
+    let tmpList = false;
+    if (tmpMap) {
+        tmpList = true;
+    } else {
+        tmpMap = _cmdMap;
+    }
+
+    tmpMap = arrayToCmdMap(Object.values(tmpMap)
         .filter(item => _fs.existsSync(getFullPath(item)))
         .sort((a,b) => {
             a = parseUniqueName(a)[1];
@@ -459,17 +474,19 @@ function listCmd() {
             orderA = orderA === -1 ? 999999:orderA;
             orderB = orderB === -1 ? 999999:orderB;
             return orderA - orderB
-        })
+        }))
 
-    _cmdMap = arrayToCmdMap(items)
-    if (_noAppendNextLine) {
-        objDataFile(_cmdMapFile, () => _cmdMap)
+    if (!tmpList) {
+        _cmdMap = tmpMap;
+        if (_noAppendNextLine) {
+            objDataFile(_cmdMapFile, () => _cmdMap)
+        }
     }
 
-    items = []
-    for (let i of Object.keys(_cmdMap)) {
-        let text = String(_fs.readFileSync(getFullPath(_cmdMap[i])))
-        let pair = parseUniqueName(_cmdMap[i])
+    let items = []
+    for (let i of Object.keys(tmpMap)) {
+        let text = String(_fs.readFileSync(getFullPath(tmpMap[i])))
+        let pair = parseUniqueName(tmpMap[i])
         let name = trimJsirFileName(pair[1])
         let suffix = getJsirFileSuffix(pair[1])
         let item = {
@@ -480,9 +497,9 @@ function listCmd() {
         items.push(item)
 
         if (!text) {
-            text = String(_fs.readFileSync(getFullPath(_cmdMap[i])))
+            text = String(_fs.readFileSync(getFullPath(tmpMap[i])))
         }
-        getComments(i, _cmdMap[i], text, items, item)
+        getComments(i, tmpMap[i], text, items, item)
     }
     if (Object.keys(items).length === 0) {
         warn("no items")
@@ -500,7 +517,7 @@ function listCmd() {
                 item.name = pair[0] + '/' + item.name
             }
         })
-        console.table(items)
+        CONSOLE.table(items)
     }
 }
 
@@ -542,7 +559,7 @@ async function _wrapperInput(str) {
         } else {
             let fLine = trim(str.substr(1))
             if (fLine) {
-                console.log(draftQuery(fLine).join("\n"))
+                CONSOLE.log(draftQuery(fLine).join("\n"))
             } else {
                 let text = str.substr(1) + "\n" + await nextText(line => line, fstr)
                 $draft(text)
@@ -553,14 +570,14 @@ async function _wrapperInput(str) {
         let isStar =  str.startsWith('*')
         let text = trim(str.replace(/^[$#*]/, ''))
         if (is$) {
-            console.log(await evalText('return ' + text))
+            CONSOLE.log(await evalText('return ' + text))
         } else if (isStar) {
             if (!text) {
                 text = '$context';
             }
             let result = await evalText('return ' + text)
             if (!result || typeof result === 'string' || Object.keys(result).length === 0) {
-                console.nable([getInfo(result)])
+                CONSOLE.nable([getInfo(result)])
                 return
             }
             let rows = []
@@ -570,7 +587,7 @@ async function _wrapperInput(str) {
             if (rows.length === 0) {
                 warn("no items")
             } else {
-                console.nable(rows)
+                CONSOLE.nable(rows)
             }
         } else {
             await evalText(text)
@@ -590,7 +607,7 @@ async function _wrapperInput(str) {
             if (firstName === 'f') {
                 await workFile(uniqueName)
             } else if (firstName !== 'e') {
-                console.log(String(_fs.readFileSync(path)));
+                CONSOLE.log(String(_fs.readFileSync(path)));
             } else {
                 await runCmd(str)
             }
@@ -609,12 +626,12 @@ function arrayToCmdMap(cmds) {
 }
 
 function help() {
-    console.nable(Object.keys(keywordDef).map(key => {
+    CONSOLE.nable(Object.keys(keywordDef).map(key => {
         let item = keywordDef[key];
         return {
             keyword: ' ' + warnStr(`.${key}`),
             short: ' ' + warnStr(`.${item.short}`),
-            comment: [item.comment, item.args ? getArgComments(item.args).join('\n'):''].filter(i => i).join("\n"),
+            comment: [infoStr(item.comment), item.args ? getArgComments(item.args).join('\n'):''].filter(i => i).join("\n"),
         }
     }))
 }
@@ -716,21 +733,21 @@ let compareMode = {
 
 const keywordDef = {
     help: {
-        comment: '帮助文档',
+        comment: 'Help documentation',
         exeFn: (args) => {
             help()
         },
         short: 'h'
     },
     version: {
-        comment: '查看版本',
+        comment: 'View version',
         exeFn: (args) => {
-            console.log(require("../package.json").version)
+            CONSOLE.log(packageJson.version)
         },
         short: 'v'
     },
     list: {
-        comment: '查看文件列表',
+        comment: 'View file list',
         exeFn: (args) => {
             if (args.length > 0) {
                 _cmdMap = arrayToCmdMap(filterCmd(args.length > 0 ? args.join(' '):[',']))
@@ -738,22 +755,22 @@ const keywordDef = {
             listCmd()
         },
         args: {
-            queryParams: '字符串匹配，[,]代表全部，关键字可以省略'
+            queryParams: 'string matching, [,] represents all, keywords can be omitted'
         },
         short: 'l'
     },
     clear: {
-        comment: '清除任务',
+        comment: 'Clear task',
         exeFn: (args) => {
             delTipsByIndex(args.filter(i => i))
         },
         args: {
-            tipIndex: '左侧提示符下标，可以多个用空格隔开'
+            tipIndex: 'left prompt index, can be separated by spaces for multiple'
         },
         short: 'C'
     },
     see: {
-        comment: '查看文件',
+        comment: 'View file',
         exeFn: (args) => {
             let uniqueName = _cmdMap[args[0]]
             if (!uniqueName) {
@@ -761,16 +778,16 @@ const keywordDef = {
             } else {
                 let path = getFullPath(uniqueName)
                 let sourceStr = String(_fs.readFileSync(path))
-                console.log(sourceStr)
+                CONSOLE.log(sourceStr)
             }
         },
         args: {
-            fileIndex: '文件下标'
+            fileIndex: 'File index'
         },
         short: 's'
     },
     rm: {
-        comment: '删除文件',
+        comment: 'Remove file',
         exeFn: (args) => {
             let uniqueName = _cmdMap[args[0]]
             if (args[0] === 'ALL') {
@@ -788,12 +805,12 @@ const keywordDef = {
             }
         },
         args: {
-            fileIndex: '文件下标, ALL代表全部'
+            fileIndex: 'File index, [ALL] for all files'
         },
         short: 'R'
     },
     get: {
-        comment: '获取文件',
+        comment: 'Get file',
         exeFn: (args) => {
             let uniqueName = _cmdMap[args[0]]
             if (args[0] === 'ALL') {
@@ -807,12 +824,12 @@ const keywordDef = {
             }
         },
         args: {
-            fileIndex: '文件下标, ALL代表全部'
+            fileIndex: 'File index, [ALL] for all files'
         },
         short: 'g'
     },
     rename: {
-        comment: '重命名文件',
+        comment: 'Rename file',
         exeFn: (args) => {
             let uniqueName = _cmdMap[args[0]]
             if (!uniqueName) {
@@ -824,13 +841,13 @@ const keywordDef = {
             }
         },
         args: {
-            fileIndex: '文件下标',
-            newName: '新名字'
+            fileIndex: 'File index',
+            newName: 'New name'
         },
         short: 'n'
     },
     edit: {
-        comment: '编辑文件',
+        comment: 'Edit file',
         exeFn: async (args) => {
             let uniqueName = _cmdMap[args[0]]
             if (!uniqueName) {
@@ -841,12 +858,12 @@ const keywordDef = {
             }
         },
         args: {
-            fileIndex: '文件下标'
+            fileIndex: 'File index'
         },
         short: 'e'
     },
     compare: {
-        comment: '比较文件',
+        comment: 'Compare files',
         exeFn: async (args) => {
             let aUniqueName = _cmdMap[args[0]]
             let bUniqueName = _cmdMap[args[1]]
@@ -854,7 +871,7 @@ const keywordDef = {
             let bSpace = args[1]
 
             if (aUniqueName && bUniqueName) {
-                await e(`idea diff "${getFullPath(aUniqueName)}" "${getFullPath(bUniqueName)}"`)
+                await e(`${getConfig("compareExe", "idea diff")} "${getFullPath(aUniqueName)}" "${getFullPath(bUniqueName)}"`)
             } else if (aSpace && bSpace) {
                 if (!args[2]) {
                     warn('require mode')
@@ -878,14 +895,14 @@ const keywordDef = {
             }
         },
         args: {
-            a: '文件/工作空间',
-            b: '文件/工作空间',
+            a: 'File/workspace',
+            b: 'File/workspace',
             mode: 'a=, b=, ab=, a+, b+, ab+'
         },
         short: 'c'
     },
     deps: {
-        comment: '查看文件依赖',
+        comment: 'View file dependencies',
         exeFn: (args) => {
             let uniqueName = _cmdMap[args[0]]
             if (!uniqueName) {
@@ -909,12 +926,12 @@ const keywordDef = {
             }
         },
         args: {
-            fileIndex: '文件下标'
+            fileIndex: 'File index'
         },
         short: 'd'
     },
     file: {
-        comment: '工作文件模式',
+        comment: 'Working file mode',
         exeFn: async (args) => {
             if (args.length === 0) {
                 await workFile('')
@@ -928,12 +945,12 @@ const keywordDef = {
             }
         },
         args: {
-            fileIndex: '文件下标'
+            fileIndex: 'File index'
         },
         short: 'f'
     },
     workspace: {
-        comment: '工作空间管理',
+        comment: 'Workspace Management',
         exeFn: async (args) => {
             let newWorkspace = args.join(' ')
             if (newWorkspace) {
@@ -950,15 +967,15 @@ const keywordDef = {
                     path
                 }
             })
-            console.table(items)
+            CONSOLE.table(items)
         },
         args: {
-            workspacePath: '新增工作空间路径'
+            workspacePath: 'New workspace path'
         },
         short: 'w'
     },
     uninstall: {
-        comment: '卸载工作空间',
+        comment: 'Uninstall workspace',
         exeFn: async (args) => {
             let workspaces = Object.values($workspaceMap)
             let items = workspaces.map((path, index) => {
@@ -968,7 +985,7 @@ const keywordDef = {
                     path
                 }
             })
-            console.table(items)
+            CONSOLE.table(items)
             let index = await nextLine(line => line, "index: ")
             let workspace = workspaces[index - 1]
             if (workspace) {
@@ -982,7 +999,7 @@ const keywordDef = {
         short: 'u'
     },
     switch: {
-        comment: '切换工作空间',
+        comment: 'Switch workspace',
         exeFn: async (args) => {
             checkWorkspaces()
             let workspaces = Object.values($workspaceMap)
@@ -993,7 +1010,7 @@ const keywordDef = {
                     path
                 }
             })
-            console.table(items)
+            CONSOLE.table(items)
             let index = trim(await nextLine(line => line, "switch workspace: "));
             if (index && workspaces[index - 1]) {
                 let workspace = workspaces[index - 1];
@@ -1005,54 +1022,76 @@ const keywordDef = {
         short: 'S'
     },
     add: {
-        comment: '新增文件',
+        comment: 'Add file',
         exeFn: async (args) => {
             await save(args)
         },
         args: {
-            fileName: '文件名称(e可执行，i资源文件，f工作文件), 例：.add e test'
+            fileName: 'File name (e for executable, i for resource file, f for working file), example: .add e test'
         },
         short: 'a'
     },
     run: {
-        comment: '快捷执行',
+        comment: 'Quick execution',
         exeFn: async (args) => {
             if (!args[0]) {
                 warn('invalid args')
                 return
             }
-            let cmds = filterCmd('^e ' + toJsirFileName(args[0]).replace(/^[eif]\s+/, '') + '$')
+            let pair = parseUniqueName(args[0])
+            let cmds;
+            if (/^0x[a-z\d]{8}$/.test(pair[1]) || pair[1].indexOf(",") !== -1) {
+                cmds = getQuickRunCmds(args[0], args[0])
+            } else {
+                cmds = getQuickRunCmds(args[0], '^e ' + toJsirFileName(pair[1]) + '$')
+                if (cmds.length === 0) {
+                    cmds = getQuickRunCmds(args[0], args[0])
+                }
+            }
             if (cmds.length === 1) {
+                if (_noAppendNextLine) {
+                    listCmd(arrayToCmdMap(cmds))
+                }
                 await runCmd(args.slice(1).join(' '), cmds[0])
+            } else {
+                warn(cmds.length > 1 ? "multiple match" : "no match")
             }
         },
         args: {
-            fileNameReg: '文件名称匹配'
+            fileNameReg: 'File name matching'
         },
         short: 'r'
     },
     quit: {
-        comment: '退出',
+        comment: 'Exit',
         exeFn: (args) => {
-            console.log(infoStr("Bye!"))
-            _exit = true;
+            delTips();
+            CONSOLE.log(infoStr("Bye!"))
             process.exit(0)
         },
         short: 'q'
     },
     repl: {
-        comment: '交互式界面',
+        comment: 'Interactive interface',
         exeFn: (args) => {
             _noAppendNextLine = false
-            console.log(warnStr("You can start with .help, use * to expand context"))
-            if (Object.keys(_cmdMap).length > 0) {
-                listCmd()
-            }
+            _cmdMap = {}
+            CONSOLE.log(warnStr("You can start with .help, use * to expand context"))
         },
         short: 'p'
     }
 }
 
+function getQuickRunCmds(input, matchStr) {
+    let pair = parseUniqueName(input)
+    if (pair[0]) {
+        matchStr = pair[0] + '/' + matchStr;
+    } else if (input.startsWith("/")) {
+        matchStr = '/' + matchStr;
+    }
+    return filterCmd(matchStr).filter(i => parseUniqueName(i)[1].startsWith("e "))
+}
+
 function preLoad(text, fnNameMatch, fn) {
     regEach(text, new RegExp(`${fnNameMatch}\\s*\\(([^()]+)\\)`, 'g'), r=> {
         let item = trim(r[1])
@@ -1104,7 +1143,7 @@ async function _dealKeyword(keyword, args) {
         }
     }
     if (unMatched) {
-        warn(`unknown keyword: ${keyword}`)
+        await keywordDef.run.exeFn([keyword, ...args])
     }
 }
 
@@ -1180,7 +1219,7 @@ function getScriptRequires(uniqueName) {
 }
 
 function getComments(i, cmdName, text, cols = [], col) {
-    let docLines = [infoStr(getCmdMd5Key(parseUniqueName(cmdName)[1])) + " - " + infoStr(i)]
+    let docLines = [getCmdMd5Key(parseUniqueName(cmdName)[1]) + " - " + i]
     text = trim(text)
     docLines.push(...getTextComments(text))
     let argDef = getArgDef(text)
@@ -1189,12 +1228,17 @@ function getComments(i, cmdName, text, cols = [], col) {
         docLines.push(...comments)
     }
     if (docLines.length > 0) {
-        col.doc = '- ' + infoStr(trim(docLines[0]))
+        col.doc = '- ' + docLines[0]
         if (docLines.length > 1) {
-            for (let line of docLines.slice(1)) {
-                cols.push({
-                    doc: '  ' + line
-                })
+            cols.push({
+                doc: '  ' + infoStr(docLines[1])
+            })
+            if (docLines.length > 2) {
+                for (let line of docLines.slice(2)) {
+                    cols.push({
+                        doc: '  ' + line
+                    })
+                }
             }
         }
     }
@@ -1327,7 +1371,7 @@ function getArgComments(argDef) {
         let aLine = []
         for (let k of keys) {
             let item = warnStr(k) + (argDef[k] ? ` <${argDef[k]}>`:'')
-            if ([...aLine, item].join(', ').length > 64) {
+            if (aLine.length > 0 && [...aLine, item].join(', ').length > 64) {
                 comments.push(aLine.join(", ") + ", ")
                 aLine = []
             }
@@ -1392,7 +1436,8 @@ async function runCmd(str = '', uniqueName = '', text = '') {
                 pair = [arg, oriArgs[i+1]]
                 i++
             } else {
-                pair = [arg, null]
+                // 只传参数名称，不传参数，使用翻译赋值为true
+                pair = [arg, 'true   ']
             }
         } else {
             pair = [null, arg]
@@ -1422,7 +1467,7 @@ async function runCmd(str = '', uniqueName = '', text = '') {
     for (let key of Object.keys(exactArgs)) {
         scriptArgs[key] = exactArgs[key]
     }
-    let exit = false
+    let argAbsent = false
     let scriptArgKeys = Object.keys(scriptArgs);
     for(let name of argNames) {
         let defStr = argDef[name]
@@ -1436,15 +1481,15 @@ async function runCmd(str = '', uniqueName = '', text = '') {
             continue
         }
         if (scriptArgKeys.indexOf(name) === -1 || (reg && !reg.test(scriptArgs[name]))) {
-            exit = true
+            argAbsent = true
             warn(`require ${warnStr(name)}` + (defStr ? ` <${defStr}>`:''))
         }
     }
-    if (exit) {
+    if (argAbsent) {
         throw 'invalid args';
     }
 
-    process.argv = [process.argv[0], path, ...scriptArgs]
+    process.argv = [process.argv[0], path, ...(scriptArgs.map(String))]
     return await evalText(text, uniqueName, scriptArgs)
 }
 
@@ -1514,9 +1559,7 @@ function getArgDef(text) {
 }
 
 function setTips(key, value, onRm) {
-    let vals = getOr(global.$tips, key, []);
-    vals.push(value)
-    global.$tips[key] = [...new Set(vals)]
+    getOr(global.$tips, key, []).push(value);
     if (onRm) {
         getOr(_tipsOnRm, key, []).push(onRm)
     }
@@ -1656,7 +1699,6 @@ async function evalText($text = '', $cmdName = '', $args = []) {
             setTips, delTips,
             wrapperInput, filterCmd,
             currSpace,
-            $log, $draft,
             $homeDir, $lib)
     } catch(e) {
         throw errorTag(e, $cmdName);
@@ -1677,14 +1719,17 @@ process.on('rejectionHandled',function(err){
 })
 process.on('SIGINT', function () {
     if (_noAppendNextLine) {
-        process.exit();
+        delTips();
+        process.exit(0);
     } else {
         nextLine();
     }
 });
 process.on('beforeExit', function () {
-    if (!_exit) {
-        _noAppendNextLine || nextLine();
+    if (_noAppendNextLine) {
+        delTips();
+    } else {
+        nextLine();
     }
 });
 

package/deps/evalCode.js

@@ -1,4 +1,4 @@
-const {info: $info, msg: $msg, warn: $warn, error: $error, importG: $import} = require("./util");
+const {info: $info, msg: $msg, warn: $warn, error: $error, importG: $import, $log, $draft} = require("./util");
 require = require("./util").requireG
 module.exports = async ($text = '', $cmdName = '', $args = [],
                         $data, $config,
@@ -7,7 +7,6 @@ module.exports = async ($text = '', $cmdName = '', $args = [],
                         $setTips, $delTips,
                         $enter, $filterCmd,
                         $currentSpace,
-                        $log, $draft,
                         $homeDir, $lib) => {
     const $defArgs = () => $args;
     const $context = {

package/deps/example.js

@@ -0,0 +1,25 @@
+module.exports = {
+    exeFile: `/*
+A test exe script
+ */
+
+$defArgs({
+    arg: 'required argument',
+    _arg: 'optional argument'
+})
+
+let {} = $lib // Reference to built-in resources
+
+console.log($args)
+
+return {}
+`,
+    initFile: `/*
+A test init script
+ */
+
+let {} = $lib // Reference to built-in resources
+
+return {}
+`
+}

package/deps/util.js

@@ -13,6 +13,7 @@ const globalDirectories = require('global-dirs');
 const emptyFn = ()=>{}
 const dayJs = require('dayjs')
 const table = require('console.table')
+const {log: _log} = console;
 const _fs = require("fs");
 if (module.paths.indexOf(globalDirectories.npm.packages) === -1) {
     module.paths.push(globalDirectories.npm.packages)
@@ -126,10 +127,10 @@ function nableStr(rows) {
     return tableStr(wrapRows(rows))
 }
 console.table = (...args) => {
-    console.log(tableStr(...args))
+    _log(tableStr(...args))
 }
 console.nable = (rows) => {
-    console.log(nableStr(rows))
+    _log(nableStr(rows))
 }
 
 function timeStr(fmt, date) {
@@ -344,7 +345,7 @@ function requireG(moduleName){
     } catch (e) {}
     let path = globalDirectories.npm.packages + '/' + moduleName;
     if (!fs.existsSync(path)) {
-        console.log(warnStr(`npm install -g ${moduleName}`))
+        _log(warnStr(`npm install -g ${moduleName}`))
         throw `${moduleName} not found, use above cmd to install it`;
     }
     return require(path);
@@ -359,7 +360,7 @@ async function importG(moduleName) {
     } catch (e) {}
     let path = globalDirectories.npm.packages + '/' + moduleName;
     if (!fs.existsSync(path)) {
-        console.log(warnStr(`npm install -g ${moduleName}`))
+        _log(warnStr(`npm install -g ${moduleName}`))
         throw `${moduleName} not found, use above cmd to install it`;
     }
     return await import(path);
@@ -888,50 +889,97 @@ function strEq(a, b) {
 
 function wrapRows(rows) {
     let newRows = []
+    // 构建新的数组
     for(let row of rows) {
         let temp = []
         for(let key of Object.keys(row)) {
             let val = row[key]
-            if (getType(val) !== "String") {
+            if (typeof val === 'number') {
+                let r = getOr(temp, 0, {})
+                r[key] = val;
+                continue;
+            }
+            if (typeof val !== "string") {
                 val = JSON.stringify(val, null, 2)
             }
+
+            let r = getOr(temp, 0, {})
+            r[key] = val;
+        }
+        newRows.push(...temp)
+    }
+
+    // 排序
+    if (newRows.length > 0) {
+        newRows.sort((a,b) => {
+            for (let key of Object.keys(newRows[0])) {
+                if (a[key] < b[key]) {
+                    return -1;
+                } else if (a[key] > b[key]) {
+                    return 1;
+                }
+            }
+            return 0;
+        })
+        let keyMap = {}
+        for (let newRow of newRows) {
+            let lastKey
+            for (let key of Object.keys(newRows[0])) {
+                if (keyMap[key] === newRow[key]) {
+                    if (!lastKey || newRow[lastKey] === ' - ') {
+                        newRow[key] = ' - '
+                    }
+                } else {
+                    keyMap[key] = newRow[key]
+                }
+                lastKey = key;
+            }
+        }
+    }
+
+    // 换行处理
+    let result = []
+    for(let row of newRows) {
+        let temp = []
+        for(let key of Object.keys(row)) {
+            let val = row[key]
             let items = String(val).split('\n')
             for(let i = 0; i<items.length; i++) {
                 let r = getOr(temp, i, {})
                 r[key] = items[i]
             }
         }
-        newRows.push(...temp)
+        result.push(...temp)
     }
-    return newRows
+    return result
 }
 
-function info(msg) {
+function info(msg, _console = console) {
     if (typeof msg === 'string' && msg && msg.indexOf('\n') === -1) {
         msg = infoStr(msg)
     }
-    console.log(infoStr('[info]'), msg)
+    _console.log(infoStr('[info]'), msg)
 }
 
-function msg(msg) {
+function msg(msg, _console = console) {
     if (typeof msg === 'string' && msg && msg.indexOf('\n') === -1) {
         msg = msgStr(msg)
     }
-    console.log(msgStr('[msg]'), msg)
+    _console.log(msgStr('[msg]'), msg)
 }
 
-function warn(msg) {
+function warn(msg, _console = console) {
     if (typeof msg === 'string' && msg && msg.indexOf('\n') === -1) {
         msg = warnStr(msg)
     }
-    console.warn(warnStr('[warn]'), msg)
+    _console.warn(warnStr('[warn]'), msg)
 }
 
-function error(msg, tag) {
+function error(msg, tag, _console = console) {
     if (typeof msg === 'string' && msg && msg.indexOf('\n') === -1) {
         msg = errorStr(msg)
     }
-    console.error(errorStr(`[${tag || 'error'}]`), msg)
+    _console.error(errorStr(`[${tag || 'error'}]`), msg)
 }
 
 function infoStr(str) {
@@ -1126,7 +1174,6 @@ function errorTag(e, tag) {
 function getTextComments(text) {
     let results = []
     text = text.replace(/\r/g, '\n')
-    text = text.replace(/\n+/g, '\n')
     let lines = text.split(/\n/);
 
     if (text.startsWith("/*")) {
@@ -1144,17 +1191,14 @@ function getTextComments(text) {
             results.push(line)
         }
     } else {
-        for (let key of ['#', '/', '-', ';']) {
-            if (!text.startsWith(key)) {
-                continue
-            }
+        let firstReg = /^[#/\-;]+/;
+        if (firstReg.test(text)) {
             for (let line of lines) {
                 let trimLine = trim(line)
                 if (!trimLine) {
-                    continue
+                    break
                 }
-                if (trimLine.startsWith(key)) {
-                    let line = trimLine.replace(new RegExp(`^[${key}]+`), '');
+                if (firstReg.test(trimLine)) {
                     if (trim(line)) {
                         results.push(line)
                     }

package/index.js

@@ -1,4 +0,0 @@
-
-module.exports = {
-    ...require('deps/util')
-}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jsir",
-  "version": "2.1.4",
-  "description": "js script manager tool",
+  "version": "2.1.6",
+  "description": "JavaScript Script Management Tool",
   "main": "index.js",
   "scripts": {
     "test": "cmd/oaa.js"
@@ -9,7 +9,12 @@
   "bin": {
     "jsir": "cmd/oaa.js"
   },
-  "keywords": [],
+  "keywords": [
+    "javascript",
+    "scripts",
+    "manager",
+    "executor"
+  ],
   "author": "",
   "license": "ISC",
   "dependencies": {