Skip to content

gh-61310: Document package precedence over same-named modules#153211

Open
TheD0ubleC wants to merge 2 commits into
python:mainfrom
TheD0ubleC:gh-61310-document-package-module-precedence
Open

gh-61310: Document package precedence over same-named modules#153211
TheD0ubleC wants to merge 2 commits into
python:mainfrom
TheD0ubleC:gh-61310-document-package-module-precedence

Conversation

@TheD0ubleC

Copy link
Copy Markdown

Document that the default filesystem finder checks for regular packages before same-named modules within a single path entry.

This clarifies the behavior reported in gh-61310 while preserving the existing sys.path ordering semantics: a module found in an earlier path entry still takes precedence over a package found in a later one.

Validation:

  • Verified locally that import spam imports spam/__init__.py when both spam/__init__.py and spam.py exist in the same directory.
  • Verified locally that sys.path order still takes precedence across different path entries.
  • Ran git diff --check.

Docs build was not run because Sphinx is not installed in this environment.

@read-the-docs-community

read-the-docs-community Bot commented Jul 6, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33470062 | 📁 Comparing fd16e8a against main (2d7a74e)

  🔍 Preview build  

4 files changed
± library/email.utils.html
± library/os.html
± reference/import.html
± whatsnew/changelog.html

@TheD0ubleC TheD0ubleC marked this pull request as ready for review July 6, 2026 15:12
Comment thread Doc/reference/import.rst Outdated
Co-authored-by: Stan Ulbrych <stan@python.org>
@python-cla-bot

python-cla-bot Bot commented Jul 7, 2026

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

CLA signed

@TheD0ubleC

Copy link
Copy Markdown
Author

Thanks! I applied the suggested wording.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants