Django-поршень сгенерировал документацию для нескольких обработчиков - PullRequest
0 голосов
/ 27 апреля 2011

У меня проблема с автоматической документацией, сгенерированной в django-pyston.Прямо сейчас у меня так и работает:

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

class FirstHandler(BaseHandler): 
...

doc = generated_doc(FirstHandler)

И работает нормально.Проблема в том, что, когда я добавляю SecondHandler, я не знаю, как мне добавить его в переменную doc.

Документация собственного поршня не так уж хороша, не говоря уже о о некоторых обработчиках.Видя в самом коде ( doc.py ), похоже, что использование document_view должно распространять каждый обработчик автоматически, но это не так (или я делаю это неправильно):

from piston.doc import documentation_view

...

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

1 Ответ

1 голос
/ 31 мая 2011

Вам не нужно иметь строку

doc = generated_doc(FirstHandler)

внутри модуля, содержащего обработчики. Это просто отрывок из плохой документации. Представление документации автоматически выбирает все обработчики, а затем генерирует документацию. Удалите строку, и она должна работать.

...