python - pydoc 支持 python 元数据，例如 __version__ = '0.1'

Question

我什至不确定这些东西的正式名称，不过，Python 有元数据，通常位于模块文件的顶部，例如__version__ = '0.1'.

如何找到 PyDoc 支持的所有列表？

Answer 1

任何遵循特定命名约定的顶级私有全局变量都将包含在PydocData生成的部分下：

• 所有正常的全局变量都显示在那里——你可以通过在一个带有一些全局变量的模块上运行pydoc来看到这一点，否则这些变量是空的。
• 显示“特殊”名称（但不显示私有名称）：类似__SomeClass__或__a_special_variable__将显示名称，但不会显示类似名称__this_is_private。
• 显示命名元组，以及与指定它们的模式匹配的任何内容：对象的名称以开头_并且对象具有_fields属性（即，它具有公共字段）。

这些基本规则有例外；保留列表中的名称没有得到相同的处理：

{'__author__', '__builtins__', '__cached__', '__credits__',
 '__date__', '__doc__', '__file__', '__initializing__',
 '__loader__', '__module__', '__name__', '__package__',
 '__path__', '__qualname__', '__slots__', '__version__'}

Pydoc 将自动为__version__、__date__、__author__和__credits__. 其他是“冗余的或内部的”（例如__name__并__package__分配给它们自己的部分，但无论您是否设置它们，Pydoc 也会自动生成这些字段）。

所有这些都可以通过浏览源找到，但似乎没有任何其他地方可以编译这些信息——或者至少，在谷歌中没有一个排名很高的地方。