`enum.md`

659 строк · 37.8 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.5/library/enum.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 8.13. [`enum`](https://python-all.ru/3.5/library/enum.html#module-enum) – Поддержка перечислений89Новое в версии 3.4.1011**Исходный код:** [Lib/enum.py](https://python-all.ru/src/3.5/Lib/enum.py)1213---1415Перечисление – это набор символических имён (членов), привязанных к уникальным постоянным значениям. Внутри перечисления члены можно сравнивать по идентичности, а само перечисление можно перебирать.1617## 8.13.1. Содержание модуля1819Этот модуль определяет два класса перечислений, которые можно использовать для определения уникальных\\nнаборов имен и значений: [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) и [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum). Он также определяет\\nодин декоратор, [`unique()`](https://python-all.ru/3.5/library/enum.html#enum.unique).2021#### `class enum.Enum`2223Базовый класс для создания перечислимых констант. См. раздел [Функциональный API](https://python-all.ru/3.5/library/enum.html#functional-api) для альтернативного синтаксиса создания.2425#### `class enum.IntEnum`2627Базовый класс для создания перечислимых констант, которые также являются подклассами [`int`](https://python-all.ru/3.5/library/functions.html#int).2829#### `enum.unique()`3031Декоратор класса перечисления, который гарантирует, что каждому значению соответствует только одно имя.3233## 8.13.2. Создание Enum3435Перечисления создаются с использованием синтаксиса [`class`](https://python-all.ru/3.5/reference/compound_stmts.html#class), что делает их легко читаемыми и удобными для записи. Альтернативный метод создания описан в [Функциональный API](https://python-all.ru/3.5/library/enum.html#functional-api). Чтобы определить перечисление, создайте подкласс [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) следующим образом:3637```python38>>> from enum import Enum39>>> class Color(Enum):40...     red = 141...     green = 242...     blue = 343...44```4546> **Примечание**47>48> Терминология49>50> - Класс `Color` является *перечислением* (или *enum*)51> - Атрибуты `Color.red`, `Color.green` и т.д. являются\\n*членами перечисления* (или *членами enum*).52> - Члены перечисления имеют *имена* и *значения* (имя `Color.red` – `red`, значение `Color.blue` – `3` и т.д.)5354> **Примечание**55>56> Хотя для создания перечислений мы используем синтаксис [`class`](https://python-all.ru/3.5/reference/compound_stmts.html#class), перечисления не являются обычными классами Python. Подробнее см. [Чем отличаются перечисления?](https://python-all.ru/3.5/library/enum.html#how-are-enums-different).5758Члены перечисления имеют удобочитаемые строковые представления:5960```python61>>> print(Color.red)62Color.red63```6465…в то время как их `repr` содержит больше информации:6667```python68>>> print(repr(Color.red))69<Color.red: 1>70```7172*Тип* члена перечисления – это перечисление, к которому он принадлежит:7374```python75>>> type(Color.red)76<enum 'Color'>77>>> isinstance(Color.green, Color)78True79>>>80```8182Члены перечисления также имеют свойство, содержащее только их имя:8384```python85>>> print(Color.red.name)86red87```8889Перечисления поддерживают итерацию в порядке определения:9091```python92>>> class Shake(Enum):93...     vanilla = 794...     chocolate = 495...     cookies = 996...     mint = 397...98>>> for shake in Shake:99...     print(shake)100...101Shake.vanilla102Shake.chocolate103Shake.cookies104Shake.mint105```106107Члены перечисления хешируемы, поэтому их можно использовать в словарях и множествах:108109```python110>>> apples = {}111>>> apples[Color.red] = 'red delicious'112>>> apples[Color.green] = 'granny smith'113>>> apples == {Color.red: 'red delicious', Color.green: 'granny smith'}114True115```116117## 8.13.3. Программный доступ к членам перечисления и их атрибутам118119Иногда бывает полезно обращаться к членам перечисления программно (например, в ситуациях, когда `Color.red` не подходит, поскольку точный цвет неизвестен на момент написания программы). `Enum` предоставляет такой доступ:120121```python122>>> Color(1)123<Color.red: 1>124>>> Color(3)125<Color.blue: 3>126```127128Если требуется обратиться к членам перечисления по *имени*, используйте доступ по ключу:129130```python131>>> Color['red']132<Color.red: 1>133>>> Color['green']134<Color.green: 2>135```136137Если есть член перечисления и требуется его `name` или `value`:138139```python140>>> member = Color.red141>>> member.name142'red'143>>> member.value1441145```146147## 8.13.4. Дублирование членов enum и значений148149Наличие двух членов перечисления с одинаковым именем недопустимо:150151```python152>>> class Shape(Enum):153...     square = 2154...     square = 3155...156Traceback (most recent call last):157...158TypeError: Attempted to reuse key: 'square'159```160161Однако двум членам перечисления разрешено иметь одинаковое значение. Если два члена A и B имеют одинаковое значение (и A определён первым), то B является псевдонимом A. Поиск по значению A и B вернёт A. Поиск по имени B также вернёт A:162163```python164>>> class Shape(Enum):165...     square = 2166...     diamond = 1167...     circle = 3168...     alias_for_square = 2169...170>>> Shape.square171<Shape.square: 2>172>>> Shape.alias_for_square173<Shape.square: 2>174>>> Shape(2)175<Shape.square: 2>176```177178> **Примечание**179>180> Попытка создать член с тем же именем, что и уже определённый атрибут (другой член, метод и т.д.), или попытка создать атрибут с тем же именем, что и член, не допускается.181182## 8.13.5. Обеспечение уникальности значений перечисления183184По умолчанию перечисления допускают несколько имён в качестве псевдонимов для одного и того же значения. Если такое поведение нежелательно, можно использовать следующий декоратор, чтобы гарантировать, что каждое значение используется в перечислении только один раз:185186#### `@enum.unique`187188Декоратор [`class`](https://python-all.ru/3.5/reference/compound_stmts.html#class), предназначенный специально для перечислений. Он просматривает `__members__` перечисления, собирая все найденные псевдонимы; если таковые обнаружены, возбуждается [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError) с подробностями.189190```python191>>> from enum import Enum, unique192>>> @unique193... class Mistake(Enum):194...     one = 1195...     two = 2196...     three = 3197...     four = 3198...199Traceback (most recent call last):200...201ValueError: duplicate values found in <enum 'Mistake'>: four -> three202```203204## 8.13.6. Итерация205206Перебор членов перечисления не включает псевдонимы:207208```python209>>> list(Shape)210[<Shape.square: 2>, <Shape.diamond: 1>, <Shape.circle: 3>]211```212213Специальный атрибут `__members__` – это упорядоченный словарь, сопоставляющий имена с элементами. Он включает все имена, определённые в перечислении, включая псевдонимы:214215```python216>>> for name, member in Shape.__members__.items():217...     name, member218...219('square', <Shape.square: 2>)220('diamond', <Shape.diamond: 1>)221('circle', <Shape.circle: 3>)222('alias_for_square', <Shape.square: 2>)223```224225Атрибут `__members__` можно использовать для детального программного доступа к членам перечисления. Например, для поиска всех псевдонимов:226227```python228>>> [name for name, member in Shape.__members__.items() if member.name != name]229['alias_for_square']230```231232## 8.13.7. Сравнения233234Члены перечисления сравниваются по идентичности:235236```python237>>> Color.red is Color.red238True239>>> Color.red is Color.blue240False241>>> Color.red is not Color.blue242True243```244245Упорядоченные сравнения между значениями перечисления *не* поддерживаются. Члены перечисления – не целые числа (но см. [IntEnum](https://python-all.ru/3.5/library/enum.html#intenum) ниже):246247```python248>>> Color.red < Color.blue249Traceback (most recent call last):250  File "<stdin>", line 1, in <module>251TypeError: unorderable types: Color() < Color()252```253254Однако сравнения на равенство определены:255256```python257>>> Color.blue == Color.red258False259>>> Color.blue != Color.red260True261>>> Color.blue == Color.blue262True263```264265Сравнения со значениями, не являющимися перечислениями, всегда дают результат «не равно» (опять же, [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) был явно спроектирован для другого поведения, см. ниже):266267```python268>>> Color.blue == 2269False270```271272## 8.13.8. Допустимые члены и атрибуты перечислений273274В примерах выше для значений перечислений используются целые числа. Использование целых чисел – это кратко и удобно (и предусмотрено по умолчанию [функциональным API](https://python-all.ru/3.5/library/enum.html#functional-api)), но не является строгим требованием. В подавляющем большинстве случаев не важно, каково фактическое значение элемента перечисления. Но если значение *является* важным, перечисления могут иметь произвольные значения.275276Перечисления – это классы Python и могут иметь обычные методы и специальные методы. Если есть такое перечисление:277278```python279>>> class Mood(Enum):280...     funky = 1281...     happy = 3282...283...     def describe(self):284...         # self – это член перечисления285...         return self.name, self.value286...287...     def __str__(self):288...         return 'my custom str! {0}'.format(self.value)289...290...     @classmethod291...     def favorite_mood(cls):292...         # cls здесь – это перечисление293...         return cls.happy294...295```296297Тогда:298299```python300>>> Mood.favorite_mood()301<Mood.happy: 3>302>>> Mood.happy.describe()303('happy', 3)304>>> str(Mood.funky)305'my custom str! 1'306```307308Правила допустимости следующие: имена, начинающиеся и заканчивающиеся одним подчеркиванием, зарезервированы для перечисления и не могут использоваться; все остальные атрибуты, определенные в перечислении, становятся его членами, за исключением специальных методов ([`__str__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__str__), [`__add__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__add__) и т. д.) и дескрипторов (методы также являются дескрипторами).309310Примечание: если в перечислении определены [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__) и/или [`__init__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__init__), то все значения, переданные элементу перечисления, будут переданы в эти методы. В качестве примера см. [Planet](https://python-all.ru/3.5/library/enum.html#planet).311312## 8.13.9. Ограниченное наследование перечислений313314Создание подкласса перечисления разрешено только в том случае, если перечисление не определяет никаких членов. Так делать запрещено:315316```python317>>> class MoreColor(Color):318...     pink = 17319...320Traceback (most recent call last):321...322TypeError: Cannot extend enumerations323```324325Но это разрешено:326327```python328>>> class Foo(Enum):329...     def some_behavior(self):330...         pass331...332>>> class Bar(Foo):333...     happy = 1334...     sad = 2335...336```337338Разрешение создания подклассов перечислений, определяющих члены, привело бы к нарушению некоторых важных инвариантов типов и экземпляров. С другой стороны, имеет смысл разрешить общее поведение для группы перечислений. (Пример см. в [OrderedEnum](https://python-all.ru/3.5/library/enum.html#orderedenum).)339340## 8.13.10. Сериализация341342Перечисления могут быть упакованы и распакованы с помощью модуля pickle.343344```python345>>> from test.test_enum import Fruit346>>> from pickle import dumps, loads347>>> Fruit.tomato is loads(dumps(Fruit.tomato))348True349```350351Обычные ограничения для упаковки с помощью модуля pickle применяются: перечисления, которые можно упаковать, должны быть определены на верхнем уровне модуля, так как для распаковки их нужно импортировать из этого модуля.352353> **Примечание**354>355> С протоколом pickle версии 4 можно легко упаковывать перечисления, вложенные в другие классы.356357Можно изменить способ сериализации/десериализации членов Enum, определив [`__reduce_ex__()`](https://python-all.ru/3.5/library/pickle.html#object.__reduce_ex__) в классе перечисления.358359## 8.13.11. Функциональный API360361Класс [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) является вызываемым и предоставляет следующее функциональное API:362363```python364>>> Animal = Enum('Animal', 'ant bee cat dog')365>>> Animal366<enum 'Animal'>367>>> Animal.ant368<Animal.ant: 1>369>>> Animal.ant.value3701371>>> list(Animal)372[<Animal.ant: 1>, <Animal.bee: 2>, <Animal.cat: 3>, <Animal.dog: 4>]373```374375Семантика этого API напоминает [`namedtuple`](https://python-all.ru/3.5/library/collections.html#collections.namedtuple). Первый аргумент вызова [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) – это имя перечисления.376377Второй аргумент – это *источник* имён членов перечисления. Это может быть строка имён, разделённых пробелами, последовательность имён, последовательность двухэлементных кортежей с парами ключ/значение или отображение (например, словарь) имён на значения. Последние два варианта позволяют присваивать произвольные значения перечислениям; остальные автоматически присваивают увеличивающиеся целые числа, начиная с 1 (используйте параметр `start` для указания другого начального значения). Возвращается новый класс, производный от [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum). Другими словами, приведённое выше присваивание `Animal` эквивалентно:378379```python380>>> class Animal(Enum):381...     ant = 1382...     bee = 2383...     cat = 3384...     dog = 4385...386```387388Причина, по которой по умолчанию используется `1`, а не `0`, заключается в том, что `0` равно `False` с точки зрения булевой логики, но все члены перечисления вычисляются в `True`.389390Сериализация перечислений, созданных с помощью функционального API, может быть сложной, поскольку для определения модуля, в котором создаётся перечисление, используются детали реализации стека вызовов (например, это не сработает, если использовать вспомогательную функцию в отдельном модуле, а также может не работать в IronPython или Jython). Решение – явно указать имя модуля следующим образом:391392```python393>>> Animal = Enum('Animal', 'ant bee cat dog', module=__name__)394```395396> **Предупреждение**397>398> Если `module` не указан, и Enum не может его определить, новые члены Enum не будут поддерживать распаковку; чтобы ошибки были ближе к источнику, pickling будет отключён.399400Новый протокол pickle 4 также в некоторых обстоятельствах полагается на то, что [`__qualname__`](https://python-all.ru/3.5/library/stdtypes.html#definition.__qualname__) установлен в расположение, где pickle сможет найти класс. Например, если класс стал доступен в классе SomeData в глобальной области видимости:401402```python403>>> Animal = Enum('Animal', 'ant bee cat dog', qualname='SomeData.Animal')404```405406Полная сигнатура:407408```python409Enum(value='NewEnumName', names=<...>, *, module='...', qualname='...', type=<mixed-in class>, start=1)410```411412| value: | Что новый класс Enum запишет в качестве своего имени. |413| --- | --- |414| names: | Члены перечисления. Это может быть строка, разделённая пробелами или запятыми (значения будут начинаться с 1, если не указано иное): 'red green blue' \| 'red,green,blue' \| 'red, green, blue' или итератор имён: \['red', 'green', 'blue'\] или итератор пар (имя, значение): \[('cyan', 4), ('magenta', 5), ('yellow', 6)\] или отображение: {'chartreuse': 7, 'sea\_green': 11, 'rosemary': 42} |415| module: | имя модуля, в котором находится новый класс Enum. |416| qualname: | где в модуле находится новый класс Enum. |417| type: | тип, который следует примешать к новому классу Enum. |418| start: | число, с которого начинать отсчёт, если переданы только имена. |419420Изменено в версии 3.5: Добавлен параметр *start*.421422## 8.13.12. Производные перечисления423424### 8.13.12.1. IntEnum425426Предоставляется вариант [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum), который также является подклассом\\n[`int`](https://python-all.ru/3.5/library/functions.html#int). Члены [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) можно сравнивать с целыми числами;\\nпо аналогии, целочисленные перечисления разных типов также можно сравнивать\\nдруг с другом:427428```python429>>> from enum import IntEnum430>>> class Shape(IntEnum):431...     circle = 1432...     square = 2433...434>>> class Request(IntEnum):435...     post = 1436...     get = 2437...438>>> Shape == 1439False440>>> Shape.circle == 1441True442>>> Shape.circle == Request.post443True444```445446Однако их по-прежнему нельзя сравнивать со стандартными перечислениями [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum):447448```python449>>> class Shape(IntEnum):450...     circle = 1451...     square = 2452...453>>> class Color(Enum):454...     red = 1455...     green = 2456...457>>> Shape.circle == Color.red458False459```460461Значения [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) ведут себя как целые числа и в других ожидаемых аспектах:462463```python464>>> int(Shape.circle)4651466>>> ['a', 'b', 'c'][Shape.circle]467'b'468>>> [i for i in range(Shape.square)]469[0, 1]470```471472Для подавляющего большинства кода настоятельно рекомендуется [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum),\\nпоскольку [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) нарушает некоторые семантические обещания перечисления (из-за\\nвозможности сравнения с целыми числами и, соответственно, транзитивного сравнения с другими\\nне связанными перечислениями). Его следует использовать только в особых случаях, когда\\nнет другого выбора; например, когда целочисленные константы\\nзаменяются перечислениями и требуется обратная совместимость с кодом,\\nкоторый всё ещё ожидает целые числа.473474### 8.13.12.2. Другие475476Хотя [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) является частью модуля [`enum`](https://python-all.ru/3.5/library/enum.html#module-enum), его очень просто реализовать самостоятельно:477478```python479class IntEnum(int, Enum):480    pass481```482483Это показывает, как можно определить подобные производные перечисления; например, `StrEnum`, в который примешивается [`str`](https://python-all.ru/3.5/library/stdtypes.html#str) вместо [`int`](https://python-all.ru/3.5/library/functions.html#int).484485Некоторые правила:4864871. При создании подкласса [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) типы-примеси должны располагаться перед самим [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) в последовательности базовых классов, как в [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) примере выше.4882. Хотя [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) может содержать элементы любого типа, как только к нему примешивается дополнительный тип, все элементы должны иметь значения этого типа, например [`int`](https://python-all.ru/3.5/library/functions.html#int) выше. Это ограничение не распространяется на примеси, которые только добавляют методы и не указывают другой тип данных, такие как [`int`](https://python-all.ru/3.5/library/functions.html#int) или [`str`](https://python-all.ru/3.5/library/stdtypes.html#str).4893. При примешивании другого типа данных атрибут `value` *отличается* от самого члена перечисления, хотя он эквивалентен и будет равным при сравнении.4904. Форматирование в стиле %: *%s* и *%r* вызывают методы [`__str__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__str__) и [`__repr__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__repr__) класса [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) соответственно; другие коды (например, *%i* или *%h* для IntEnum) обрабатывают член перечисления как его примешанный тип.4915. [`str.format()`](https://python-all.ru/3.5/library/stdtypes.html#str.format) (или [`format()`](https://python-all.ru/3.5/library/functions.html#format)) будет использовать [`__format__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__format__)\\nпримешанного типа. Если требуется [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) класса [`str()`](https://python-all.ru/3.5/library/stdtypes.html#str) или [`repr()`](https://python-all.ru/3.5/library/functions.html#repr), используйте коды форматирования *!s* или *!r*.492493## 8.13.13. Интересные примеры494495Хотя ожидается, что [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) и [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) покрывают большинство\\nвариантов использования, они не могут покрыть их все. Здесь приведены рецепты для некоторых различных\\nтипов перечислений, которые можно использовать напрямую или как примеры для создания\\nсобственных.496497### 8.13.13.1. AutoNumber498499Позволяет избежать необходимости указывать значение для каждого члена перечисления:500501```python502>>> class AutoNumber(Enum):503...     def __new__(cls):504...         value = len(cls.__members__) + 1505...         obj = object.__new__(cls)506...         obj._value_ = value507...         return obj508...509>>> class Color(AutoNumber):510...     red = ()511...     green = ()512...     blue = ()513...514>>> Color.green.value == 2515True516```517518> **Примечание**519>520> Метод [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__), если он определён, используется во время создания членов Enum; затем он заменяется методом [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__) класса Enum, который используется после создания класса для поиска существующих членов.521522### 8.13.13.2. OrderedEnum523524Упорядоченное перечисление, которое не основано на [`IntEnum`](https://python-all.ru/3.5/library/enum.html#enum.IntEnum) и поэтому сохраняет обычные инварианты [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) (например, несравнимость с другими перечислениями):525526```python527>>> class OrderedEnum(Enum):528...     def __ge__(self, other):529...         if self.__class__ is other.__class__:530...             return self.value >= other.value531...         return NotImplemented532...     def __gt__(self, other):533...         if self.__class__ is other.__class__:534...             return self.value > other.value535...         return NotImplemented536...     def __le__(self, other):537...         if self.__class__ is other.__class__:538...             return self.value <= other.value539...         return NotImplemented540...     def __lt__(self, other):541...         if self.__class__ is other.__class__:542...             return self.value < other.value543...         return NotImplemented544...545>>> class Grade(OrderedEnum):546...     A = 5547...     B = 4548...     C = 3549...     D = 2550...     F = 1551...552>>> Grade.C < Grade.A553True554```555556### 8.13.13.3. DuplicateFreeEnum557558Вызывает ошибку, если обнаружено дублирующееся имя члена, вместо создания псевдонима:559560```python561>>> class DuplicateFreeEnum(Enum):562...     def __init__(self, *args):563...         cls = self.__class__564...         if any(self.value == e.value for e in cls):565...             a = self.name566...             e = cls(self.value).name567...             raise ValueError(568...                 "aliases not allowed in DuplicateFreeEnum:  %r --> %r"569...                 % (a, e))570...571>>> class Color(DuplicateFreeEnum):572...     red = 1573...     green = 2574...     blue = 3575...     grene = 2576...577Traceback (most recent call last):578...579ValueError: aliases not allowed in DuplicateFreeEnum:  'grene' --> 'green'580```581582> **Примечание**583>584> Это полезный пример подкласса Enum для добавления или изменения другого поведения, а также запрета псевдонимов. Если требуется только запрет псевдонимов, вместо этого можно использовать декоратор [`unique()`](https://python-all.ru/3.5/library/enum.html#enum.unique).585586### 8.13.13.4. Planet587588Если определены [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__) или [`__init__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__init__), значение члена перечисления будет передано этим методам:589590```python591>>> class Planet(Enum):592...     MERCURY = (3.303e+23, 2.4397e6)593...     VENUS   = (4.869e+24, 6.0518e6)594...     EARTH   = (5.976e+24, 6.37814e6)595...     MARS    = (6.421e+23, 3.3972e6)596...     JUPITER = (1.9e+27,   7.1492e7)597...     SATURN  = (5.688e+26, 6.0268e7)598...     URANUS  = (8.686e+25, 2.5559e7)599...     NEPTUNE = (1.024e+26, 2.4746e7)600...     def __init__(self, mass, radius):601...         self.mass = mass       # в килограммах602...         self.radius = radius   # в метрах603...     @property604...     def surface_gravity(self):605...         # гравитационная постоянная (м3 кг-1 с-2)606...         G = 6.67300E-11607...         return G * self.mass / (self.radius * self.radius)608...609>>> Planet.EARTH.value610(5.976e+24, 6378140.0)611>>> Planet.EARTH.surface_gravity6129.802652743337129613```614615## 8.13.14. Чем отличаются перечисления?616617Перечисления имеют собственный метакласс, который влияет на многие аспекты как производных классов Enum, так и их экземпляров (членов).618619### 8.13.14.1. Классы перечислений620621Мета-класс `EnumMeta` отвечает за предоставление [`__contains__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__contains__), [`__dir__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__dir__), [`__iter__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__iter__) и других методов, которые позволяют выполнять с классом [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) действия, которые на обычном классе не сработают, например *list(Color)* или *some\_var in Color*. `EnumMeta` отвечает за обеспечение того, чтобы различные другие методы итогового класса [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) были корректны (таких как [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__), [`__getnewargs__()`](https://python-all.ru/3.5/library/pickle.html#object.__getnewargs__), [`__str__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__str__) и [`__repr__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__repr__)).622623### 8.13.14.2. Члены перечисления (экземпляры)624625Самое интересное в членах Enum – это то, что они являются синглтонами. `EnumMeta` создаёт их все при создании самого класса [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum), а затем помещает на место настраиваемый [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__), чтобы гарантировать, что новые экземпляры никогда не будут созданы, возвращая только существующие экземпляры членов.626627### 8.13.14.3. Тонкости628629[`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) члены являются экземплярами класса [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum), и даже они доступны как *EnumClass.member*, и к ним не следует обращаться напрямую через член, так как такой поиск может завершиться неудачей или, что хуже, вернуть не тот [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) член, который требуется:630631```python632>>> class FieldTypes(Enum):633...     name = 0634...     value = 1635...     size = 2636...637>>> FieldTypes.value.size638<FieldTypes.size: 2>639>>> FieldTypes.size.value6402641```642643Изменено в версии 3.5.644645Атрибут `__members__` доступен только для класса.646647Если добавить подклассу [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) дополнительные методы, как в классе [Planet](https://python-all.ru/3.5/library/enum.html#planet) выше, эти методы будут видны в [`dir()`](https://python-all.ru/3.5/library/functions.html#dir) члена, но не класса:648649```python650>>> dir(Planet)651['EARTH', 'JUPITER', 'MARS', 'MERCURY', 'NEPTUNE', 'SATURN', 'URANUS', 'VENUS', '__class__', '__doc__', '__members__', '__module__']652>>> dir(Planet.EARTH)653['__class__', '__doc__', '__module__', 'name', 'surface_gravity', 'value']654```655656Метод [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__) будет использоваться только для создания [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) членов – после этого он заменяется. Любой пользовательский метод [`__new__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__new__) должен создать объект и установить атрибут `_value_` соответствующим образом.657658Если требуется изменить способ поиска членов [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum), следует либо написать вспомогательную функцию или создать [`classmethod()`](https://python-all.ru/3.5/library/functions.html#classmethod) для [`Enum`](https://python-all.ru/3.5/library/enum.html#enum.Enum) подкласса.659