Как заставить Sphinx уважать импорт классов в пакет с помощью __init__.py
У меня есть пакет:
Foofoo.pybar.py__init__.pyУ foo.py есть класс Foo. В __init__.py я импортирую класс Foo, чтобы пользователи могли делать:
from foo import Foo
Сфинкс справедливо документирует Foo как foo.foo.Foo, что правильно, но запутывает пользователей. Как мне заставить Сфинкса задокументировать это как foo.Foo?
Также важно получить полную документацию модуля, связанную с правильным модулем.
Сфинкс документирует то, что называется:
..module:: module.name
но когда я использую его в первом комментарии вfoo.py
файл, документ до сих пор приписываетсяfoo.foo
.