From: Ethan Furman <ethan@stoneleaf.us>
Date: Wed, 10 Dec 2025 19:46:10 +0000 (-0800)
Subject: gh-135559: [Enum] dir() on a Flag now shows aliases (GH-136527)
X-Git-Tag: v3.15.0a3~122
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=26757d135143b9e481bafd1d477634bf327910a7;p=thirdparty%2FPython%2Fcpython.git

gh-135559: [Enum] dir() on a Flag now shows aliases (GH-136527)
---

diff --git a/Lib/enum.py b/Lib/enum.py
index ad782b8c41e1..15dddf6de692 100644
--- a/Lib/enum.py
+++ b/Lib/enum.py
@@ -774,12 +774,16 @@ class EnumType(type):
         super().__delattr__(attr)
 
     def __dir__(cls):
+        if issubclass(cls, Flag):
+            members = list(cls._member_map_.keys())
+        else:
+            members = cls._member_names_
         interesting = set([
                 '__class__', '__contains__', '__doc__', '__getitem__',
                 '__iter__', '__len__', '__members__', '__module__',
                 '__name__', '__qualname__',
                 ]
-                + cls._member_names_
+                + members
                 )
         if cls._new_member_ is not object.__new__:
             interesting.add('__new__')
diff --git a/Lib/test/test_enum.py b/Lib/test/test_enum.py
index 66d78980c41c..779457119e8f 100644
--- a/Lib/test/test_enum.py
+++ b/Lib/test/test_enum.py
@@ -5529,12 +5529,16 @@ class TestEnumDict(unittest.TestCase):
 # helpers
 
 def enum_dir(cls):
+    if issubclass(cls, Flag):
+        members = list(cls._member_map_.keys())
+    else:
+        members = cls._member_names_
     interesting = set([
             '__class__', '__contains__', '__doc__', '__getitem__',
             '__iter__', '__len__', '__members__', '__module__',
             '__name__', '__qualname__',
             ]
-            + cls._member_names_
+            + members
             )
     if cls._new_member_ is not object.__new__:
         interesting.add('__new__')
diff --git a/Misc/NEWS.d/next/Library/2025-07-10-18-40-11.gh-issue-135559.BMDtYn.rst b/Misc/NEWS.d/next/Library/2025-07-10-18-40-11.gh-issue-135559.BMDtYn.rst
new file mode 100644
index 000000000000..2ab3d4d76f38
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2025-07-10-18-40-11.gh-issue-135559.BMDtYn.rst
@@ -0,0 +1,2 @@
+Flag: a ``dir()`` on a ``Flag`` enumeration now shows non-canonical members.
+(i.e. aliases).