From a2eaea8f22305b57dff3ab13add2e2887287bb6f Mon Sep 17 00:00:00 2001 From: "T. Franzel" Date: Sat, 11 Mar 2023 00:34:13 +0100 Subject: Fixed #34388 -- Allowed using choice enumeration types directly on model and form fields. --- docs/ref/models/fields.txt | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'docs/ref/models') diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index c1267507b2..447668bbc5 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -210,7 +210,7 @@ choices in a concise way:: year_in_school = models.CharField( max_length=2, - choices=YearInSchool.choices, + choices=YearInSchool, default=YearInSchool.FRESHMAN, ) @@ -235,8 +235,7 @@ modifications: * A ``.label`` property is added on values, to return the human-readable name. * A number of custom properties are added to the enumeration classes -- ``.choices``, ``.labels``, ``.values``, and ``.names`` -- to make it easier - to access lists of those separate parts of the enumeration. Use ``.choices`` - as a suitable value to pass to :attr:`~Field.choices` in a field definition. + to access lists of those separate parts of the enumeration. .. warning:: @@ -276,7 +275,7 @@ Django provides an ``IntegerChoices`` class. For example:: HEART = 3 CLUB = 4 - suit = models.IntegerField(choices=Suit.choices) + suit = models.IntegerField(choices=Suit) It is also possible to make use of the `Enum Functional API `_ with the caveat @@ -320,6 +319,10 @@ There are some additional caveats to be aware of: __empty__ = _("(Unknown)") +.. versionchanged:: 5.0 + + Support for using enumeration types directly in the ``choices`` was added. + ``db_column`` ------------- -- cgit v1.3