https://github.com/python/cpython/commit/de1279a0169d98ff17ef83d6cc6bfb74c9cee91f
commit: de1279a0169d98ff17ef83d6cc6bfb74c9cee91f
branch: 3.12
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: methane <songofaca...@gmail.com>
date: 2025-02-15T15:11:38+09:00
summary:
Doc: update term "namespace package" (GH-129251)
(cherry picked from commit e65e9f90626a4c62da4d3500044f354b51e51dbb)
Co-authored-by: Inada Naoki <songofaca...@gmail.com>
files:
M Doc/glossary.rst
M Doc/reference/import.rst
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index be8201ef41941f..f57f00b0ae133c 100644
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -873,11 +873,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
diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index ac363e8cfa00dc..26a8b2d9c7187e 100644
--- a/Doc/reference/import.rst
+++ b/Doc/reference/import.rst
@@ -123,6 +123,8 @@ Importing ``parent.one`` will implicitly execute
``parent/__init__.py`` and
``parent/three/__init__.py`` respectively.
+.. _reference-namespace-package:
+
Namespace packages
------------------
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
