xshell 1.1.16 → 1.1.17

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xshell",
-    "version": "1.1.16",
+    "version": "1.1.17",
     "type": "module",
     "main": "./index.js",
     "bin": {

package/path.d.ts

@@ -54,7 +54,7 @@ export declare function extname(path: string): string;
 /** `/` */
 export declare const sep = "/";
 /** The platform-specific file delimiter. ';' or ':'. */
-export declare const delimiter: ";" | ":";
+export declare const delimiter: ":" | ";";
 /** Returns an object from a path string - the opposite of format().
     @param path path to evaluate.
     @throws {TypeError} if `path` is not a string. */
@@ -81,7 +81,7 @@ export declare let path: {
     basename: typeof basename;
     extname: typeof extname;
     sep: string;
-    delimiter: ";" | ":";
+    delimiter: ":" | ";";
     parse: typeof parse;
     format: typeof format;
     toNamespacedPath: typeof toNamespacedPath;

package/process.d.ts

@@ -100,8 +100,11 @@ export interface CallOptions extends BaseOptions {
     throw_code?: boolean;
     /** `'utf-8'` 子进程输出编码 */
     encoding?: 'binary' | Encoding;
-    /** `'pipe'` 设置为 'ignore' 时忽略 stdio 处理 */
+    /** `[stdin ? 'pipe' : 'ignore', 'pipe', 'pipe']` 设置为 'ignore' 时忽略 stdio 处理 */
     stdio?: 'pipe' | 'ignore' | [StdioType, StdioType, StdioType];
+    /** `false` 子进程是否可能会读取 stdin
+        设置为 true 时会设置子进程 stdin 为 'pipe', 否则为 'ignore' */
+    stdin?: boolean;
     /** 启动子进程之后写入到子进程 stdin 中的内容，写完后关闭子进程 stdin */
     input?: string;
     /** 实时处理 stdout 和 stderr 的每个 chunk，启用后子进程输出不会自动 print */

package/process.js

@@ -17,7 +17,9 @@ export function get_command(exe, args) {
 }
 async function prepare_spawn(detached, exe, args, { cwd, window: _window, envs, 
 // @ts-ignore
-input, fp_stdin, fp_stdout, fp_stderr, print = true, proxy, 
+input, 
+// @ts-ignore
+stdin, fp_stdin, fp_stdout, fp_stderr, print = true, proxy, 
 // @ts-ignore
 stdio }) {
     // --- 处理 proxy, envs
@@ -52,7 +54,12 @@ stdio }) {
     else if (detached)
         stdio = ['ignore', 'ignore', 'ignore'];
     else
-        stdio = [input ? 'pipe' : 'ignore', 'pipe', 'pipe'];
+        stdio = [
+            // 当子进程 stdin 为 'ignore' 时，python 会报错 [WinError 6] 句柄无效，cmd / powershell 都会立即结束退出
+            (stdin || input) ? 'pipe' : 'ignore',
+            'pipe',
+            'pipe'
+        ];
     if (fp_stdin || fp_stdout || fp_stderr) {
         const { fopen } = await import("./file.js");
         async function open(fp, flags) {
@@ -77,6 +84,7 @@ stdio }) {
     }
     if (detached)
         check(stdio.every((x) => x === 'ignore' || typeof x === 'number'), '调用 start 时 stdio 只能是 fd 或者 ignore');
+    // --- 处理 stdio 结束
     if (typeof print === 'boolean')
         print = {
             command: print,
@@ -108,6 +116,18 @@ function to_subprocess(child, { title, exe, args, command, }) {
     child.exe = exe;
     child.args = args || [];
     child.command = command;
+    child[inspect.custom] = () => {
+        const { title, command, running, exitCode, presult } = child;
+        return {
+            ...title ? { title } : {},
+            command,
+            running,
+            ...running ? {} : {
+                code: exitCode,
+                presult
+            }
+        };
+    };
     Object.defineProperties(child, {
         finished: {
             get() {
@@ -274,7 +294,7 @@ export async function call(exe, args = [], options = {}) {
             });
         }
     };
-    if (throw_code && signal)
+    if (throw_code && code)
         throw new CallError(result);
     return result;
 }

package/utils.browser.d.ts

@@ -81,7 +81,7 @@ export declare function encode(str: string): Uint8Array<ArrayBufferLike>;
     在流式处理 (buffer 可能不完整) 时，应使用独立的 TextDecoder 实例调用 decode(buffer, { stream: true }) */
 export declare function decode(buffer: Uint8Array): string;
 /** 字符串字典序比较 */
-export declare function strcmp(l: string, r: string): 1 | 0 | -1;
+export declare function strcmp(l: string, r: string): 0 | 1 | -1;
 /** 比较 1.10.02 这种版本号
     - l, r: 两个版本号字符串
     - loose?: 宽松模式，允许两个版本号格式（位数）不一致 */

package/utils.d.ts

@@ -40,7 +40,7 @@ export declare function filter_values<TObj extends Record<string, any>>(obj: TOb
 /** 忽略对象中的 keys, 返回新对象 */
 export declare function omit<TObj>(obj: TObj, omit_keys: string[]): TObj;
 /** 字符串字典序比较 */
-export declare function strcmp(l: string, r: string): 1 | 0 | -1;
+export declare function strcmp(l: string, r: string): 0 | 1 | -1;
 /** 比较 1.10.02 这种版本号
     - l, r: 两个版本号字符串
     - loose?: 宽松模式，允许两个版本号格式（位数）不一致 */

package/stdin.d.ts

@@ -1,4 +0,0 @@
-/** 监听终端按键 (输入)，并调用 key_processor 处理
-    - on_key: 按键处理函数
-    - on_exit?: ctrl + c 会退出进程，可加入退出前自定义处理逻辑 */
-export declare function process_stdin(on_key: (key: string) => void | Promise<void>, on_exit?: () => void | Promise<void>): void;

package/stdin.js

@@ -1,25 +0,0 @@
-import process from 'process';
-/** 监听终端按键 (输入)，并调用 key_processor 处理
-    - on_key: 按键处理函数
-    - on_exit?: ctrl + c 会退出进程，可加入退出前自定义处理逻辑 */
-export function process_stdin(on_key, on_exit) {
-    // https://stackoverflow.com/a/12506613/7609214
-    let { stdin } = process;
-    if (stdin.isTTY) {
-        stdin.setRawMode(true);
-        stdin.resume();
-    }
-    stdin.setEncoding('utf-8');
-    // on any data into stdin
-    stdin.on('data', async (key) => {
-        // ctrl-c ( end of text )
-        if (key === '\u0003') {
-            await on_exit?.();
-            process.exit();
-        }
-        // write the key to stdout all normal like
-        console.log(key);
-        await on_key(key);
-    });
-}
-//# sourceMappingURL=stdin.js.map