basicenum

简单的枚举。

basicenum.compat

从stdlib中重新实现（主要是API兼容性）的enum.Enum（以及相关代码）。

此模块的目标是在尽可能使用现代Python特性的同时，重新实现尽可能多的enum.Enum API。虽然这确实导致了一些API破坏（例如，type(enum.member) == type(enum)不再为真），但它主要围绕元类级别的细节。如果您依赖于enum.Enum的表面API，则此模块应该是兼容的。

API兼容性

使用枚举示例

class Colour(Enum):
    RED = auto()
    GREEN = auto()
    BLUE = auto()

与enum.Enum的兼容性是

类型检查

不幸的是，类型检查器硬编码了对enum.Enum的支持。这意味着它们不会识别basicenum.compat.Enum的成员作为Member的实例或匹配enum.Enum成员的API。

幸运的是，您可以欺骗类型检查器。您可以告诉它们在执行期间使用basicenum.compat的同时，将类型检查作为使用enum。

from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from enum import Enum, auto
else:
    from basicenum.compat import Enum, auto

基准测试

如果您安装了[benchmark]扩展，您可以使用richbench来查看enum和basicenum.compat之间的性能比较。

结果

在2015年早期发布的13英寸MacBook Pro（Retina）上

richbench --repeat 5 --times 5 --benchmark compat benchmarks/

模块内容

Enum

创建枚举的基类。

Member

所有枚举成员的实例所属的类。

auto()

自动、递增整数成员值的函数。

@unique

确保所有枚举成员都有唯一值。

如果值不是全部唯一的，将引发 ValueError。

create()

对 enum.Enum 的功能API的重新实现。

def create(
    enum_name, member_names, /, *, module=None, qualname=None, type=None, start=1
): ...