在为项目构建epydoc文件时需要有关KeyError的帮助

Question

我有一个包含大量功能测试的pylons项目，我希望我的手册QA能够时不时地阅读，所以我使用epydoc在功能测试模块上构建html pydocs。

它似乎工作得很好。它生成文档，我可以在它们之间导航，而不会出现任何明显的问题。

然而，当我运行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个模块正在发生这种情况。起初，我认为这可能是因为模块的头部或包的__init__中缺少文档字符串，但添加它们并没有解决这个问题。

以下是专门为功能测试编写的epydoc配置文件的副本：

[epydoc]
modules: project.tests.functional.resource,project.tests.functional.views
output: html
sourcecode: yes
#graph: none
target: ../pydoc/ftests
name: PROJECT
# exclude: test
private: no
imports: no
verbosity: 0
include-log: yes

​

下面是用于执行它的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

有什么建议吗？

Answer 1

最后，我所做的只是在epydoc命令上包含--parse--强制它不导入任何东西(因此解决了无法定位导入的问题，但并没有真正回答为什么会发生这种情况)。不是一个完美的解决方案，但它满足了要求...