标准输入、输出和退出码

Nushell 和外部命令之间互操作的一个重要部分是与来自外部的标准数据流一起工作。

这些重要数据流中的第一个是标准输出流(stdout)。

标准输出流

标准输出流(stdout)是大多数外部应用程序将数据发送到管道或屏幕上的方式。如果由外部应用发送到其 stdout 的数据是管道的一部分,Nushell 会默认接收。

  1. > external | str collect

以上将调用名为external的外部命令,并将 stdout 输出流重定向到管道中。有了这个重定向,Nushell 就可以把数据传递给管道中的下一个命令,这里是str collect

如果没有管道,Nushell 将不做任何重定向,允许它直接打印到屏幕上。

标准错误流

另一个外部应用程序经常用来打印错误信息的常见流是标准错误流(stderr)。默认情况下,Nushell 不会对 stderr 做任何重定向,这意味着它会默认打印到屏幕上。

你可以通过使用do -i { ... }来强制 Nushell 做一个重定向。例如,如果我们想调用上面的外部程序并重定向其 stderr,我们可以这样写:

  1. > do -i { external }

退出码

最后,外部命令有一个 “退出代码(exit code)”。这些代码有助于给调用者一个提示,说明该命令是否运行成功。

Nushell 通过两种方式之一跟踪最近完成的外部命令的最后退出代码。第一种方式是使用LAST_EXIT_CODE环境变量。

  1. > do -i { external }
  2. > echo $env.LAST_EXIT_CODE

第二种是使用一个叫做complete的命令。

使用 complete 命令

complete命令允许你运行一个外部程序直到完成,并将 stdout, stderr, 和退出代码收集在一条记录中。

如果我们尝试在一个不存在的文件上运行外部的cat,我们可以看到complete对流的处理,包括重定向的 stderr:

  1. > do -i { cat unknown.txt } | complete
  2. ╭───────────┬─────────────────────────────────────────────╮
  3. stdout
  4. stderr cat: unknown.txt: No such file or directory
  5. exit_code 1
  6. ╰───────────┴─────────────────────────────────────────────╯

原始流

在 Nushell 中,stdout 和 stderr 都表现为 “原始流”。这些流是字节流,而不是结构化的流,而后者才是 Nushell 内部命令所使用的。

因为字节流可能很难处理,特别是考虑到使用输出作为文本数据是很常见的,Nushell 试图将原始流转换为文本数据。这使得其他命令可以拉取外部命令的输出,并接收他们可以进一步处理的字符串。

Nushell 试图将流转换为 UTF-8 文本,如果在任何时候转换失败,流的其余部分就会被假定为始终是字节。

如果你想对字节流的解码有更多的控制,你可以使用 decode 命令。decode命令可以插入到外部或其他原始流创建命令之后的管道中,它将根据你给decode的参数来处理字节的解码。例如,你可以这样对 shift-jis 文本进行解码:

  1. > 0x[8a 4c] | decode shift-jis