django-enumfields

What it is and what it does

django-enumfields bridges Python's standard enum module (PEP 435) with Django's ORM by providing EnumField and EnumIntegerField model fields that store enum values in the database while preserving type safety in Python code. It includes a custom Enum class that auto-generates human-readable labels for use in admin dropdowns and forms, plus integration with Django's admin list filters and Django REST Framework serializers.

The package is straightforward to use: define a Python enum, attach it to a model field, and query using enum members directly rather than raw strings or integers. It handles form field generation and admin integration automatically. However, the project is no longer maintained—the last release was in February 2021 and the last repository commit in December 2022—so it may not work reliably with newer Django or Python versions.

Use it for

• Store categorical data (e.g., status, color, priority) in Django models with type-safe enum access instead of magic strings.
• Generate admin dropdown filters automatically from enum definitions without manual choice tuples.
• Serialize enum fields in Django REST Framework APIs while preserving enum semantics in the JSON output.
• Use enums in model queries and filters with IDE autocomplete and static type checking.
• Define custom labels for enum values in admin and form displays via a nested Labels class.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

django-enumfields on PyPI

Before you install

Low install friction with no runtime dependencies. However, the package is abandoned—last release was 2021-02-23 and last commit 2022-12-20, with no active maintenance. Use only if your Django and Python versions align with the supported range.

Requires Django 2.2, 3.0, or 3.1 and Python 3.5–3.9; compatibility with newer versions is unverified due to abandonment.

License in practice

MIT license is permissive and poses no restrictions on use, modification, or distribution in commercial or private projects.

Quickstart

pip install django-enumfields

from enumfields import EnumField
from enum import Enum

class Color(Enum):
    RED = 'r'
    GREEN = 'g'

class MyModel(models.Model):
    color = EnumField(Color, max_length=1)

m = MyModel.objects.filter(color=Color.RED)

Package facts

Evidence: django_enumfields-2.1.1-py3-none-any.whl

Tags

More WWW/HTTP packages

See also django-bitfield · django-colorfield · django-enum · django-extended-choices · django-choices-field · marshmallow-enum · matrix-enum · jsonfield · django-pydantic-field · django-private-storage