Я не вижу упоминания ни в одном руководстве по стилю. Должен ли я комбинировать подобные типы исключений или разделить их на отдельные строки:Как мне группировать подобные исключения в docstring?
"""
This is a Google style docs.
...
...
Raises:
TypeError: foo() missing 1 required positional argument. Key must be a numeric value.
KeyError: bar
"""
или это:
"""
This is a Google style docs.
...
...
Raises:
TypeError: foo() missing 1 required positional argument
TypeError: key must be a numeric value
KeyError: bar
"""
Вы прочитали https://www.python.org/dev/peps/pep-0257/? –
Я предпочел бы второй, будет держать докшлингу более читабельным. Если одна и та же ошибка возникает по более чем двум причинам, она будет держать линии короче. –
@VivekSable Это ничего не говорит о том, что пытается делать OP, не так ли? –