Pylint сообщает об ошибке для каждой функции и метода (кроме __init__
), у которой нет docstring.
Это обычно желательно, поэтому я не хочу отключать его глобально (в pylintrc
или на уровне файла).
Однако, на мой взгляд, бывают случаи, когда докшрин не нужен и даже вреден. Например:
def get_foo(self, foo_id):
"""Gets foo by its id.""""
return foos[foo_id]
Этот метод является простым геттером, который полностью описывается его сигнатурой. Требование написать docstring вредно в том, что оно создает дублирующее обслуживание, если метод изменен.
Я хотел бы установить (например, в pylintrc
) что-то вроде docstring_threshold=3
, чтобы подавить отсутствующие ошибки docstring, если функция или метод короче 3 строк кода. Есть ли способ сделать это?