summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/orm/identity.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/sqlalchemy/orm/identity.py')
-rw-r--r--lib/sqlalchemy/orm/identity.py12
1 files changed, 12 insertions, 0 deletions
diff --git a/lib/sqlalchemy/orm/identity.py b/lib/sqlalchemy/orm/identity.py
index 46be2b719..b42703855 100644
--- a/lib/sqlalchemy/orm/identity.py
+++ b/lib/sqlalchemy/orm/identity.py
@@ -208,6 +208,18 @@ class WeakInstanceDict(IdentityMap):
class StrongInstanceDict(IdentityMap):
+ """A 'strong-referencing' version of the identity map.
+
+ .. deprecated:: this object is present in order to fulfill
+ the ``weak_identity_map=False`` option of the Session.
+ This option is present to allow compatibility with older applications,
+ but it is recommended that strong references to objects
+ be maintained by the calling application
+ externally to the :class:`.Session` itself, to the degree
+ that is needed by the application.
+
+ """
+
if util.py2k:
def itervalues(self):
return self._dict.itervalues()