django-piston爲幾個處理程序生成的文檔

Question

我在django-pyston中生成的automagic文檔遇到問題。現在我有這個工作：

from piston.handler import BaseHandler 
from piston.doc import generate_doc 

class FirstHandler(BaseHandler): 
... 

doc = generated_doc(FirstHandler) 

而且工作正常。問題是當我添加一個SecondHandler時，我不知道該如何將它添加到doc變量中。

活塞自己的文檔不是很好，不要提anything about several handlers。在代碼本身（doc.py）看到似乎是使用documentation_view應自動傳播每處理器，但它沒有（或者我做錯了）：

from piston.doc import documentation_view 

... 

urlpatterns = patterns('', 
    (r'^/doc$', documentation_view), 
... 
) 

Answer 1

你不必有line

doc = generated_doc(FirstHandler) 

在包含處理程序的模塊中。這只是糟糕的文檔中的一個小小的提示。 文檔視圖自動獲取所有處理程序，然後生成文檔。刪除線，它應該工作。