Moving to Django 3.0's Field.choices Enumeration Types2020-01-27
Previously, Django recommended defining some ‘constants’ on your model class to feed into
You would add these as separate class variables and combine them into a list of choices paired with their display strings:
Then your other could use those constants, for example:
If you wanted to use the same set of values for multiple models, you would probably move to the module level:
This leaves a bunch of constants related only by their position in the class or module. It’s a bit against The Zen of Python’s final edict:
Namespaces are one honking great idea – let’s do more of those!
It also leaves us missing some useful functionality. For example there’s no easy way to convert a value into its display label.
Django 3.0 now provides a
Choices class with two subclasses
These extend Python’s
Enum types with extra constraints and functionality to make them suitable for
To convert our example, we want to subclass
TextChoices, because the values are strings stored in a
We then define how names map to values and display labels as class attributes:
We can test we converted correctly by checking no migration changes are detected:
If we had added, removed, or reordered any members, this would have been detected as changes in the fields.
This is because the migration framework only sees the
choices list generated by
Status.choices, not the enumeration classes.
QuerySet filters can be updated to use the
We can also convert values to their display labels easily:
Clearer and cleaner!
I hope this helps you enjoy this new Django 3.0 feature. The Enumeration types documentation covers a few more details and is worth a read.
Thanks to Shai Berger, Nick Pope, Marius Felisiak, Carlton Gibson, and all the others responsible for adding it (ticket #27910).
Interested in Django or Python training? I'm taking bookings for workshops.
One summary email a week, no spam, I promise.
- Django's Field Choices Don't Constrain Your Data
- A Single File Asynchronous Django Application
- How to Add Database Modifications Beyond Migrations to Your Django Project
© 2020 All rights reserved.