summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/orm/base.py
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2022-07-15 12:53:37 -0400
committerMike Bayer <mike_mp@zzzcomputing.com>2022-07-16 16:28:11 -0400
commit9a37ebdf99d0e3fcca53ca8f00f101fe475a1b01 (patch)
tree112107d938b959316253b3988132a2109947889f /lib/sqlalchemy/orm/base.py
parent6104c163eb58e35e46b0bb6a237e824ec1ee1d15 (diff)
downloadsqlalchemy-9a37ebdf99d0e3fcca53ca8f00f101fe475a1b01.tar.gz
update ORM declarative docs for new features
I screwed up a rebase or something so this was temporarily in Ic51a12de3358f3a451bd7cf3542b375569499fc1 Change-Id: I847ee1336381221c0112b67854df022edf596b25
Diffstat (limited to 'lib/sqlalchemy/orm/base.py')
-rw-r--r--lib/sqlalchemy/orm/base.py12
1 files changed, 12 insertions, 0 deletions
diff --git a/lib/sqlalchemy/orm/base.py b/lib/sqlalchemy/orm/base.py
index 63f873fd0..fa653a472 100644
--- a/lib/sqlalchemy/orm/base.py
+++ b/lib/sqlalchemy/orm/base.py
@@ -714,6 +714,18 @@ class Mapped(ORMDescriptor[_T], roles.TypedColumnsClauseRole[_T], TypingOnly):
checkers such as pylance and mypy so that ORM-mapped attributes
are correctly typed.
+ The most prominent use of :class:`_orm.Mapped` is in
+ the :ref:`Declarative Mapping <orm_explicit_declarative_base>` form
+ of :class:`_orm.Mapper` configuration, where used explicitly it drives
+ the configuration of ORM attributes such as :func:`_orm.mapped_class`
+ and :func:`_orm.relationship`.
+
+ .. seealso::
+
+ :ref:`orm_explicit_declarative_base`
+
+ :ref:`orm_declarative_table`
+
.. tip::
The :class:`_orm.Mapped` class represents attributes that are handled