Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-31 13:41:24 +00:00
Code Issues Projects Releases Packages Wiki Activity

Doc: update term "namespace package" (#129251)

Browse source
This commit is contained in:
Inada Naoki 2025-02-15 03:47:54 +09:00 • committed by GitHub
parent 1775091dc1
commit e65e9f9062
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 9 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/glossary.rst
View file

@ -939,11 +939,16 @@ Glossary
modules, respectively.
namespace package
A :pep:`420` :term:`package` which serves only as a container for
subpackages. Namespace packages may have no physical representation,
A :term:`package` which serves only as a container for subpackages.
Namespace packages may have no physical representation,
and specifically are not like a :term:`regular package` because they
have no ``__init__.py`` file.
Namespace packages allow several individually installable packages to have a common parent package.
Otherwise, it is recommended to use a :term:`regular package`.
For more information, see :pep:`420` and :ref:`reference-namespace-package`.
See also :term:`module`.
nested scope

2
Doc/reference/import.rst
View file

@ -123,6 +123,8 @@ Importing ``parent.one`` will implicitly execute ``parent/__init__.py`` and
``parent/three/__init__.py`` respectively.
.. _reference-namespace-package:
Namespace packages
------------------