[Python-checkins] bpo-40721: add note about enum member name case (GH-22231)
Ethan Furman
webhook-mailer at python.org
Tue Sep 15 10:05:16 EDT 2020
https://github.com/python/cpython/commit/542e1df2b018ee7068dba8076f2d6e84efd6e144
commit: 542e1df2b018ee7068dba8076f2d6e84efd6e144
branch: master
author: Ethan Furman <ethan at stoneleaf.us>
committer: GitHub <noreply at github.com>
date: 2020-09-14T13:32:44-07:00
summary:
bpo-40721: add note about enum member name case (GH-22231)
* UPPER_CASE preferred as enum members are constants
files:
M Doc/library/enum.rst
diff --git a/Doc/library/enum.rst b/Doc/library/enum.rst
index 00bfb260c0204..32e8bbf950927 100644
--- a/Doc/library/enum.rst
+++ b/Doc/library/enum.rst
@@ -19,6 +19,12 @@ An enumeration is a set of symbolic names (members) bound to unique,
constant values. Within an enumeration, the members can be compared
by identity, and the enumeration itself can be iterated over.
+.. note:: Case of Enum Members
+
+ Because Enums are used to represent constants we recommend using
+ UPPER_CASE names for enum members, and will be using that style
+ in our examples.
+
Module Contents
---------------
More information about the Python-checkins
mailing list