mirror of https://github.com/django/django.git
[3.0.x] Fixed #32110 -- Doc'd and tested enumerations for ChoiceField.choices.
Backport of 7f85498eef
from master
This commit is contained in:
parent
301bca9394
commit
72a17c919b
|
@ -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``
|
||||
--------------------
|
||||
|
|
|
@ -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')
|
||||
|
|
Loading…
Reference in New Issue