Corrected docs for declarative synonym incorrectly referring to instruments instead of descriptor.

This commit is contained in:
Michael Trier
2008-10-05 03:30:58 +00:00
parent 4597c678ac
commit f0a40280fd
+3 -3
View File
@@ -123,7 +123,7 @@ class after the fact:
User.addresses = relation(Address, primaryjoin=Address.user_id==User.id)
Synonyms are one area where `declarative` needs to slightly change the usual SQLAlchemy configurational syntax. To define a
getter/setter which proxies to an underlying attribute, use `synonym` with the `instruments` argument:
getter/setter which proxies to an underlying attribute, use `synonym` with the `descriptor` argument:
{python}
class MyClass(Base):
@@ -133,9 +133,9 @@ getter/setter which proxies to an underlying attribute, use `synonym` with the `
def _get_attr(self):
return self._some_attr
def _set_attr(self, attr)
def _set_attr(self, attr):
self._some_attr = attr
attr = synonym('_attr', instruments=property(_get_attr, _set_attr))
attr = synonym('_attr', descriptor=property(_get_attr, _set_attr))
The above synonym is then usable as an instance attribute as well as a class-level expression construct: