From 0aaa9492b9a5ed98345565197db0d6b9b32f6538 Mon Sep 17 00:00:00 2001 From: Joshua Lucas Date: Wed, 14 Oct 2026 21:20:38 -0500 Subject: [PATCH] Create better_enum module with extended enums. --- src/AuDaGe/better_enum.py | 65 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 src/AuDaGe/better_enum.py diff --git a/src/AuDaGe/better_enum.py b/src/AuDaGe/better_enum.py new file mode 100644 index 0000000..5340a73 --- /dev/null +++ b/src/AuDaGe/better_enum.py @@ -0,0 +1,65 @@ +import enum + + +class BetterEnumType(enum.EnumType): + """Extensions for enum.EnumType.""" + + def contains(cls, name): + """Shorthand for `name in enum.__members__`.""" + return name in cls.__members__ + + def keys(cls): + """Shorthand for `enum.__members__.keys()`.""" + return cls.__members__.keys() + + def values(cls): + """Shorthand for `enum.__members__.values()`.""" + return cls.__members__.values() + + +class AliasEnumType(BetterEnumType): + """Override some of the EnumType methods so that they include aliases.""" + + def __contains__(cls, name): + """Check for existence of `name` in enum members including aliases.""" + return name in cls.__members__ + + def __getitem__(cls, name): + """Retrieve an enum member (including aliases) by name.""" + return cls.__members__[name] + + def __iter__(cls): + """Iterate through enum members including aliases.""" + return iter(cls.__members__) + + +class BetterEnum(enum.Enum, metaclass=BetterEnumType): + """Enum that uses BetterEnumType as its metaclass.""" + + +class BetterIntEnum(enum.IntEnum, metaclass=BetterEnumType): + """IntEnum that uses BetterEnumType as its metaclass.""" + + +class BetterIntFlag(enum.IntFlag, metaclass=BetterEnumType): + """IntFlag that uses BetterEnumType as its metaclass.""" + + +class BetterStrEnum(enum.StrEnum, metaclass=BetterEnumType): + """StrEnum that uses BetterEnumType as its metaclass.""" + + +class AliasEnum(enum.Enum, metaclass=AliasEnumType): + """Enum that uses AliasEnumType as its metaclass.""" + + +class AliasIntEnum(enum.IntEnum, metaclass=AliasEnumType): + """IntEnum that uses AliasEnumType as its metaclass.""" + + +class AliasIntFlag(enum.IntFlag, metaclass=AliasEnumType): + """IntFlag that uses AliasEnumType as its metaclass.""" + + +class AliasStrEnum(enum.StrEnum, metaclass=AliasEnumType): + """StrEnum that uses AliasEnumType as its metaclass."""