如何使用 doxygen 为所有 python 文件创建文档（和调用图）

Question

我在一个文件夹中有一个复杂的 python-selenium 测试套件（使用 py.test），我想使用 doxygen 生成所有文件的文档（更重要的是，什么方法调用什么的调用图方法等）。

我已经设置了

EXTRACT_ALL            = YES

但是，当我这样做时

doxygen .

结果仅包含驻留在当前文件夹中的单个文件。该命令忽略驻留在子文件夹中的任何其他 python 脚本。

即使我从子文件夹中指定文件，例如

doxygen selenium/test_nbrunall.py

结果还是一样。

如何包含子文件夹中的所有文件和包？

Answer 1

在这种情况下，一些有用的标签（在 doxygen 配置文件中，可以通过 doxygen -g 生成默认值），尤其是对于尚未记录的代码：

• 递归
• EXTRACT_...
• HAVE_DOT（请注意，您还需要安装 graphviz dot 程序）。
• CALL_GRAPH
• CALLER_GRAPH