Я пытаюсь использовать sphinx для документирования приложения django, которое я пишу. На данный момент у меня есть настройка code.rst
для просмотра models.py
, и когда я запускаю make html
, я получаю автоматическую документацию, однако получаю предупреждение:
ВНИМАНИЕ: autodoc не может импортировать/найти атрибут myapp.models.MyModel.image, сообщает об ошибке: "image", проверьте правописание и sys.path
Весь журнал трассировки:
Traceback (most recent call last):
File "C:\blah\lib\site-packages\sphinx\ext\autodoc.py", line 326, in import_object
obj = self.get_attr(obj, part)
File "C:\blah\lib\site-packages\sphinx\ext\autodoc.py", line 232, in get_attr
return safe_getattr(obj, name, *defargs)
File "C:\blah\lib\site-packages\sphinx\util\inspect.py", line 70, in safe_getattr
raise AttributeError(name)
AttributeError: image
MyModel.image
— это поле изображения, просто в модели, определяемое как:
#: image file location for ``MyModel``
image = models.ImageField(upload_to="images/")
Например, если я изменю изображение на models.Charfield
, оно будет работать нормально. Есть ли причина, по которой ImageField
может вызвать проблемы со сфинксом?
мой код.первый:
.. automodule:: dynamicbanners.models
:members:
my_attr = None
, потому что они не были инициализированы, и я прочитал ответы, которые предлагают может это баг? Я был бы очень удивлен, что НИКТО еще не сталкивался с этой проблемой. Это кажется странно специфичным дляmodels.ImageField
(хотя только что протестировано, это также происходит сmodels.FileField
. - person ptr   schedule 12.11.2013