Repository navigation
REPL does not show completions for some members of the Enum module #139398
Description
Bug report
Bug description:
While working on improving the Enum documentation, I noticed that all Enum _sunder_ names are not shown in the completion suggestions. Some examples:
$ ./python
Python 3.15.0a0 (heads/main:e18dda96c9, Sep 28 2025, 18:14:51) [GCC 13.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
Ctrl click to launch VS Code Native REPL
>>> from enum import Enum
>>> Enum._
Enum._add_member_( Enum._convert_( Enum._find_data_repr_( Enum._find_new_(
Enum._check_for_existing_members_( Enum._create_( Enum._find_data_type_( Enum._get_mixins_(
>>> Enum._add_alias_
<function Enum._add_alias_ at 0x7d38f05fc1d0>I don't know if this also affects other modules... but I guess it would be great to have a test that checks the completion coverage of the REPL across the stdlib - or is there already a test like this?
Either way, I'm happy to help fix this issue and create a PR if one could guide me to the place where the REPL builds the "completion database" 🙂
CPython versions tested on:
CPython main branch
Operating systems tested on:
Linux
Activity
[-]REPL does not show completions for some functions of the Enum module[/-][+]REPL does not show completions for some members of the Enum module[/+]StanFromIreland commentedon Sep 28, 2025
cc @tomasr8
picnixz commentedon Sep 28, 2025
This could also be because
Enum.__dir__(it's a custom-made function) is missing some entries. I don't think it's a REPL-only issue actually.Update enum.py [enum] Make dir(Enum) include public _sunder_ helpers …
[enum] Make dir(Enum) include public _sunder_ helpers for REPL comple…
ttw225 commentedon Sep 30, 2025
Hi! I'm interested in working on this issue and would like to contribute to the discussion.
I noticed there was a previous PR attempt that was abandoned. I've done some investigation and found that the problem is indeed that several sunder names mentioned in the official documentation are missing from
dir()output, which affects REPL autocomplete.Missing sunder names in
dir()output_name__value___new___add_alias__add_value_alias__missing__generate_next_value_Proposed Solution
The fix would involve updating the
__dir__methods in theEnumclass:__dir__method: Add_name_,_value_,_add_alias_,_add_value_alias___dir__method: Add_missing_,_generate_next_value_Lib/test/test_enum.pyto assert these appear indir()without changing runtime behavior.Clarifications
_ignore_ / _order_because the docs say they are removed during class creation / no longer used, so they shouldn’t be discoverable at runtime.dir()output?_name_and_value_be included indir()in addition to the public.nameand.value?My understanding is that
.name/.valueare the public, user-facing attributes, while_name_/_value_are the internal backing attributes used by Enum. Including_name_/_value_would improve parity with the “supported sunder names” list and help REPL discoverability, but it also exposes more implementation details in autocomplete. Do we wantdir(member)to list both pairs, or keep only the public ones (.name/.value) and exclude the backing fields?I'd like to confirm these details before implementing to ensure I'm addressing the right scope. Happy to work on this if the approach looks good!
Reference: Python 3.13.7 enum documentation - Supported sunder names
CC: @ethanfurman , @picnixz
picnixz commentedon Oct 1, 2025
There is already an open PR. I do not think it is abandoned (?)
ttw225 commentedon Oct 1, 2025
My bad—poor wording on my side. Not calling it abandoned. I was referring to the latest comment on the PR
Happy to support either way.
gh-139398: [Enum] Add supported sunder names to `__dir__` for REPL co…