File tree 2 files changed +9
-2
lines changed
2 files changed +9
-2
lines changed Original file line number Diff line number Diff line change @@ -939,11 +939,16 @@ Glossary
939
939
modules, respectively.
940
940
941
941
namespace package
942
- A :pep: ` 420 ` : term: `package ` which serves only as a container for
943
- subpackages. Namespace packages may have no physical representation,
942
+ A :term: `package ` which serves only as a container for subpackages.
943
+ Namespace packages may have no physical representation,
944
944
and specifically are not like a :term: `regular package ` because they
945
945
have no ``__init__.py `` file.
946
946
947
+ Namespace packages allow several individually installable packages to have a common parent package.
948
+ Otherwise, it is recommended to use a :term: `regular package `.
949
+
950
+ For more information, see :pep: `420 ` and :ref: `reference-namespace-package `.
951
+
947
952
See also :term: `module `.
948
953
949
954
nested scope
Original file line number Diff line number Diff line change @@ -123,6 +123,8 @@ Importing ``parent.one`` will implicitly execute ``parent/__init__.py`` and
123
123
``parent/three/__init__.py `` respectively.
124
124
125
125
126
+ .. _reference-namespace-package :
127
+
126
128
Namespace packages
127
129
------------------
128
130
You can’t perform that action at this time.
0 commit comments