Change Log

v2.2.2 (2025-04-18)

• Minor doc fixes.

v2.2.1 (2025-04-18)

• First release under django-commons ownership!

• Fix all links to reflect new home @ django-commons

v2.2.0 (2025-03-28)

• Implemented Need a DRF integration for FlagFields

• Fixed FilterSet override of filter_for_lookup disregards meta options.

• Implemented Add EnumFlagFilter to support has_any and has_all flag queries.

• Fixed Enum types that resolve to primitives of str or int but that do not inherit from those types can result in validation errors.

• Implemented Support checkboxes for FlagEnumField

• Implemented Support radio buttons for EnumChoiceField

• Implemented If default is not provided for flag fields it should be Flag(0).

• Fixed EnumFlagFields set empty values to Flag(0) when model field has null=True, default=None

• Fixed Large enum fields that inherit from binaryfield have editable=False by default

• Fixed EnumFlagField breaks for Flag types that are not constructible from lists of values

• Implemented Test all example code in the docs

• Implemented Use intersphinx for doc references

• Implemented Support Django 5.2

• Implemented Upgrade to enum-properties >=2.2

• Implemented Move form imports to locally scoped imports where needed in fields.py

• Implemented Reorganize documentation using diataxis

• Implemented Provide a MultipleEnumChoiceFilter

• Implemented Provide an EnumMultipleChoiceField

v2.1.0 (2025-02-24)

• Implemented Switch poetry -> uv

• Implemented Add macos runner to CI

• Implemented Add windows runner to CI

• Implemented Drop support for python 3.8

• Implemented Move to justfile dev interface.

• Implemented Modernize pyproject.toml

v2.0.2 (2024-09-25)

• Fixed Constraints fail when using a name argument

v2.0.1 (2024-09-16)

• Fixed Unexpected ValueError instead of ValidationError

v2.0.0 (2024-09-09)

• Completed Reorganize tests

• Completed Switch linting and formatting to ruff

• Implemented Install django-stubs when running static type checks.

• Fixed When a character enum field allows null and blank=True, form fields and drf fields allow ‘’ to pass through causing errors.

• Implemented Supply a mixin for DRF ModelSerializers that instantiates the provided DRF EnumField type for model EnumFields.

• Implemented EnumField’s should inherit from common base titled EnumField

• Implemented Add database constraints on enum fields by default.

• Fixed to_python() raises ValueError instead of spec’ed ValidationError

• Implemented Add support for date, datetime, timedelta, time and Decimal enumeration types.

• Fixed None should be an allowable enumeration value in enums of any primitive type.

• Implemented Characterize the performance trade offs of bitfields vs indexed and non-indexed boolean fields.

• Fixed When coerce is false, to_python does not convert to the Enum’s primitive type

• Implemented Provide parameter to override integer range on EnumField.

• Implemented Add all official supported Django RDBMS backends to CI

• Implemented Support for integer sizes greater than 64 bit

• Implemented Provide an optional enum path converter.

• Implemented Support flag enumerations

Migration from 1.x -> 2.x

• Imports of Enum Properties extended TextChoices and IntegerChoices have been changed:

  # 1.x way
  from django_enum import TextChoices, IntegerChoices
  
  # 2.x way
  from django_enum.choices import TextChoices, IntegerChoices
  

• Imports of EnumChoiceField for django forms has been changed:

  # 1.x way
  from django_enum import EnumChoiceField
  
  # 2.x way
  from django_enum.forms import EnumChoiceField
  

• Imports of EnumFilter and FilterSet has been changed:

  # 1.x way
  from django_enum import EnumFilter, FilterSet
  
  # 2.x way
  from django_enum.filters import EnumFilter, FilterSet
  

• Strict EnumField values are now constrained at the database level using CheckConstraints by default. To disable this behavior, set the constrained parameter to False.

v1.3.3 (2024-08-26)

• Implemented Support python 3.13

• Implemented Drop support for Python 3.7

v1.3.2 (2024-07-15)

• Fixed Support Django 5.1

v1.3.1 (2024-03-02)

• Fixed db_default produces expressions instead of primitives when given enum value instances.

v1.3.0 (2023-12-13)

• Implemented Support db_default

• Fixed When coerce=False, enum form fields and model fields should still coerce to the enum’s primitive type.

• Implemented Support Django 5.0

v1.2.2 (2023-10-02)

• Added Support python 3.12.

• Fixed EnumFields don’t display correctly in the Admin when set to read_only.

v1.2.1 (2023-04-08)

• Fixed Document that with version 1.4 of enum-properties label is no longer overridable for Choices

v1.2.0 (2023-04-02)

• Implemented Compat for enums not deriving from Django’s choices.

v1.1.2 (2023-02-15)

• Fixed LICENSE packaged into source dir.

v1.1.1 (2023-01-15)

• Fixed Broken on Django4.1/Python 3.11.

v1.1.0 (2022-08-13)

• Fixed django-filter intergration for non-strict values does not work.

• Implemented Set EnumChoiceField to the default form field type.

• Implemented Coerce default values to Enum types.

• Implemented Use custom descriptor to coerce fields to Enum type on assignment.

v1.0.1 (2022-08-11)

• Fix dependency issue - allow python 3.6

v1.0.0 (2022-08-11)

• Initial Re-Release (production/stable)

v0.1.0 (2010-09-18)

• Legacy django-enum library maintained by Jacob Smullyan. Source located here.