python: должны ли имена декораторов быть действиями или описаниями?

Question

Скажем, у меня есть декоратор, который заставляет функцию распечатывать любые исключения и возвращать None, если происходит исключение, вместо отказа. Предполагая, что это хорошая идея, какой предпочтительный стиль именования?

)

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

б)

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

То есть: он должен a) быть командой (декоратор говорит функцию для того чтобы сделать что-то другое), или b) описание (декоратор позволяет прогамеру знать атрибут функции)?

Answer 1

Я думаю, что активная версия (ignore_exceptions) больше используется, чем описательная версия (ignores_exceptions), по крайней мере, в базовых кодах Python, с которыми я знаком.

В руководстве PEP 8 есть раздел на naming conventions, но в этом случае он не предлагает большой помощи. В любом случае, согласованность между вашей базой кода является самой важной вещью.

Answer 2

Я бы сказал, что ignore_exceptions здесь лучше, просто на основе того, что я вижу на странице PythonDecoratorLibrary.

Некоторые имена декоратор примеры используются есть countcalls и dump_args, которая в большей степени соответствует ignore_exceptions чем ignores_exceptions.

Консистенция - это единственная причина выбора одного над другим, поскольку оба дают понять, что происходит.