CPython не использует autodoc для своей документации - мы используем рукописную прозу.
Для PEP 3144 (модуль ipaddress) я хотел бы использовать sphinx-apidoc для создания исходной справочной документации. Это означает, что я хочу выполнить двухпроходную операцию:
-
Используйте sphinx-apidoc для извлечения проекта Sphinx для модуля, который зависит от autodoc
-
Запустите создатель sphinx, который создает новые исходные файлы reStructuredText, при этом все директивы autodoc заменяются встроенным контентом reStructuredText и разметкой, которая производит тот же вывод
Первый шаг прост, но я понятия не имею, как сделать второй шаг и даже не думаю о хороших способах поиска любых существующих проектов в этих строках.