Commit fd904534 authored by Julien Phalip's avatar Julien Phalip
Browse files

Fixed #16742 -- Provided code examples in the models documentation for... 

Fixed #16742 -- Provided code examples in the models documentation for accessing extra fields on many-to-many relationships. Many thanks to aj for the suggestion and to Nick Lang for the patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16817 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent 7f45651f

docs/topics/db/models.txt

+20 −1
Original line number Diff line number Diff line
@@ -519,6 +519,25 @@ As you are using an intermediate model, you can also query on its attributes:: 
    ...     membership__date_joined__gt=date(1961,1,1))

    [<Person: Ringo Starr]



If you need to access a membership's information you may do so by directly

querying the ``Membership`` model::



    >>> ringos_membership = Membership.objects.get(group=beatles, person=ringo)

    >>> ringos_membership.date_joined

    datetime.date(1962, 8, 16)

    >>> ringos_membership.invite_reason

    u'Needed a new drummer.'



Another way to access the same information is by querying the

:ref:`many-to-many reverse relationship<m2m-reverse-relationships>` from a

``Person`` object::



    >>> ringos_membership = ringo.membership_set.get(group=beatles)

    >>> ringos_membership.date_joined

    datetime.date(1962, 8, 16)

    >>> ringos_membership.invite_reason

    u'Needed a new drummer.'





One-to-one relationships

~~~~~~~~~~~~~~~~~~~~~~~~

docs/topics/db/queries.txt

+2 −0
Original line number Diff line number Diff line
@@ -1036,6 +1036,8 @@ Each "reverse" operation described in this section has an immediate effect on 
the database. Every addition, creation and deletion is immediately and

automatically saved to the database.



.. _m2m-reverse-relationships:



Many-to-many relationships

--------------------------