gh-140924: In locale module, add missing names to __all__ (GH-140925)

diff --git a/Lib/locale.py b/Lib/locale.py
index 4ff6f8c0f0a775413a6233418daca859a855572a..25efff5b8568543c9edab75c8ea99412b42e5601 100644 (file)
--- a/Lib/locale.py
+++ b/Lib/locale.py
@@ -17,17 +17,14 @@ import _collections_abc
 from builtins import str as _builtin_str
 import functools
 
-# Try importing the _locale module.
-#
-# If this fails, fall back on a basic 'C' locale emulation.
-
 # Yuck:  LC_MESSAGES is non-standard:  can't tell whether it exists before
 # trying the import.  So __all__ is also fiddled at the end of the file.
 __all__ = ["getlocale", "getdefaultlocale", "getpreferredencoding", "Error",
            "setlocale", "localeconv", "strcoll", "strxfrm",
            "str", "atof", "atoi", "format_string", "currency",
            "normalize", "LC_CTYPE", "LC_COLLATE", "LC_TIME", "LC_MONETARY",
-           "LC_NUMERIC", "LC_ALL", "CHAR_MAX", "getencoding"]
+           "LC_NUMERIC", "LC_ALL", "CHAR_MAX", "getencoding", "delocalize",
+           "localize"]
 
 def _strcoll(a,b):
     """ strcoll(string,string) -> int.
@@ -41,6 +38,9 @@ def _strxfrm(s):
     """
     return s
 
+# Try importing the _locale module.
+#
+# If this fails, fall back on a basic 'C' locale emulation.
 try:
 
     from _locale import *
@@ -91,6 +91,29 @@ except ImportError:
             raise Error('_locale emulation only supports "C" locale')
         return 'C'
 
+else:
+    _conditional_constants_names = ["ABDAY_1", "ABDAY_2", "ABDAY_3",
+                                    "ABDAY_4", "ABDAY_5", "ABDAY_6",
+                                    "ABDAY_7", "ABMON_1", "ABMON_10",
+                                    "ABMON_11", "ABMON_12", "ABMON_2",
+                                    "ABMON_3", "ABMON_4", "ABMON_5",
+                                    "ABMON_6", "ABMON_7", "ABMON_8",
+                                    "ABMON_9", "ALT_DIGITS", "CODESET",
+                                    "CRNCYSTR", "DAY_1", "DAY_2", "DAY_3",
+                                    "DAY_4", "DAY_5", "DAY_6",
+                                    "DAY_7", "D_FMT", "D_T_FMT",
+                                    "ERA", "ERA_D_FMT", "ERA_D_T_FMT",
+                                    "ERA_T_FMT", "MON_1", "MON_10",
+                                    "MON_11", "MON_12", "MON_2", "MON_3",
+                                    "MON_4", "MON_5", "MON_6", "MON_7",
+                                    "MON_8", "MON_9", "NOEXPR",
+                                    "RADIXCHAR", "THOUSEP", "T_FMT",
+                                    "T_FMT_AMPM", "YESEXPR", "AM_STR",
+                                    "PM_STR"]
+    # The constants defined in _locale are platform-dependent,
+    # so we only include those that are available on the current platform.
+    __all__.extend(vars().keys() & _conditional_constants_names)
+
 # These may or may not exist in _locale, so be sure to set them.
 if 'strxfrm' not in globals():
     strxfrm = _strxfrm

diff --git a/Lib/test/test_locale.py b/Lib/test/test_locale.py
index a06c600cf56689e5c21722e23268405eebbd623e..8057c35f540841b1e60435078ea736d8c5da8692 100644 (file)
--- a/Lib/test/test_locale.py
+++ b/Lib/test/test_locale.py
@@ -9,6 +9,15 @@ import os
 import sys
 import codecs
 
+
+class MiscTestCase(unittest.TestCase):
+    maxDiff = None
+    def test__all__(self):
+        extra = ["localeconv", "strcoll", "strxfrm", "getencoding",
+                 "Error"]
+        not_exported = ["locale_encoding_alias", "locale_alias", "windows_locale"]
+        support.check__all__(self, locale, extra=extra, not_exported=not_exported)
+
 class LazyImportTest(unittest.TestCase):
     @cpython_only
     def test_lazy_import(self):

diff --git a/Misc/NEWS.d/next/Library/2025-11-02-22-24-13.gh-issue-140924.NQVbR_.rst b/Misc/NEWS.d/next/Library/2025-11-02-22-24-13.gh-issue-140924.NQVbR_.rst
new file mode 100644 (file)
index 0000000..91c30c9
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2025-11-02-22-24-13.gh-issue-140924.NQVbR_.rst
@@ -0,0 +1,3 @@
+Add :func:`locale.localize`, :func:`locale.delocalize`
+and platform-specific locale constants
+from the :mod:`!_locale` module to ``locale.__all__``.