]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
gh-114071: [Enum] update docs and code for tuples/subclasses (GH-114871)
authorEthan Furman <ethan@stoneleaf.us>
Sun, 4 Feb 2024 15:22:55 +0000 (07:22 -0800)
committerGitHub <noreply@github.com>
Sun, 4 Feb 2024 15:22:55 +0000 (07:22 -0800)
commitff7588b729a2a414ea189a2012904da3fbd1401c
treecb5bcbe6dabb0c9458dc28491dd4172b65cf60e0
parentec69e1d0ddc9906e0fb755a5234aeabdc96450ab
gh-114071: [Enum] update docs and code for tuples/subclasses (GH-114871)

Update documentation with `__new__` and `__init__` entries.

Support use of `auto()` in tuple subclasses on member assignment lines.  Previously, auto() was only supported on the member definition line either solo or as part of a tuple:

    RED = auto()
    BLUE = auto(), 'azul'

However, since Python itself supports using tuple subclasses where tuples are expected, e.g.:

    from collections import namedtuple
    T = namedtuple('T', 'first second third')

    def test(one, two, three):
        print(one, two, three)

    test(*T(4, 5, 6))
    # 4 5 6

it made sense to also support tuple subclasses in enum definitions.
Doc/library/enum.rst
Lib/enum.py
Lib/test/test_enum.py
Misc/NEWS.d/next/Library/2024-02-01-10-19-11.gh-issue-114071.vkm2G_.rst [new file with mode: 0644]