31

Are there any rules or guidelines concerning when to use relative imports in Python? I see them in use all the time, such as in the Flask web framework. When searching for this topic, I only see articles on how to use relative imports, but not why.

So is there some special benefit to using:

from . import x

rather than:

from package import x

Moreover, I noticed that a related SO post mentions that relative imports are discouraged. Yet people still continue to use them.

KJH
  • 2,032
  • 15
  • 20
trinth
  • 5,757
  • 8
  • 37
  • 43
  • Regarding the [referenced SO answer discouraging relative imports](https://stackoverflow.com/a/5811548/1918127), there's also a highly upvoted counterargument, "As of September 213 [sic], this answer is wrong because PEP8 has changed...". – mathandy Sep 21 '21 at 01:54

1 Answers1

28

Check out PEP 328's section on relative imports

The rationale seems to be as written:

Several use cases were presented, the most important of which is being able to rearrange the structure of large packages without having to edit sub-packages. In addition, a module inside a package can't easily import itself without relative imports.

Bartek
  • 14,683
  • 1
  • 56
  • 64