Skip to main content

A Django extension to make `choices` on ChoiceFields more Enum-like.

Project description

https://github.com/serioeseGmbH/serious-django-enums

serious-django-enums defines an Enum-like class, AutoEnum, that intends to bring together the pattern to define choice fields that Django uses, and intuitive usage of Enums like most people know them.

Consider the example where you’ve defined your choices on a ChoiceField, e.g.:

class SomeForm(forms.Form):
    ...
    STATE_CHOICES = (
        ("ACTIVE", "active"),
        ("ENDED", "ended"),
    )
    field = forms.ChoiceField(choices=STATE_CHOICES, default="ACTIVE")

What this package gives you is wrapping this in a class and having it accessible as class attributes:

class States(AutoEnum):
    choices = (
        ("ACTIVE", "active"),
        ("ENDED", "ended"),
    )

class SomeForm(forms.Form):
    field = forms.ChoiceField(choices=States.choices, default=States.ACTIVE)

which has the advantage of being import-able from different parts of your code and not directly tied to the form, and also gives you nice-looking property access instead of dictionary-like key access.

The definition is currently extremely basic, but has suited our needs well.

Quick start

  1. Install the package with pip:

    pip install serious-django-enums
    
  2. Import serious_django_enums.AutoEnum and subclass it, defining a choices property on the class.

  3. Use the auto-defined member properties of your AutoEnum-subclasses wherever you need them.

Project details


Release history Release notifications

This version

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for serious-django-enums, version 0.1
Filename, size & hash File type Python version Upload date
serious-django-enums-0.1.tar.gz (3.2 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page