6.4.3. Packages in Multiple Directories

https://docs.python.org/3/tutorial/modules.html#packages-in-multiple-directories

패키지의 __path__를 조정해 여러 디렉터리에 걸친 모듈 검색을 확장할 수 있다.
기본적으로 pkg/__init__.py 실행 시 __path__에는 패키지 디렉터리 하나가 들어간다.

여기에 다른 디렉터리를 추가하면 서브모듈 탐색 경로가 늘어난다.

  # pkg/__init__.py
  from pathlib import Path
  here = Path(__file__).parent
  __path__.append(str(here / "plugins"))  # 추가 검색 경로

이후 import pkg.extra는 기본 위치나 pkg/plugins/ 둘 다에서 해석될 수 있다.
플러그인 폴더 등 의도적으로 검색 범위를 넓힐 때만 사용한다.

← python 3.14으로