pop-config 6.11

了解配置文件在

Pop依赖于一个配置文件来管理如何合并应用程序，并且 以及如何管理和合并配置数据。此文件中的数据 在4个Python字典中显示并定义了 配置加载。在

这4个字典分别称为CONFIG，CLI\uconfig，SUBCOMMANDS 和DYNE。每本词典都有特定的用途。他们之间 您可以定义cli参数的显示方式，所有配置 违约、文件等

配置字典

大部分配置将出现在CONFIG字典中。 所有的配置选项都在这里定义。中的大多数条目 ^{emm最简单的配置是最简单的 价值观：

CONFIG={"name":{"default":"frank","help":"Enter the name to use",},}

这个简单的例子展示了配置值的文档 以及默认值应该是什么。在

垂直应用程序合并的项目可以将配置项添加到其父dyne中，如下所示：

可以使用更多的选项，但这些选项将包含在参考资料中 文件。在

CLI配置字典

添加配置值不会使其显示在命令行上。 每个应用程序都可以扩展到包括命令行选项。 让我们扩展前面的示例，将“name”选项公开为一个命令 行参数：

CLI_CONFIG={"name":{},}CONFIG={"name":{"default":"frank","help":"Enter the name to use",},}

就这样！“name”选项现在在命令行上可用，并且可以 用作–名字bob。在

但是如果我们想让它成为一个位置论呢？简单！只要加上 CLI\$CONFIG的位置选项：

CLI_CONFIG={"name":{"positional":True,},}CONFIG={"name":{"default":"frank","help":"Enter the name to use",},}

您可以从其他项目继承cli参数。例如，您希望实现–output标志 与rend完全相同，您可以这样获取：

CLI_CONFIG={"output":{"source":"rend",},}

还有更多的选项可以让您控制用户的各个方面 命令行经验。在

子命令字典

有时需要有子命令。子命令允许您的CLI 以类似于gitcli的方式工作，其中有多个例程 所有这些都可以从一个命令调用。在

让我们在我们的例子中再添加一些东西，这样我们就可以有子命令了。在

CLI_CONFIG={"name":{"subcommands":["test","apply"],},"weight":{},"power":{"subcommands":["apply"],},}CONFIG={"name":{"default":"frank","help":"Enter the name to use",},"weight":{"default":"150","help":"Enter how heavy it should be",},"power":{"default":"100","help":"Enter how powerful it should be",},}SUBCOMMANDS={"test":{"help":"Used to test","desc":"When running in test mode, things will be tested",},"apply":{"help":"Used to apply","desc":"When running in apply mode, things will be applied",},}

在本例中，我们看到选项name将在 子命令test和apply。将提供电源选项 只在潜艇下面命令apply并且选项权重是全局的 可用。在

戴恩词典

DYNE字典允许您控制应用程序的动态名称 向其他pop项目展示。这个名字不仅在里面用 包括pop config以及pop内部，以确定哪个插件子系统 此应用程序与合并。DYNE系统允许您的cli 通过第三方代码进行扩展，可以进行配置选项 通过外部代码提供给您的应用程序。在

DYNE系统非常强大。但既然这对 从pop-config开始，将在另一个文档中更深入地介绍它。在