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

Question

我对django-pyston中生成的自动文档有疑问。现在我有这个并且有效：

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

您不必拥有该行

doc = generated_doc(FirstHandler)

在包含处理程序的模块中。这只是糟糕的文档中的一小部分。 文档视图自动提取所有处理程序，然后生成文档。删除该行，它应该工作。