gh-113208: Mention namespace packages don't require __init__.py #113209
Conversation
bedevere-app
bot
added
docs
Unique-Usman
changed the title
CAM-Gerlach
changed the title
|
@hugovk @CAM-Gerlach check this out. |
CAM-Gerlach
added
needs backport to 3.11
CAM-Gerlach
left a comment
CAM-Gerlach
left a comment
There was a problem hiding this comment.
Thanks, @Unique-Usman . I added one suggestion to fix a typo; apply it by clicking Commit Suggestion, or together with others by going to the Files changed tab, clicking Add suggestion to batch for each suggestion, and then Commit. Otherwise, LGTM as far as my input goes
Co-authored-by: C.A.M. Gerlach <[email protected]>
|
Thanks! |
|
Thanks @Unique-Usman for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.11, 3.12. |
|
GH-113276 is a backport of this pull request to the 3.12 branch. |
…pythonGH-113209) (cherry picked from commit d71fcde) Co-authored-by: Unique-Usman <[email protected]> Co-authored-by: C.A.M. Gerlach <[email protected]>
|
GH-113277 is a backport of this pull request to the 3.11 branch. |
…pythonGH-113209) (cherry picked from commit d71fcde) Co-authored-by: Unique-Usman <[email protected]> Co-authored-by: C.A.M. Gerlach <[email protected]>
GH-113209) (#113277) Co-authored-by: Unique-Usman <[email protected]> Co-authored-by: C.A.M. Gerlach <[email protected]>
GH-113209) (#113276) Co-authored-by: Unique-Usman <[email protected]> Co-authored-by: C.A.M. Gerlach <[email protected]>
…python#113209) Co-authored-by: C.A.M. Gerlach <[email protected]>
…python#113209) Co-authored-by: C.A.M. Gerlach <[email protected]>
…python#113209) Co-authored-by: C.A.M. Gerlach <[email protected]>
| 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 |
There was a problem hiding this comment.
So… this line is not true anymore 😢
There was a problem hiding this comment.
Hi @merwok, could you provide a reference to the updated way, I can open a pr for it.
There was a problem hiding this comment.
Well, now nothing presents a directory on sys.path to shadow a stdlib module name, even without __init__.py file
You could open an issue first, then we’ll see if someone creates a PR!
4 participants
__init__.py files are required to make Python treat directories containing the file as packages.might be confusing #113208📚 Documentation preview 📚: https://cpython-previews--113209.org.readthedocs.build/