python - 在裤子buildtool中， 'advanced'选项和常规选项有什么区别？

Question

当您在没有任何选项的情况下运行 ./pants 时，您将获得帮助:

$ ./pants help
Pants 0.0.32 https://pypi.python.org/pypi/pantsbuild.pants/0.0.32

Usage:
  ./pants [option ...] [goal ...] [target...]  Attempt the specified goals.
  ./pants help                                 Get help.
  ./pants help [goal]                          Get help for a goal.
  ./pants help-advanced [goal]                 Get help for a goal's advanced options.
  ./pants help-all                             Get help for all goals.
  ./pants goals                                List all installed goals.

我注意到您还可以使用 --help-advanced 标志来查看它们。

为什么其中一些像下面这样标记为“(高级)”？

(ADVANCED)
--pants-bootstrapdir <dir>
                        Use this dir for global cache. (default:
                        /Users/zundel/.cache/pants)
(ADVANCED)
--pants-configdir <dir>
                        Use this dir for global config files. (default:
                        /Users/zundel/.config/pants)

Answer 1

高级选项不适合从命令行使用，因此通常不会显示在传统(-h、--help)命令行帮助中。这些选项旨在使用该存储库的 pants.ini 中的裤子为存储库全局设置一次。配置文件(如果它们需要与裤子标准默认值不同)。事实上，在命令行上显示针对 pants.ini 的这些选项的帮助绝对是奇怪的，从某种意义上说，为这些选项提供文档是一种妥协的便利。

因此，对于拥有一两个用户的小型存储库来说，“高级”可能比许多开发人员使用的大型存储库更用词不当。在小情况下，两个开发人员可能都需要在该存储库中使用裤子的过程中设置或调整其存储库的 pants.ini 。在拥有许多开发人员的大型 repo 案例中，很可能很少有开发人员会调整 pants.ini，因此对于此类 repo 中的普通裤子用户来说，这些选项确实是“高级”的，几乎从来没有用过。