docs: clarify plugins folder sys.modules registration behavior#63634
Merged
potiuk merged 3 commits intoapache:mainfrom Mar 16, 2026
Merged
docs: clarify plugins folder sys.modules registration behavior#63634potiuk merged 3 commits intoapache:mainfrom
potiuk merged 3 commits intoapache:mainfrom
Conversation
Author
|
The Static checks failure and the modification to output_pr_auto-triage.txt are unrelated to this documentation-only PR. They appeared after the merge commit from main. Could a maintainer please advise or re-run? |
potiuk
approved these changes
Mar 16, 2026
1 task
fat-catTW
pushed a commit
to fat-catTW/airflow
that referenced
this pull request
Mar 22, 2026
…apache#63634) Co-authored-by: Shashwati <shashwatibhattacaharya21.2@gmail.com> Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Modules Management documentation currently assumes that the dags, config, and plugins folders are equivalent and
all get added to the sys.path list. This is incorrect because the plugins folder also imports all .py files in this directory
and registers them in the sys.modules namespace under the filename without the directory structure. This means that if you
have a file named hdfs.py in the plugins/my_project directory, the file will end up as sys.modules["hdfs"], which can
cause name clashes with other packages, such as the PyPI hdfs package. For this-
Two warning sections have been added:
package name being unique.
This Fixes Modules Management docs do not mention plugins folder's sys.modules registration behavior #63548