1

我有一个 Google App Engine 项目,我正在尝试用 Sphinx 记录它。我正在尝试对我的许多模块/类/功能使用自动文档功能。

我的 Sphinx reST 标记:

.. automodule:: urls
   :members: Urls

当我运行时make html,我收到错误:

WARNING: autodoc can't import/find module 'urls', it reported error: "No module >named appengine.api", please check your spelling and sys.path

该文件urls导入webapp2,我相信它会反过来尝试导入 appengine.api。我认为它不可能提供appengine.api给我的sys.path. 有一些解决方法吗?

PS。我没有和斯芬克斯结婚。我愿意接受 epydoc 或替代方案。

4

1 回答 1

3

您可以下载AppEngine SDK,然后在调用之前设置您的 PYTHONPATH make html

例如,我下载了 SDK,可以这样做:

$ ls /home/jterrace/Downloads/google_appengine/google/
appengine  __init__.py  net  pyglib  storage
$ PYTHONPATH="/home/jterrace/Downloads/google_appengine/google" python
Python 2.7.1+ (r271:86832, Apr 11 2011, 18:13:53) 
[GCC 4.5.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import appengine
>>> import appengine.api
>>> 

所以,你会做这样的事情:

PYTHONPATH="/home/jterrace/Downloads/google_appengine/google" make html
于 2011-09-27T15:40:25.040 回答