Skip to content
Open
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
14 changes: 14 additions & 0 deletions source/glossary.rst
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,20 @@ Glossary
extensions.


Implicit Namespace Package
Native Namespace Package

"Native namespace packages" and "implicit namespace packages" are two names for
the same type of namespace package. It's defined in :pep:`420`, and is available
in Python 3.3 and later.

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.

Import Package

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

.. note::

:term:`Native namespace <Native Namespace Package>` and
:term:`implicit namespace <Implicit Namespace Package>` packages are two
names for the same thing. This guide uses these names interchangeably.

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

Expand Down