summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeffrey Finkelstein <jeffrey.finkelstein@gmail.com>2016-05-03 20:46:20 -0400
committerJeffrey Finkelstein <jeffrey.finkelstein@gmail.com>2016-05-03 20:46:20 -0400
commite6251c3e40e623aaadc7356c0b3c94101710079c (patch)
tree17916801a867be8f03063009adfdc0ea32017baa
parent9a3c9ba7beb18dfd6232deb895528ea8593a12b0 (diff)
downloadsqlalchemy-pr/267.tar.gz
Corrects some references in ORM documentation.pr/267
-rw-r--r--doc/build/faq/ormconfiguration.rst3
-rw-r--r--lib/sqlalchemy/orm/mapper.py18
2 files changed, 12 insertions, 9 deletions
diff --git a/doc/build/faq/ormconfiguration.rst b/doc/build/faq/ormconfiguration.rst
index 3a2ea29a6..faaee449e 100644
--- a/doc/build/faq/ormconfiguration.rst
+++ b/doc/build/faq/ormconfiguration.rst
@@ -89,7 +89,8 @@ To get at the :class:`.Mapper` for a particular mapped class, call the
mapper = inspect(MyClass)
-From there, all information about the class can be acquired using such methods as:
+From there, all information about the class can be accessed through properties
+such as:
* :attr:`.Mapper.attrs` - a namespace of all mapped attributes. The attributes
themselves are instances of :class:`.MapperProperty`, which contain additional
diff --git a/lib/sqlalchemy/orm/mapper.py b/lib/sqlalchemy/orm/mapper.py
index 06d903e9c..858c35344 100644
--- a/lib/sqlalchemy/orm/mapper.py
+++ b/lib/sqlalchemy/orm/mapper.py
@@ -2121,7 +2121,7 @@ class Mapper(InspectionAttr):
.. warning::
- the :attr:`.Mapper.relationships` accessor namespace is an
+ The :attr:`.Mapper.attrs` accessor namespace is an
instance of :class:`.OrderedProperties`. This is
a dictionary-like object which includes a small number of
named methods such as :meth:`.OrderedProperties.items`
@@ -2167,14 +2167,15 @@ class Mapper(InspectionAttr):
.. warning::
- the :attr:`.Mapper.relationships` accessor namespace is an
+ The :attr:`.Mapper.all_orm_descriptors` accessor namespace is an
instance of :class:`.OrderedProperties`. This is
a dictionary-like object which includes a small number of
named methods such as :meth:`.OrderedProperties.items`
and :meth:`.OrderedProperties.values`. When
accessing attributes dynamically, favor using the dict-access
- scheme, e.g. ``mapper.attrs[somename]`` over
- ``getattr(mapper.attrs, somename)`` to avoid name collisions.
+ scheme, e.g. ``mapper.all_orm_descriptors[somename]`` over
+ ``getattr(mapper.all_orm_descriptors, somename)`` to avoid name
+ collisions.
.. versionadded:: 0.8.0
@@ -2214,8 +2215,8 @@ class Mapper(InspectionAttr):
@_memoized_configured_property
def relationships(self):
- """Return a namespace of all :class:`.RelationshipProperty`
- properties maintained by this :class:`.Mapper`.
+ """A namespace of all :class:`.RelationshipProperty` properties
+ maintained by this :class:`.Mapper`.
.. warning::
@@ -2225,8 +2226,9 @@ class Mapper(InspectionAttr):
named methods such as :meth:`.OrderedProperties.items`
and :meth:`.OrderedProperties.values`. When
accessing attributes dynamically, favor using the dict-access
- scheme, e.g. ``mapper.attrs[somename]`` over
- ``getattr(mapper.attrs, somename)`` to avoid name collisions.
+ scheme, e.g. ``mapper.relationships[somename]`` over
+ ``getattr(mapper.relationships, somename)`` to avoid name
+ collisions.
.. seealso::