File tree 2 files changed +10
-2
lines changed
2 files changed +10
-2
lines changed Original file line number Diff line number Diff line change @@ -936,11 +936,17 @@ Glossary
936
936
modules, respectively.
937
937
938
938
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,
941
941
and specifically are not like a :term: `regular package ` because they
942
942
have no ``__init__.py `` file.
943
943
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
+
944
950
See also :term: `module `.
945
951
946
952
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