From 5de2e17b6e6686adf0a87038e90b001978187c0a Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Fri, 2 Mar 2018 11:58:52 -0500 Subject: [PATCH] - add some seealsos for the transient object that loads use case Change-Id: Ibfa79a3721f31806223906cccf4547673b3d42f1 --- lib/sqlalchemy/orm/session.py | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/lib/sqlalchemy/orm/session.py b/lib/sqlalchemy/orm/session.py index 13f78317cf..9ac529aeb7 100644 --- a/lib/sqlalchemy/orm/session.py +++ b/lib/sqlalchemy/orm/session.py @@ -1892,6 +1892,11 @@ class Session(_SessionClassMethods): method. + .. seealso:: + + :func:`.make_transient_to_detached` - provides for an alternative + means of "merging" a single object into the :class:`.Session` + """ if self._warn_on_events: @@ -2152,6 +2157,10 @@ class Session(_SessionClassMethods): allows per-relationship loading of many-to-ones on items that are pending. + :func:`.make_transient_to_detached` - allows for an object to + be added to a :class:`.Session` without SQL emitted, which then + will unexpire attributes on access. + """ state = attributes.instance_state(obj) to_attach = self._before_attach(state, obj) @@ -3051,6 +3060,8 @@ def make_transient_to_detached(instance): :func:`.make_transient` + :meth:`.Session.enable_relationship_loading` + """ state = attributes.instance_state(instance) if state.session_id or state.key: -- 2.47.2