Browse files

[1.4.X] Fixed #17388 - Noted in the custom model field docs that fiel…

…d methods need to handle None if the field may be null.

Backport of 4cef9a0 from master
  • Loading branch information...
1 parent fd90a90 commit 700717db1f7e3032cfd89ea80f37eb69bc54a188 @timgraham timgraham committed Oct 19, 2012
Showing with 7 additions and 0 deletions.
  1. +7 −0 docs/howto/custom-model-fields.txt
@@ -447,6 +447,13 @@ called when it is created, you should be using `The SubfieldBase metaclass`_
mentioned earlier. Otherwise :meth:`.to_python` won't be called
+.. warning::
+ If your custom field allows ``null=True``, any field method that takes
+ ``value`` as an argument, like :meth:`~Field.to_python` and
+ :meth:`~Field.get_prep_value`, should handle the case when ``value`` is
+ ``None``.
Converting Python objects to query values

0 comments on commit 700717d

Please sign in to comment.