epydoc执行python-fi

Question

我有一个python文件，其中有几个类，我想使用epydoc根据我的注释创建一个文档。因此，我在Debian Wheezzy系统的控制台上执行以下操作：

epydoc --html storage_config_tool.py -o ~/

它总是执行python应用程序，文档生成停止在21%。当我使用epydocgui时也是这样。在

当我在一个简单的helloworld程序上测试它时，一切正常。文件有1000多行，所以我无法发布。程序本身运行良好。在

有人知道为什么会这样吗？错误的格式是否会是一个问题，尽管a还找不到任何错误的格式。在

Thx 4帮助

Answer 1

如果没有看到你的代码，很难说出问题出在哪里。但是，听起来好像启动应用程序的代码不受if __name__ == '__main__':语句的保护，因此当epydoc导入文件时，应用程序将运行。有两件事可能会有所帮助：

1. 修复storage_config_tool.py，以便在导入模块时只执行class、def和赋值语句。

2. 使用epydoc html parse-only storage_config_tool.py -o ~/生成文档。这将跳过模块导入步骤，该步骤可能是生成完整文档所必需的，也可能不是必需的。