Skip to main content

A useful enumeration / choice library for Django.

Project description

Useful Enums - a library for creating Enums in a DRY way in Python

Build Status

This library grew out of me getting fed up with having to create Django choices that were lists of tuples. I far preferred nicely contained enums of the form:

class MyEnum:

    VALUE_1 = 1
    VALUE_2 = 2

However, most of the time you don't need to create all of the IDs yourself. You should just be able to define the key names and have the Enum class do the work for you. usefulenums does that.

The syntax is very similar to the Django idiom for creating a tuple of choices:

from usefulenums import Enum

MyEnum = Enum(
    ("MY_FIRST_VALUE", "My First Display Text"),
    ("MY_SECOND_VALUE", "My Second Value"),

However, you can now refer to those items by name in a more Pythonic fashion, rather than having to use hard-coded strings:


Note that here, Enum() has given automatic values to the enum items. You can set these values yourself by passing a three-tuple to Enum when you create it:

>>> MyEnum = Enum(
...     ("VALUE_1", "MY_FIRST_VALUE", "My First Value"),
...     ("VALUE_2", "MY_SECOND_VALUE", "My Second Value"),
... )
>>> print(MyEnum.MY_FIRST_VALUE)

You can also extract the Django-style choices from the Enum so that you use it as you've always used choices:

>>> MyEnum.as_choices()
(('VALUE_1', 'My First value'), ('VALUE_2', 'My Second Value'))


django-useful-enums comes with unit tests that cover its behaviour. You can run them using nose:

$ pip install nose
$ nosetests

Project details

Download files

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

Files for django-useful-enums, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size django_useful_enums-1.0.1-py3-none-any.whl (6.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-useful-enums-1.0.1.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page