将 __author__ 附加到模块中的各个类

Question

是否可以将__author__ 属性附加到模块中的特定类或方法？我只熟悉为整个模块提供作者信用的语法，但我管理的包有多个作者在同一（大）模块的不同部分上工作。

Answer 1

我个人认为在模块或类级别上都有__author__ 是不必要的噪音：

• 你的版本控制系统已经有这类信息

• 如果您想明确列出作者 - 将它们放入项目根目录中的特殊 AUTHORS（或 authors.txt 或 contributors.txt）文件中，请参阅：

  • What is the format of an authors file for git svn, specifically for special characters like backslash or underscore?
  • Django's AUTHORS file
• 或list the authors in the setup.py（如果您正在制作有效的python包）

有关“作者”的多个优点的相关主题：

• Javadoc @author tag good practices