我有一个pylons项目,有一套广泛的功能测试,我希望我的手册QA能够不时阅读,所以我使用epydoc在功能测试模块上构建HTMLPYdoc。
它似乎工作得很好。它生成文档,我可以浏览它们而不会出现任何明显的问题。
但是,我在运行epydoc构建时遇到了一个奇怪的错误,我不确定如何修复它:
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| In project.tests.functional.resource:
| Import failed (but source code parsing was successful).
| Error: KeyError: '__file__' (line 28)
|
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| In /Eclipse/product/project/server/src/project/tests/functional/resource/ftest_module1.py:
| Import failed (but source code parsing was successful).
| Error: KeyError: '__file__' (line 28)
|
+------------------------------------------------------------------------------------------
总共有2个包和8个模块在上面发生这种情况。一开始我想,可能是模块头上没有docstring,也可能是包的初始化中没有docstring,但是添加它们并不能解决这个问题。在
以下是专门为功能测试编写的epydoc config文件的副本:
^{pr2}$下面是用于执行它的shell脚本的副本:
#!/usr/bin/env bash
basedir=${0%/*}
cd "$basedir/../src"
etc="../etc"
pydoc="../pydoc"
pydoc_ftests="../pydoc/ftests"
mkdir -p $pydoc
mkdir -p $pydoc_ftests
epydoc -v --config $etc/epydoc.config
epydoc -v --config $etc/epydoc.ftests.config
有什么建议吗?在
最后,我所做的只是在epydoc命令中只包含parse,以强制它不导入任何内容(从而解决了无法加载的导入问题,但没有真正回答为什么会发生这种情况)。不是一个完美的解决方案,但它满足了要求。。。在
相关问题 更多 >
编程相关推荐