django-piston为多个处理程序生成文档

Question

我有一个关于在django-pyston中生成的自动化文档的问题。现在，我有了这个，并且工作正常：

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

class FirstHandler(BaseHandler): 
...

doc = generated_doc(FirstHandler)

并且工作得很好。问题是当我添加一个文档时，我不知道如何将它添加到SecondHandler变量中。

Piston自己的文档不是很好，不要提到anything about several handlers。从代码本身(doc.py)可以看出，使用documentation_view应该自动传播每个处理程序，但它不会(或者我做错了)：

from piston.doc import documentation_view

...

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

Answer 1

你不一定要有台词

doc = generated_doc(FirstHandler)

在包含处理程序的模块中。这只是很差的文档中的一小部分。documentation视图自动获取所有处理程序，然后生成文档。去掉这一行，它就可以工作了。