From 57dc0581462f2014e56c6f30a2ad8caf3d33f9c5 Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Thu, 7 Aug 2014 09:59:59 -0400 Subject: [PATCH] - clarify docs that contains_eager() is included in the of_type() system, fix #2438 --- doc/build/orm/inheritance.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/build/orm/inheritance.rst b/doc/build/orm/inheritance.rst index d68228259c..3b6a284d07 100644 --- a/doc/build/orm/inheritance.rst +++ b/doc/build/orm/inheritance.rst @@ -472,7 +472,8 @@ subselect back to the parent ``companies`` table. Eager Loading of Specific or Polymorphic Subtypes ++++++++++++++++++++++++++++++++++++++++++++++++++ -The :func:`.joinedload` and :func:`.subqueryload` options also support +The :func:`.joinedload`, :func:`.subqueryload`, :func:`.contains_eager` and +other loading-related options also support paths which make use of :func:`~sqlalchemy.orm.interfaces.PropComparator.of_type`. Below we load ``Company`` rows while eagerly loading related ``Engineer`` objects, querying the ``employee`` and ``engineer`` tables simultaneously:: @@ -497,11 +498,13 @@ can be loaded:: ) .. versionadded:: 0.8 - :func:`.joinedload` and :func:`.subqueryload` support + :func:`.joinedload`, :func:`.subqueryload`, :func:`.contains_eager` + and related loader options support paths that are qualified with :func:`~sqlalchemy.orm.interfaces.PropComparator.of_type`, supporting single target types as well as :func:`.orm.with_polymorphic` targets. + Single Table Inheritance ------------------------ -- 2.47.3