[3.0.x] Fixed #32110 -- Doc'd and tested enumerations for ChoiceField.choices.

Backport of 7f85498eef from master
This commit is contained in:
Claude Paroz 2020-10-17 16:17:00 +02:00 committed by Mariusz Felisiak
parent 301bca9394
commit 72a17c919b
2 changed files with 18 additions and 6 deletions

View File

@ -408,12 +408,12 @@ For each field, we describe the default widget used if you don't specify
.. attribute:: choices
Either an :term:`iterable` of 2-tuples to use as choices for this
field, or a callable that returns such an iterable. This argument
accepts the same formats as the ``choices`` argument to a model field.
See the :ref:`model field reference documentation on choices
<field-choices>` for more details. If the argument is a callable, it is
evaluated each time the field's form is initialized. Defaults to an
empty list.
field, :ref:`enumeration <field-choices-enum-types>` choices, or a
callable that returns such an iterable. This argument accepts the same
formats as the ``choices`` argument to a model field. See the
:ref:`model field reference documentation on choices <field-choices>`
for more details. If the argument is a callable, it is evaluated each
time the field's form is initialized. Defaults to an empty list.
``TypedChoiceField``
--------------------

View File

@ -1,3 +1,4 @@
from django.db import models
from django.forms import ChoiceField, Form, ValidationError
from django.test import SimpleTestCase
@ -86,3 +87,14 @@ class ChoiceFieldTest(FormFieldAssertionsMixin, SimpleTestCase):
'<select id="id_f" name="f" disabled><option value="J">John</option>'
'<option value="P">Paul</option></select>'
)
def test_choicefield_enumeration(self):
class FirstNames(models.TextChoices):
JOHN = 'J', 'John'
PAUL = 'P', 'Paul'
f = ChoiceField(choices=FirstNames.choices)
self.assertEqual(f.clean('J'), 'J')
msg = "'Select a valid choice. 3 is not one of the available choices.'"
with self.assertRaisesMessage(ValidationError, msg):
f.clean('3')