Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions source/glossary.rst
Original file line number Diff line number Diff line change
Expand Up @@ -192,6 +192,9 @@ Glossary
A mechanism for splitting a single :term:`Import Package <Import Package>`
across one or more :term:`Distribution Packages <Distribution Package>`.

For guidance on creating namespace packages, see
:ref:`packaging-namespace-packages`.


Package Index

Expand Down
12 changes: 12 additions & 0 deletions source/guides/packaging-namespace-packages.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,18 @@ from which the latter is discouraged:
#. Use `legacy namespace packages`_. This comprises `pkgutil-style namespace packages`_
and `pkg_resources-style namespace packages`_.

.. note::

"Native namespace packages" and "implicit namespace packages" are two names for
the same type of namespace package. The term "native" derives from the built-in
feature of Python to create packages without installing an extra package, such as
setuptools, from outside the standard library. The term "implicit" derives from
the fact that you don't have to explicitly declare the namespace package in a
:file:`__init__.py` file.
This guide uses these names interchangeably.

.. _native-namespace-packages:

Native namespace packages
-------------------------

Expand Down
Loading