]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
bpo-38659: [Enum] add _simple_enum decorator (GH-25497)
authorEthan Furman <ethan@stoneleaf.us>
Wed, 21 Apr 2021 17:20:44 +0000 (10:20 -0700)
committerGitHub <noreply@github.com>
Wed, 21 Apr 2021 17:20:44 +0000 (10:20 -0700)
commita02cb474f9c097c83cd444a47e9fb5f99b4aaf45
treec9ebd2e0b7762ad1ca1f986966cb2ca02ea7fa6d
parent56c95dfe271b1242bdc8163d4677e311552c00cb
bpo-38659: [Enum] add _simple_enum decorator (GH-25497)

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]