如何重定向输出#

参阅输出重定向和管道。

在 cmd2 中执行操作系统命令#

cmd2 包含一个 shell 命令，它在操作系统 shell 中执行其参数：

1
(Cmd) shell ls -al

如果你使用 cmd2 中定义的默认快捷方式，你将获得一个 ! 快捷方式用于 shell，允许你输入：

1
(Cmd) !ls -al

编辑器#

cmd2 包含内置的 edit 命令，它运行文本编辑器并可选择打开文件：

1
(Cmd) edit foo.txt

使用的编辑器由 editor 可设置参数决定，可以是文本编辑器（如 vim）或图形编辑器（如 VSCode）。设置方式：

1
set editor <program_name>

如果你设置了 EDITOR 环境变量，这将是 editor 的默认值。如果没有，cmd2 将尝试在你操作系统的常见编辑器列表中搜索。

终端分页器#

任何命令的输出都可以使用 cmd2.Cmd.ppaged 方法逐页显示。

或者，可以使用 ! 快捷方式直接调用终端分页器：

1
(Cmd) !less foo.txt

退出码#

cmd2 应用的 self.exit_code 属性控制 cmdloop() 完成时返回的退出码。你的工作是确保在应用退出时通过调用 sys.exit(app.cmdloop()) 将此退出码发送给 shell。

带参数调用#

通常你会通过输入以下内容来调用 cmd2 程序：

1
$ python mycmd2program.py

或：

1
$ mycmd2program.py

这两种方法都会启动你的程序并进入 cmd2 命令循环，允许用户输入命令，然后由你的程序执行。

你可能希望在不提示用户输入任何内容的情况下在程序中执行命令。有几种方法可以完成此任务。其中一种方法是通过标准输入将命令及其参数管道传递给你的程序。你不需要对程序做任何事情就可以使用此技术。

1
$ echo "speak -p some words" | uv run examples/cmd_as_argument.py
2
omesay ordsway

使用相同的方法，你可以创建一个包含要运行的命令的文本文件，文件中每行一个命令。假设你的文件名为 somecmds.txt：

1
c:\cmd2> type somecmds.txt | uv run examples/cmd_as_argument.py
2
omesay ordsway

默认情况下，cmd2 程序还会查找从操作系统 shell 传递的参数作为命令，并在进入命令循环之前执行这些命令：

1
$ uv run examples/cmd_as_argument.py help

你可能需要对从操作系统 shell 传递的命令行参数有更多控制。例如，你可能有一个命令本身接受参数，甚至选项字符串。假设你想从操作系统 shell 运行 speak 命令，但让它用 pig latin（儿童黑话）说出来——只需将命令及其参数用双引号或单引号括起来即可：

1
$ uv run examples/cmd_as_argument.py "speak -p hello there"
2
ellohay heretay
3
(Cmd)

如果你想使用自定义 argparse 解析器来收集高层应用参数，同时仍希望在调用时将额外的未知参数作为命令传递，请参阅 argparse_example.py 示例。使用这种方法，你可以这样调用它：

1
$ uv run examples/argparse_example.py -c blue help

查看该示例的源代码，特别是 if __name__ == "__main__": 代码块，了解实现技巧。

1
$ uv run examples/cmd_as_argument.py "speak -p hello there" quit
2
ellohay heretay
3
$