与关键字/标准库冲突的变量名称的公认约定

Question

我有一个函数，我将 adatetime.date和timeobject 作为参数。假设我还想要一个需要命名的参数break或非常相似的参数。我显然不能break在不抛出SyntaxError.

为避免与标准 Python 库名称或关键字发生冲突，最广为接受的重命名约定是什么？

Answer 1

根据风格指南：

• single_trailing_underscore_: 按惯例使用以避免与 Python 关键字冲突，例如

  Tkinter.Toplevel(master, class_='ClassName')
  

具体来说，对于参数：

如果函数参数的名称与保留关键字发生冲突，通常最好附加一个尾随下划线，而不是使用缩写或拼写错误。因此class_优于clss. （也许更好的是通过使用同义词来避免这种冲突。）

和属性名称：

• 如果您的公共属性名称与保留关键字相冲突，请在您的属性名称后添加一个尾随下划线。这比缩写或拼写错误更可取。（然而，尽管有这条规则，cls对于已知是类的任何变量或参数，尤其是类方法的第一个参数，它是首选拼写。）