Краткий обзор раздела: Модуль enum перечисления в Python

Перечисления Enum похожи на глобальные переменные, но предлагают более полезную функцию repr(), группировку, безопасность типов и некоторые другие функции. Они наиболее полезны, когда есть переменная, которая может принимать одно из ограниченного набора значений, например, дни недели.

Перечисления создаются с использованием синтаксиса класса, что упрощает их чтение и запись. Значения членов перечисления могут быть любыми: int, str и т. д.

Семантика функционального синтаксиса создания перечисления напоминает collections.namedtuple. Первый аргумент вызова Enum - это имя перечисления. Второй аргумент - это источник имен членов перечисления.

Бывает полезно получить доступ к элементам в перечислениях программно. Например, в ситуациях, когда вызов Color.RED не работает, потому что точный цвет неизвестен во время написания программы.

Попытка создать член с тем же именем, что и уже определенный атрибут (другой член, метод и т. д.), или попытка создать атрибут с тем же именем, что и член, недопустимы.

Декоратор классов @enum.unique разработан специально для перечислений модуля enum. Он ищет магический метод перечисления __members__, собирая все найденные псевдонимы и если они обнаружены, то поднимает исключение ValueError с выводом подробностей

Если точное значение в перечислении неважно, то можно использовать класс enum.auto модуля enumИспользование автоматических значений

Целочисленные перечисления enum.IntEnum. Класс enum.IntFlag. Класс enum.Flag. Пользовательские производные на основе класса enum.Enum

Итерация по членам перечисления не дает псевдонимов. Члены перечисления сравниваются по идентичности.

Имена, которые начинаются и заканчиваются одним подчеркиванием, зарезервированы модулем enum и не могут использоваться. Все другие атрибуты, определенные в перечислении, станут членами этого перечисления, за исключением специальных методов, дескрипторов и имен переменных, перечисленных в _ignore_

В Python 3.12 добавлена ​​поддержка классов данных. При наследовании от класса данных dataclass в __repr__() опускает имя унаследованного класса.

У перечислений модуля enum есть собственный метакласс, который влияет на многие аспекты как производных классов Enum, так и их экземпляров (членов).

рецепты для различных типов перечислений, которые можно использовать напрямую или в качестве примеров для создания собственных.

Часто встает задача: хранить информацию о перечислениях Python в поле базы данных для каждой строки. Чтобы уменьшить количество ошибок при обмене данными, между Python и БД, в PostgreSQL так же можно определить поле таблицы, как такое же перечисление, при помощи функции ENUM().

В материале рассмотрены тонкости реализации модуля enum в Python.

Класс enum.EnumCheck - это перечисление со значениями CONTINUOUS, NAMED_FLAGS и UNIQUE для использования с декоратором @enum.verify(), чтобы гарантировать, что данное перечисление соответствует различным ограничениям. (Добавлен в Python 3.11)

Класс enum.FlagBoundary позволяет более детально контролировать, как обрабатываются недопустимые значения в enum.Flag и его подклассах. (Добавлен в Python 3.11)