From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 14 Jun 2024 17:59:12 +0000 (+0200)
Subject: [3.12] gh-120361: Add `nonmember` test with enum flags inside to `test_enum` (GH... 
X-Git-Tag: v3.12.5~220
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d2105a1eab12bc9dbac543f08faf0d9505f4cc3d;p=thirdparty%2FPython%2Fcpython.git

[3.12] gh-120361: Add `nonmember` test with enum flags inside to `test_enum` (GH-120364) (#120512)

gh-120361: Add `nonmember` test with enum flags inside to `test_enum` (GH-120364)

* gh-120361: Add `nonmember` test with enum flags inside to `test_enum`
(cherry picked from commit 7fadfd82ebf6ea90b38cb3f2a046a51f8601a205)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
---

diff --git a/Doc/library/enum.rst b/Doc/library/enum.rst
index 10acff619f91..3d0747bf5c7f 100644
--- a/Doc/library/enum.rst
+++ b/Doc/library/enum.rst
@@ -517,7 +517,7 @@ Data Types
 
    ``Flag`` is the same as :class:`Enum`, but its members support the bitwise
    operators ``&`` (*AND*), ``|`` (*OR*), ``^`` (*XOR*), and ``~`` (*INVERT*);
-   the results of those operators are members of the enumeration.
+   the results of those operations are (aliases of) members of the enumeration.
 
    .. method:: __contains__(self, value)
 
diff --git a/Lib/test/test_enum.py b/Lib/test/test_enum.py
index ccba0f91c868..7e3952251c78 100644
--- a/Lib/test/test_enum.py
+++ b/Lib/test/test_enum.py
@@ -1455,6 +1455,27 @@ class TestSpecial(unittest.TestCase):
             spam = nonmember(SpamEnumIsInner)
         self.assertTrue(SpamEnum.spam is SpamEnumIsInner)
 
+    def test_using_members_as_nonmember(self):
+        class Example(Flag):
+            A = 1
+            B = 2
+            ALL = nonmember(A | B)
+
+        self.assertEqual(Example.A.value, 1)
+        self.assertEqual(Example.B.value, 2)
+        self.assertEqual(Example.ALL, 3)
+        self.assertIs(type(Example.ALL), int)
+
+        class Example(Flag):
+            A = auto()
+            B = auto()
+            ALL = nonmember(A | B)
+
+        self.assertEqual(Example.A.value, 1)
+        self.assertEqual(Example.B.value, 2)
+        self.assertEqual(Example.ALL, 3)
+        self.assertIs(type(Example.ALL), int)
+
     def test_nested_classes_in_enum_with_member(self):
         """Support locally-defined nested classes."""
         class Outer(Enum):