Предотвращение выполнения скриптом Sphinx

Question

Я пытаюсь создать генерацию документации python с помощью Sphinx. Проблема в том, что sphinx-build заканчивает выполнение модуля/оценку чего-либо в глобальной области. Есть ли причина, по которой это происходит? И кто-нибудь знает флаг, который можно установить для отключения этого?

Кажется, что Sphinx пытается сделать покрытие кода или что-то подобное, что определенно не то, что я хочу, чтобы он делал. Обычно это не проблема, но определенный набор модулей очень специфичен для среды.

Answer 1

Sphinx оценивает все в глобальном масштабе, потому что модуль плагина autodoc импортирует модули, а импорт модуля оценивает все в глобальной области.

Чтобы остановить это, либо:

• Отключить AutoDoc плагин (поиск autodoc в сфинкса конфигурационном файле), или
• Guard код, который вы не хотите выполняться с чем-то вроде if __name__ == "__main__": do_stuff()