python:装饰器名称应该是动作还是描述？

Question

假设我有一个装饰器,它导致函数打印出任何异常并返回None,如果发生异常,而不是失败.假设这是个好主意,那么首选的命名风格是什么？

一个)

@ignore_exceptions
def foobar(a, b, c):
    raise ValueError("This function always fails...")

b)

@ignores_exceptions
def foobar(a, b, c):
    raise ValueError("This function always fails...")

那就是:它应该a)是一个命令(装饰器告诉函数做一些不同的事情),还是b)描述(装饰器让程序员知道函数的属性)？

Answer 1

我认为活动版本(ignore_exceptions)比描述版本(ignores_exceptions)更常用,至少在我熟悉的Python代码库中.

PEP 8指南确实有一个关于命名约定的部分,但在这种情况下它没有提供太多帮助.无论如何,代码库的一致性是最重要的.