mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-04 10:59:45 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Fixed #30657 -- Allowed customizing Field's descriptors with a descriptor_class attribute.

Browse source 
Allows model fields to override the descriptor class used on the model
instance attribute.
This commit is contained in:
Jon Dufresne 2019-07-23 05:04:06 -07:00 • committed by Mariusz Felisiak
parent 93ffa81bc5
commit 5ed20b3aa3
5 changed files with 62 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/ref/models/fields.txt
View file

@ -1793,6 +1793,16 @@ Field API reference
where the arguments are interpolated from the field's ``__dict__``.
.. attribute:: descriptor_class
.. versionadded:: 3.0
A class implementing the :py:ref:`descriptor protocol <descriptors>`
that is instantiated and assigned to the model instance attribute. The
constructor must accept a single argument, the ``Field`` instance.
Overriding this class attribute allows for customizing the get and set
behavior.
To map a ``Field`` to a database-specific type, Django exposes several
methods:

4
docs/releases/3.0.txt
View file

@ -283,6 +283,10 @@ Models
:class:`~django.db.models.Index` now support app label and class
interpolation using the ``'%(app_label)s'`` and ``'%(class)s'`` placeholders.
* The new :attr:`.Field.descriptor_class` attribute allows model fields to
customize the get and set behavior by overriding their
:py:ref:`descriptors <descriptors>`.
Requests and Responses
~~~~~~~~~~~~~~~~~~~~~~