将__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