Sphinx autodoc은 충분히 자동적이지 않습니다.

|

Python에서 5,000개 이상의 라인 프로젝트를 문서화하기 위해 Sphinx를 사용하려고 합니다. 여기에는 약 7개의 기본 모듈이 있습니다. 내가 아는 한, autodoc을 사용하려면 내 파일의 각 파일에 대해 다음과 같은 코드를 작성해야 합니다. project:

.. automodule:: mods.set.tests :members: :show-inheritance: 

너무 많아서 너무 지루합니다. 파일입니다. "mods" 패키지가 문서화되기를 원한다고 지정할 수 있다면 훨씬 쉬울 것입니다. 그러면 Sphinx는 패키지를 재귀적으로 살펴보고 각 하위 모듈에 대한 페이지를 만들 수 있습니다.

그렇지 않으면 모든 .rst 파일을 만드는 스크립트를 작성할 수 있지만 시간이 많이 걸릴 것입니다.