gh-74955: Document that __all__ must contain strings in normalization form NFKC (GH-144504)

This commit is contained in:
Serhiy Storchaka 2026-02-05 20:06:33 +02:00 committed by GitHub
parent 50e107f149
commit c81e1843d4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -831,7 +831,9 @@ where the :keyword:`import` statement occurs.
The *public names* defined by a module are determined by checking the module's
namespace for a variable named ``__all__``; if defined, it must be a sequence
of strings which are names defined or imported by that module. The names
of strings which are names defined or imported by that module.
Names containing non-ASCII characters must be in the `normalization form`_
NFKC; see :ref:`lexical-names-nonascii` for details. The names
given in ``__all__`` are all considered public and are required to exist. If
``__all__`` is not defined, the set of public names includes all names found
in the module's namespace which do not begin with an underscore character
@ -865,6 +867,8 @@ determine dynamically the modules to be loaded.
.. audit-event:: import module,filename,sys.path,sys.meta_path,sys.path_hooks import
.. _normalization form: https://www.unicode.org/reports/tr15/#Norm_Forms
.. _future:
Future statements