Функция doc в Python может возвращать значение None по нескольким причинам:
- Неправильное расположение описания функции. 1 Оно должно находиться сразу после знака двоеточия (:). 1 В противном случае докстринг будет парситься сразу после инициализации функции, и описание не будет относиться к докстрингу. 1
- Использование переключателя -OO при запуске интерпретатора. 2 Этот переключатель отключает докстринг. 2 Также за это отвечает переменная среды PYTHONOPTIMIZE. 2
Ещё одна возможная причина, по которой функция doc может возвращать None, — использование функции print(). 4 Она выводит переданные аргументы на стандартное устройство вывода (экран), но при этом не возвращает значений, то есть можно считать, что возвращает None. 4