Skip to content

Commit 6dc1191

Browse files
Oberon00theacodes
authored andcommitted
Mention find_namespace_packages (#622)
packaging-namespace-packages.rst previously recommended listing all packages manually.
1 parent b1f291d commit 6dc1191

1 file changed

Lines changed: 4 additions & 3 deletions

File tree

source/guides/packaging-namespace-packages.rst

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,16 +101,17 @@ logic to fail and the other sub-packages will not be importable.
101101

102102
Because ``mynamespace`` doesn't contain an :file:`__init__.py`,
103103
:func:`setuptools.find_packages` won't find the sub-package. You must
104-
explicitly list all packages in your :file:`setup.py`. For example:
104+
use :func:`setuptools.find_namespace_packages` instead or explicitly
105+
list all packages in your :file:`setup.py`. For example:
105106

106107
.. code-block:: python
107108
108-
from setuptools import setup
109+
from setuptools import setup, find_namespace_packages
109110
110111
setup(
111112
name='mynamespace-subpackage-a',
112113
...
113-
packages=['mynamespace.subpackage_a']
114+
packages=find_namespace_packages(include=['mynamespace.*'])
114115
)
115116
116117
A complete working example of two native namespace packages can be found in

0 commit comments

Comments
 (0)