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也会自动生成这些字段).

所有这一切都可以通过浏览来源找到,但似乎没有任何其他单一地方编译这些信息 - 或者至少,没有一个在谷歌排名很好.