【发布时间】：2012-03-20 19:53:21
【问题描述】：
在模块中使用私有元数据变量（如 __author__）的约定从何而来？
ThisPython 邮件列表线程似乎暗示了 2001 年有关它的一些讨论，但从它的声音来看，约定已经很流行了。
除此之外，我只能找到this PEP on package metadata，这似乎有影响力，但充其量是切题。
我想尝试找到一些关于该主题的明确材料，以便我的文档工具可以成功解析这些元数据变量。
【问题讨论】：
【发布时间】：2012-03-20 19:53:21
【问题描述】：
我的猜测是，这是从那时打包元数据不常见的旧时代开始的。 在 PEP 8 中，鼓励使用 _version_ 顶级变量来保存正在使用的版本控制系统的修订 ID。这可以追溯到 2001-05-01。 PEP 396 正在取代模块 _version_ 属性。
对于_作者_，python 开发邮件列表中有一篇关于此问题的帖子。这可以追溯到 2001-03-01。作者质疑_author_的用法：“接下来是什么？_cute_signoff_？”。
由于 PEP 中没有提及，所以不用担心_作者_。无论如何，打包元数据是我们的朋友。
http://mail.python.org/pipermail/python-dev/2001-March/013328.html
Ping 刚刚签入： > 日志消息： > 添加 __author__ 和 __credits__ 变量。 > > > 索引：tokenize.py > ================================================== =================== > RCS 文件：/cvsroot/python/python/dist/src/Lib/tokenize.py,v > 检索修订版 1.19 > 检索修订版 1.20 > 差异 -C2 -r1.19 -r1.20 > *** tokenize.py 2001/03/01 04:27:19 1.19 > --- tokenize.py 2001/03/01 13:56:40 1.20 > *************** > *** 10,14 *** > 它为 cmets 生成 COMMENT 标记，并为所有运算符提供类型 OP。""" > > ！ __version__ = "Ka-Ping Yee，1997 年 10 月 26 日；已修补，GvR 3/30/98" > > 导入字符串，重新 > --- 10,15 ---- > 它为 cmets 生成 COMMENT 标记，并为所有运算符提供类型 OP。""" > > ！ __author__ = 'Ka-Ping Yee' > ！ __credits__ = '第一个版本，1997 年 10 月 26 日；已修补，GvR 3/30/98' > > 导入字符串，重新 我对插入的 __credits__ 变量有点不舒服 这里。首先，__credits__ 并没有真正描述 给出的信息。其次，这个信息不属于CVS吗 历史？我不是为了包含模块历史的随机提取 在源代码中——这很可能不是 日期。 （例如，从 CVS 日志中不清楚为什么我的贡献 值得一提，而蒂姆没有——看起来蒂姆可能 比我花更多的时间思考它。） 另一个不舒服的来源是绝对没有标准 对于这种元数据变量。我们有__version__，而我 相信我们曾经就这一点达成一致（在 1994 年左右:-)。但是__作者__？ __学分__？接下来是什么——__cute_signoff__？【讨论】：
-
鉴于此，可能无法可靠地解析 __author__ 或 __credits__ 属性。