|
| 1 | +import enum |
| 2 | + |
| 3 | +__all__ = ["Choices", "IntegerChoices", "TextChoices"] |
| 4 | + |
| 5 | + |
| 6 | +class ChoicesMeta(enum.EnumMeta): |
| 7 | + """A metaclass for creating a enum choices.""" |
| 8 | + |
| 9 | + def __new__(metacls, classname, bases, classdict, **kwds): |
| 10 | + labels = [] |
| 11 | + for key in classdict._member_names: |
| 12 | + value = classdict[key] |
| 13 | + if isinstance(value, (list, tuple)) and len(value) > 1 and isinstance(value[-1], str): |
| 14 | + *value, label = value |
| 15 | + value = tuple(value) |
| 16 | + else: |
| 17 | + label = key.replace("_", " ").title() |
| 18 | + labels.append(label) |
| 19 | + # Use dict.__setitem__() to suppress defenses against double |
| 20 | + # assignment in enum's classdict. |
| 21 | + dict.__setitem__(classdict, key, value) |
| 22 | + cls = super().__new__(metacls, classname, bases, classdict, **kwds) |
| 23 | + cls._value2label_map_ = dict(zip(cls._value2member_map_, labels)) |
| 24 | + # Add a label property to instances of enum which uses the enum member |
| 25 | + # that is passed in as "self" as the value to use when looking up the |
| 26 | + # label in the choices. |
| 27 | + cls.label = property(lambda self: cls._value2label_map_.get(self.value)) |
| 28 | + cls.do_not_call_in_templates = True |
| 29 | + return enum.unique(cls) |
| 30 | + |
| 31 | + def __contains__(cls, member): |
| 32 | + if not isinstance(member, enum.Enum): |
| 33 | + # Allow non-enums to match against member values. |
| 34 | + return any(x.value == member for x in cls) |
| 35 | + return super().__contains__(member) |
| 36 | + |
| 37 | + @property |
| 38 | + def names(cls): |
| 39 | + empty = ["__empty__"] if hasattr(cls, "__empty__") else [] |
| 40 | + return empty + [member.name for member in cls] |
| 41 | + |
| 42 | + @property |
| 43 | + def choices(cls): |
| 44 | + empty = [(None, cls.__empty__)] if hasattr(cls, "__empty__") else [] |
| 45 | + return empty + [(member.value, member.label) for member in cls] |
| 46 | + |
| 47 | + @property |
| 48 | + def labels(cls): |
| 49 | + return [label for _, label in cls.choices] |
| 50 | + |
| 51 | + @property |
| 52 | + def values(cls): |
| 53 | + return [value for value, _ in cls.choices] |
| 54 | + |
| 55 | + |
| 56 | +class Choices(enum.Enum, metaclass=ChoicesMeta): |
| 57 | + """Class for creating enumerated choices.""" |
| 58 | + |
| 59 | + def __str__(self): |
| 60 | + """ |
| 61 | + Use value when cast to str, so that Choices set as model instance |
| 62 | + attributes are rendered as expected in templates and similar contexts. |
| 63 | + """ |
| 64 | + return str(self.value) |
| 65 | + |
| 66 | + |
| 67 | +class IntegerChoices(enum.IntEnum, Choices): |
| 68 | + """Class for creating enumerated integer choices.""" |
| 69 | + |
| 70 | + pass |
| 71 | + |
| 72 | + |
| 73 | +class TextChoices(str, Choices): |
| 74 | + """Class for creating enumerated string choices.""" |
| 75 | + |
| 76 | + def _generate_next_value_(name, start, count, last_values): |
| 77 | + return name |
0 commit comments