Changes between Version 14 and Version 15 of RemovingTheMagic

Timestamp:

Dec 14, 2005, 4:18:22 PM (19 years ago)

Author:

Adrian Holovaty

Comment:

--

RemovingTheMagic

@@ -115 +115 @@
 == Override default manager name ("objects") ==
 
-'''Status: Not yet done'''
+'''Status: Done'''
 
 If a model already has an {{{objects}}} attribute, you'll need to specify an alternate name for the magic {{{objects}}}.
@@ -125 +125 @@
     last_name = models.CharField(maxlength=30)
     objects = models.TextField()
-    class META:
-        manager = Manager(name='more_objects')
+    people = models.Manager()
 
 p = Person(first_name='Mary', last_name='Jones', objects='Hello there.')
 p.save()
 p.objects == 'Hello there.'
-Person.more_objects.get_list()
+Person.people.get_list()
+}}}
+
+== Multiple managers ==
+
+'''Status: Done'''
+
+You can create as many managers as you want. When necessary (such as on the admin), Django will use the first one defined, in order.
+
+If you define at least one custom manager, it will not get the default "objects" manager.
+
+{{{
+#!python
+class Person(models.Model):
+    first_name = models.CharField(maxlength=30)
+    last_name = models.CharField(maxlength=30)
+    people = models.Manager()
+    fun_people = SomeOtherManager()
 }}}
 
@@ -170 +186 @@
 == API usage: Overriding table-level functions ==
 
-'''Status: Not yet done'''
+'''Status: Done'''
 
 You can override any table-level functions, such as {{{get_list()}}} or {{{get_object()}}}. Do this by creating a custom {{{models.Manager}}} subclass and passing it to your model. The term "manager" could be replaced with some other word.
@@ -181 +197 @@
         # Changes get_list() to hard-code a limit=10.
         kwargs['limit'] = 10
-        return super(PersonManager, self).get_list(self, **kwargs) # Call the "real" get_list() method.
-
-class Person(models.Model):
-    first_name = models.CharField(maxlength=30)
-    last_name = models.CharField(maxlength=30)
-    class META:
-        manager = PersonManager()
+        return models.Manager.get_list(self, **kwargs) # Call the "real" get_list() method.
+
+class Person(models.Model):
+    first_name = models.CharField(maxlength=30)
+    last_name = models.CharField(maxlength=30)
+    objects = PersonManager()
+}}}
+
+== DoesNotExist exception renamed ==
+
+'''Status: Done'''
+
+Instead of {{{people.PersonDoesNotExist}}}, it's not {{{Person.DoesNotExist}}}.
+
+Old:
+{{{
+#!python
+from django.models.myapp import people
+try:
+    people.get_object(pk=1)
+except people.PersonDoesNotExist:
+    print "Not there"
+}}}
+
+New:
+{{{
+#!python
+from path.to.myapp import Person
+try:
+    Person.objects.get_object(pk=1)
+except Person.DoesNotExist:
+    print "Not there"
 }}}