diff options
| author | Anderson Bravalheri <andersonbravalheri@gmail.com> | 2023-02-13 19:18:22 +0000 |
|---|---|---|
| committer | Anderson Bravalheri <andersonbravalheri@gmail.com> | 2023-02-13 19:18:44 +0000 |
| commit | 81e1137a7d158df0b81d1ae53f6e0b56118acfba (patch) | |
| tree | 927b1b64f8afa6a28087843846abb08b4efd4f6c | |
| parent | 7066963dc4d786f7ee8bfb09a20f78a143d1ad81 (diff) | |
| download | python-setuptools-git-81e1137a7d158df0b81d1ae53f6e0b56118acfba.tar.gz | |
Add information on why namespace_packages are deprecated
| -rw-r--r-- | docs/references/keywords.rst | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/references/keywords.rst b/docs/references/keywords.rst index ade147ad..6173e3c2 100644 --- a/docs/references/keywords.rst +++ b/docs/references/keywords.rst @@ -390,7 +390,10 @@ extensions). ``namespace_packages`` .. warning:: - ``namespace_packages`` is deprecated in favor of native/implicit + The ``namespace_packages`` implementation relies on ``pkg_resources``. + However, ``pkg_resources`` has some undesirable behaviours, and + Setuptools intends to obviate its usage in the future. Therefore, + ``namespace_packages`` was deprecated in favor of native/implicit namespaces (:pep:`420`). Check :doc:`the Python Packaging User Guide <PyPUG:guides/packaging-namespace-packages>` for more information. |