test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Fixed gendered examples in the docs.

This commit is contained in:
Loic Bistuer 2014-02-03 10:00:48 +07:00 committed by =
parent 297c009cf2
commit f265c1ef13
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docs/topics/db/managers.txt
View File

@ -150,23 +150,23 @@ models.
For example:: For example::
class MaleManager(models.Manager): class AuthorManager(models.Manager):
def get_queryset(self): def get_queryset(self):
return super(MaleManager, self).get_queryset().filter(sex='M') return super(AuthorManager, self).get_queryset().filter(role='A')
class FemaleManager(models.Manager): class EditorManager(models.Manager):
def get_queryset(self): def get_queryset(self):
return super(FemaleManager, self).get_queryset().filter(sex='F') return super(EditorManager, self).get_queryset().filter(role='E')
class Person(models.Model): class Person(models.Model):
first_name = models.CharField(max_length=50) first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50) last_name = models.CharField(max_length=50)
sex = models.CharField(max_length=1, choices=(('M', 'Male'), ('F', 'Female'))) role = models.CharField(max_length=1, choices=(('A', _('Author')), ('E', _('Editor'))))
people = models.Manager() people = models.Manager()
men = MaleManager() authors = AuthorManager()
women = FemaleManager() editors = EditorManager()
This example allows you to request ``Person.men.all()``, ``Person.women.all()``, This example allows you to request ``Person.authors.all()``, ``Person.editors.all()``,
and ``Person.people.all()``, yielding predictable results. and ``Person.people.all()``, yielding predictable results.
If you use custom ``Manager`` objects, take note that the first ``Manager`` If you use custom ``Manager`` objects, take note that the first ``Manager``
@ -211,29 +211,29 @@ the ``Manager``, this is only the case for the extra methods defined on a
custom ``QuerySet`` if you also implement them on the ``Manager``:: custom ``QuerySet`` if you also implement them on the ``Manager``::
class PersonQuerySet(models.QuerySet): class PersonQuerySet(models.QuerySet):
def male(self): def authors(self):
return self.filter(sex='M') return self.filter(role='A')
def female(self): def editors(self):
return self.filter(sex='F') return self.filter(role='E')
class PersonManager(models.Manager): class PersonManager(models.Manager):
def get_queryset(self): def get_queryset(self):
return PersonQuerySet(self.model, using=self._db) return PersonQuerySet(self.model, using=self._db)
def male(self): def authors(self):
return self.get_queryset().male() return self.get_queryset().authors()
def female(self): def editors(self):
return self.get_queryset().female() return self.get_queryset().editors()
class Person(models.Model): class Person(models.Model):
first_name = models.CharField(max_length=50) first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50) last_name = models.CharField(max_length=50)
sex = models.CharField(max_length=1, choices=(('M', 'Male'), ('F', 'Female'))) role = models.CharField(max_length=1, choices=(('A', _('Author')), ('E', _('Editor'))))
people = PersonManager() people = PersonManager()
This example allows you to call both ``male()`` and ``female()`` directly from This example allows you to call both ``authors()`` and ``editors()`` directly from
the manager ``Person.people``. the manager ``Person.people``.
.. _create-manager-with-queryset-methods: .. _create-manager-with-queryset-methods: