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 )到模块中，或者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并不是被设计成允许你做你想做的事情，所以它需要被硬塞进去一点。