Commit f8632572 authored by Juergen Schackmann's avatar Juergen Schackmann Committed by Tim Graham
Browse files

Fixed #21212 -- Documented the reverse name for OneToOneField.

Thanks bjb at credil.org for the report.
parent a3372f67
Loading
Loading
Loading
Loading
+24 −0
Original line number Diff line number Diff line
@@ -1325,6 +1325,27 @@ related. This works exactly the same as it does for :class:`ForeignKey`,
including all the options regarding :ref:`recursive <recursive-relationships>`
and :ref:`lazy <lazy-relationships>` relationships.

If you do not specify the the :attr:`~ForeignKey.related_name` argument for
the ``OneToOneField``, Django will use the lower-case name of the current model
as default value.

With the following example::

    from django.db import models
    from django.contrib.auth.models import User

    class MySpecialUser(models.Model):
        user = models.OneToOneField(User)
        supervisor = models.OneToOneField(User, related_name='supervisor_of')

your resulting ``User`` model will have the following attributes::

    >>> user = User.objects.get(pk=1)
    >>> hasattr(user, 'myspecialuser')
    True
    >>> hasattr(user, 'supervisor_of')
    True

.. _onetoone-arguments:

Additionally, ``OneToOneField`` accepts all of the extra arguments
@@ -1337,3 +1358,6 @@ accepted by :class:`ForeignKey`, plus one extra argument:
    link back to the parent class, rather than the extra
    ``OneToOneField`` which would normally be implicitly created by
    subclassing.

See :doc:`One-to-one relationships </topics/db/examples/one_to_one>` for usage
examples of ``OneToOneField``.