Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-06-27 19:36:07 +00:00
Code Issues Projects Releases Packages Wiki Activity

[3.13] gh-148672: Document namespace subpackages inside regular packages (GH-150056) (#150731)

Browse source 
gh-148672: Document namespace subpackages inside regular packages (GH-150056)
(cherry picked from commit 9ba2a89179)

Co-authored-by: Taeknology <20297177+Taeknology@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2026-06-01 21:29:31 +02:00 • committed by GitHub
parent ff9c8dea8f
commit 92a1c8bf14
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

12
Doc/reference/import.rst
View file

@ -122,6 +122,12 @@ Importing ``parent.one`` will implicitly execute ``parent/__init__.py`` and
``parent.three`` will execute ``parent/two/__init__.py`` and
``parent/three/__init__.py`` respectively.
A subdirectory inside a regular package that does not contain an
``__init__.py`` file is treated as an implicit
:ref:`namespace package <reference-namespace-package>` (a "namespace
subpackage") rooted in that parent. See :pep:`420` for the underlying
specification.
.. _reference-namespace-package:
@ -153,6 +159,12 @@ physically located next to ``parent/two``. In this case, Python will create a
namespace package for the top-level ``parent`` package whenever it or one of
its subpackages is imported.
Namespace packages may also be nested inside a regular package. When the
import system searches a regular package's ``__path__`` and encounters a
subdirectory that does not contain an ``__init__.py`` file, that
subdirectory becomes a :term:`portion` contributing to a namespace
subpackage of the enclosing regular package.
See also :pep:`420` for the namespace package specification.