1

我正在使用 PicoCLI v4.0.0-beta-1b。我正在使用从父命令链接的不同子命令。启动 CLI 时会显示父命令的可选参数，但不会显示子命令。子命令仅出现在命令下方（但没有选项）。如何确保子命令的选项也出现在 CLI 中？

Options:
  -a, --autocomplete   Generate sample autocomplete
  -h, --help           Display this help message.
  -v, --verbose        Verbose mode. Helpful for troubleshooting.
  -V, --version        Show version info and exit.
Commands:
  abc
  def
4

1 回答 1

2

默认情况下，picocli 仅显示命令子命令的概述，不显示详细信息。这遵循其他命令套件的约定，例如git. 这个想法是最终用户总是可以通过请求特定子命令的帮助来获取另一个子命令的详细信息，例如git commit --help或git help commit。

虽然这是一个有用的默认值，但如果这不是您想要的，picocli 使用帮助是高度可定制的。

picocli 使用消息包含以下部分：

  • 标题标题
  • 标题
  • 概要标题
  • 概要
  • 描述标题
  • 描述
  • 位置参数列表标题
  • 位置参数列表
  • 选项列表标题
  • 选项列表
  • 命令列表标题
  • 命令列表
  • 退出代码列表标题（从 4.0 开始）
  • 退出代码列表（从 4.0 开始）
  • 页脚标题
  • 页脚

每个部分都有自己的IHelpSectionRenderer，您可以通过删除、重新排序或替换这些帮助部分渲染器来更改使用帮助。

让您入门的示例如下： https ://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/customhelp/ShowAll.java

上面的示例自定义IHelpSectionRenderer了命令列表，以显示命令、子命令和子子命令等的完整层次结构。您可能想做类似的事情，但显示子命令的选项。

您需要熟悉 picocli帮助API 的一些细节，例如TextTable、Layout、IOptionRenderer等。

于 2019-06-10T08:27:07.057 回答