Ruff empty-docstring (D419)

empty-docstring в Ruff проверяет код на предупреждение D419. Правило относится к группе pydocstyle.

Почему это неправильно

Docstring помогает понять публичный интерфейс и должна быть оформлена так, чтобы её корректно читали люди и инструменты.

Если валидатор показывает это предупреждение, исправьте место, на которое указывает Ruff, ориентируясь на смысл правила empty-docstring и пример ниже.

Пример ошибки

def average(values: list[float]) -> float:
    """"""

Как правильно

def average(values: list[float]) -> float:
    """Return the mean of the given values."""

Автоисправление

Ruff не предлагает автоисправление для этого правила.