Changes between Version 146 and Version 147 of RemovingTheMagic

Timestamp:

May 10, 2006, 2:34:25 PM (19 years ago)

Author:

Tom Tobin <korpios@…>

Comment:

You can code-escape with backticks. :-) (Doesn't help with the TOC, though.)

RemovingTheMagic

@@ -452 +452 @@
 }}}
 
-=== __repr__() model method is replaced by __str__() ===
-
-Or seems to be afaics. Hm, how do I get those underscores to display as underscores instead of underline formatting?
+=== `__repr__()` model method is replaced by `__str__()` ===
+
+You should use `__str__()` where `__repr__()` was formerly used, i.e., as a string representation of the model.
+
+`__repr__()` returns to its standard Python purpose of returning a string suitable for debugging purposes (e.g., `<ObjectName more_info>`); unless you want to customize the returned string, explicitly overriding `__repr__` in a model class is unnecessary.
+
+For example::
+
+{{{
+class BlogPost(models.Model):
+
+    [...]
+
+    def __repr__(self):
+        return '''<BlogPost title="%s" comments_enabled=%s>''' % (self.title, self.comments_enabled)
+
+    def __str__(self):
+        return self.title
+}}}
+
 
 === Database connection relocated/renamed ===