]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
bpo-38659: [Enum] add _simple_enum decorator (GH-25285)
authorEthan Furman <ethan@stoneleaf.us>
Tue, 20 Apr 2021 01:04:53 +0000 (18:04 -0700)
committerGitHub <noreply@github.com>
Tue, 20 Apr 2021 01:04:53 +0000 (18:04 -0700)
commitdbac8f40e81eb0a29dc833e6409a1abf47467da6
tree826e5461748bc12fe065fe5c5c1d0d5b6ef8a310
parent7a041162468b83f6cad667b78ed5c786286aed2b
bpo-38659: [Enum] add _simple_enum decorator (GH-25285)

add:

_simple_enum decorator to transform a normal class into an enum
_test_simple_enum function to compare
_old_convert_ to enable checking _convert_ generated enums
_simple_enum takes a normal class and converts it into an enum:

@simple_enum(Enum)
class Color:
    RED = 1
    GREEN = 2
    BLUE = 3

_old_convert_ works much like _convert_ does, using the original logic:

# in a test file
import socket, enum
CheckedAddressFamily = enum._old_convert_(
        enum.IntEnum, 'AddressFamily', 'socket',
        lambda C: C.isupper() and C.startswith('AF_'),
        source=_socket,
        )

test_simple_enum takes a traditional enum and a simple enum and
compares the two:

# in the REPL or the same module as Color
class CheckedColor(Enum):
    RED = 1
    GREEN = 2
    BLUE = 3

_test_simple_enum(CheckedColor, Color)

_test_simple_enum(CheckedAddressFamily, socket.AddressFamily)

Any important differences will raise a TypeError
20 files changed:
Doc/library/enum.rst
Lib/ast.py
Lib/enum.py
Lib/http/__init__.py
Lib/pstats.py
Lib/re.py
Lib/ssl.py
Lib/test/test_ast.py
Lib/test/test_enum.py
Lib/test/test_httplib.py
Lib/test/test_pstats.py
Lib/test/test_signal.py
Lib/test/test_socket.py
Lib/test/test_ssl.py
Lib/test/test_unicode.py
Lib/test/test_uuid.py
Lib/tkinter/__init__.py
Lib/tkinter/test/test_tkinter/test_misc.py
Lib/uuid.py
Misc/NEWS.d/next/Library/2021-04-08-11-47-31.bpo-38659.r_HFnU.rst [new file with mode: 0644]