File tree Expand file tree Collapse file tree 2 files changed +10
-2
lines changed
Expand file tree Collapse file tree 2 files changed +10
-2
lines changed Original file line number Diff line number Diff line change @@ -936,11 +936,17 @@ Glossary
936936 modules, respectively.
937937
938938 namespace package
939- A :pep: ` 420 ` : term: `package ` which serves only as a container for
940- subpackages. Namespace packages may have no physical representation,
939+ A :term: `package ` which serves only as a container for subpackages.
940+ Namespace packages may have no physical representation,
941941 and specifically are not like a :term: `regular package ` because they
942942 have no ``__init__.py `` file.
943943
944+ Namespace packages allow you to split single package across multiple directories or distributions.
945+ On the other hand, namespace packages have some drawbacks and pitfalls.
946+ Use :term: `regular package ` always when it fits your needs.
947+
948+ For more information, see :pep: `420 ` and :ref: `reference-namespace-package `.
949+
944950 See also :term: `module `.
945951
946952 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
123123``parent/three/__init__.py `` respectively.
124124
125125
126+ .. _reference-namespace-package :
127+
126128Namespace packages
127129------------------
128130
You can’t perform that action at this time.
0 commit comments