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它的一些关键方面，即“打开”打开以写入它所要求的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 的设计目的不是让您做您想做的事，因此需要“硬塞进去”一点。