summaryrefslogtreecommitdiff
path: root/tests/testapp/models/m2o_recursive.py
blob: 27d13b4e7e85ff186051fc9262c4e74a5eb529d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
"""
11. Relating an object to itself, many-to-one

To define a many-to-one relationship between a model and itself, use
``ForeignKey('self')``.

In this example, a ``Category`` is related to itself. That is, each
``Category`` has a parent ``Category``.

Set ``related_name`` to designate what the reverse relationship is called.
"""

from django.core import meta

class Category(meta.Model):
    name = meta.CharField(maxlength=20)
    parent = meta.ForeignKey('self', null=True, related_name='child')
    class META:
        module_name = 'categories'

    def __repr__(self):
        return self.name

API_TESTS = """
# Create a few Category objects.
>>> r = categories.Category(id=None, name='Root category', parent=None)
>>> r.save()
>>> c = categories.Category(id=None, name='Child category', parent=r)
>>> c.save()

>>> r.get_child_list()
[Child category]
>>> r.get_child(name__startswith='Child')
Child category
>>> r.get_parent()
Traceback (most recent call last):
    ...
CategoryDoesNotExist

>>> c.get_child_list()
[]
>>> c.get_parent()
Root category
"""