pydoc에서 서브 디렉토리를 생성 할 수 있습니까?

Question

pydoc의 writedocs() 함수로 패키지의 하위 디렉토리를 만들 수있는 방법이 있습니까? 예를 들어, 내가 문서에 다음과 같은 모듈을 가정 해 봅시다 :

foo.py 
dir/bar.py 
dir/__init__.py 

나는 pydoc.writedocs를(), 나는 다음과 같은 파일을 가져 실행할 때 : 내가 좋아하는 것

foo.html 
dir.bar.html 

이 얻을 :

를

foo.html 
dir/bar.html 

이렇게 할 방법이 있습니까?

Answer 1

pydoc.writedocs은 "현재 디렉토리에 파일 쓰기"로 문서화 된 (구현 된) writedoc을 루프합니다. 내가 볼 수있는 유일한 방법은 수정 된 버전을 만들어 모듈에 억지로 넣거나 (즉, 한숨을내어 대칭 맞추기) 모듈의 핵심 요소를 monkeypatching하는 것입니다. 즉, 'open'이 HTML 파일을 작성하기 위해 열리는 곳입니다 열기 위해. 특히, 코드, 당신은 같은 것을 할 수있는 :

import pydoc 

def monkey_open(name, option): 
    if option == 'w' and name.endswith('.html'): 
    name_pieces = name.split('.') 
    name_pieces[-2:] = '.'.join(name_pieces[-2:]) 
    name = '/'.join(name_pieces) 
    return open(name, option) 

pydoc.open = monkey_open 

하지 우아한 또는 매우 강력한 솔루션을하지만, "요구가 있어야합니다"... pydoc이 단지 당신이 원하는 것을 할 수 있도록 설계되지 않았습니다, 그래서 그 물건은 "shoehorned"하게 될 필요가있다.