diff options
| author | Unique-Usman <86585626+Unique-Usman@users.noreply.github.com> | 2023-12-19 08:39:57 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-12-19 08:39:57 (GMT) |
| commit | d71fcdee0f1e4daa35d47bbef103f30259037ddb (patch) | |
| tree | bc454d6c0d7bcd3b476f2a400ade876d05ac8eb3 /Doc/tutorial | |
| parent | 4658464e9cf092be930d0d8f938e801a69f7f987 (diff) | |
| download | cpython-d71fcdee0f1e4daa35d47bbef103f30259037ddb.zip cpython-d71fcdee0f1e4daa35d47bbef103f30259037ddb.tar.gz cpython-d71fcdee0f1e4daa35d47bbef103f30259037ddb.tar.bz2 | |
gh-113208: Mention namespace packages don't require __init__.py (#113209)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Diffstat (limited to 'Doc/tutorial')
| -rw-r--r-- | Doc/tutorial/modules.rst | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst index bf9e8e0..0316239 100644 --- a/Doc/tutorial/modules.rst +++ b/Doc/tutorial/modules.rst @@ -437,7 +437,8 @@ When importing the package, Python searches through the directories on ``sys.path`` looking for the package subdirectory. The :file:`__init__.py` files are required to make Python treat directories -containing the file as packages. This prevents directories with a common name, +containing the file as packages (unless using a :term:`namespace package`, a +relatively advanced feature). This prevents directories with a common name, such as ``string``, from unintentionally hiding valid modules that occur later on the module search path. In the simplest case, :file:`__init__.py` can just be an empty file, but it can also execute initialization code for the package or |