epydoc执行python文件

Question

我有一个python文件，里面有几个类，我想用epydoc从我的评论中创建一个文档。所以我在我的Debian wheezy系统上的控制台上这样做：

epydoc --html storage_config_tool.py -o ~/

它总是执行python应用程序，并且文档生成停止于21%。当我使用epydocgui时也有同样的行为。

当我在一个简单的hello world程序上测试它时，一切都很好。这个文件超过1000行，所以我不能发布它。程序本身运行良好。

没有人知道为什么会发生这种事？格式错误会不会是一个问题，尽管现在还找不到。

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 ~/生成文档。这将跳过模块导入步骤，该步骤对于生成完整的documentation.

可能是必要的，也可能不是