pythongh-83336: Add alias for consistency to utf-8-sig (python#136530)

StanFromIreland · web-flow · commit 30f849250b7b · 2025-09-24T10:38:57.000+02:00
Closes python#83336
diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
@@ -1339,7 +1339,7 @@ particular, the following variants typically exist:
 +-----------------+--------------------------------+--------------------------------+
 | utf_8           | U8, UTF, utf8, cp65001         | all languages                  |
 +-----------------+--------------------------------+--------------------------------+
-| utf_8_sig       |                                | all languages                  |
+| utf_8_sig       | utf8-sig                       | all languages                  |
 +-----------------+--------------------------------+--------------------------------+
 
 .. versionchanged:: 3.4
diff --git a/Lib/encodings/aliases.py b/Lib/encodings/aliases.py
@@ -17,7 +17,7 @@
 """
 aliases = {
 
-    # Please keep this list sorted alphabetically by value !
+    # Please keep this list sorted alphabetically by value!
 
     # ascii codec
     '646'                : 'ascii',
@@ -554,6 +554,9 @@
     'utf8_ucs4'          : 'utf_8',
     'cp65001'            : 'utf_8',
 
+    # utf_8_sig codec
+    'utf8_sig'           : 'utf_8_sig',
+
     # uu_codec codec
     'uu'                 : 'uu_codec',
 
diff --git a/Misc/NEWS.d/next/Library/2025-07-11-08-15-17.gh-issue-83336.ptpmq7.rst b/Misc/NEWS.d/next/Library/2025-07-11-08-15-17.gh-issue-83336.ptpmq7.rst
@@ -0,0 +1 @@
+``utf8_sig`` is now aliased to :mod:`encodings.utf_8_sig`

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+``utf8_sig`` is now aliased to :mod:`encodings.utf_8_sig`