python - 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 变量中。

Piston 自己的文档不是那么好，不要提及有关几个处理程序的任何内容。看到代码本身（doc.py）似乎是使用 documentation_view 应该自动传播每个处理程序，但它没有（或者我做错了）：

from piston.doc import documentation_view

...

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

Answer 1

你不必排队

doc = generated_doc(FirstHandler)

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