在Google App Engine項目上構建Sphinx Autodoc

我有一個Google App Engine項目，我試圖用Sphinx將其文檔化。我正在嘗試爲我的許多模塊/類/函數使用autodoc功能。在Google App Engine項目上構建Sphinx Autodoc

我的獅身人面像的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。我不認爲它有可能爲我的sys.path提供appengine.api。有一些解決方法嗎？

PS。我沒有和獅身人面像結婚。我會打開epydoc或替代品。

來源

2011-09-27 zzz

您可以在致電make html之前下載AppEngine SDK，然後設置您的PYTHONPATH。

例如，我下載了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-27 15:40:25 jterrace

在Google App Engine項目上構建Sphinx Autodoc

回答

相關問題