mirror of
https://github.com/python/cpython.git
synced 2026-02-17 12:51:12 +00:00
gh-74955: Document that __all__ must contain strings in normalization form NFKC (GH-144504)
This commit is contained in:
parent
50e107f149
commit
c81e1843d4
1 changed files with 5 additions and 1 deletions
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue