我开始使用Sphinx来记录我的sqlalchemy驱动的应用程序。
SA在属性操作中的一个典型用法是使用hybrid-property
装饰器。
现在我的问题是我没有获得name
的文档条目:
class User(GeneralTable):
'''User'''
...
@hybrid_property
def name(self):
'''
User name
:rtype: unicode
'''
if self._name is None:
return 'anonymous'
else:
return self._name
@name.setter
def name(self, name):
'''
:type name: unicode
'''
self._name = name
将hybrid_property
更改为标准property
时,我会将其记录下来。
有没有办法扩展Sphinx以采用hybrid_property
相同的property
行为?
我目前的解决方法是在.. attribute::
类doc中添加名称User
。