파이썬에서 네임스페이스 패키지(namespace package)는 하나의 파이썬 코드를 여러 프로젝트에 걸쳐 나누어 배포할 수 있게 해주는 강력한 기능입니다. 관련된 라이브러리들을 별도의 다운로드 패키지로 나누어 배포하고 싶을 때 특히 유용합니다.
네임스페이스 패키지의 기본 구조
예를 들어, PYTHONPATH에 Package-1과 Package-2라는 두 개의 디렉터리가 있다고 가정해 보겠습니다.
Package-1/namespace/__init__.py Package-1/namespace/module1/__init__.py Package-2/namespace/__init__.py Package-2/namespace/module2/__init__.py
이렇게 구성하면 최종 사용자는 마치 하나의 패키지처럼 다음과 같이 임포트할 수 있습니다.
import namespace.module1 import namespace.module2
파이썬 3.3 이상: 암시적 네임스페이스 패키지
파이썬 3.3부터는 암시적 네임스페이스 패키지(implicit namespace packages)가 도입되어 설정이 매우 간단해졌습니다. 별도의 작업 없이 네임스페이스 패키지 디렉터리에 __init__.py 파일을 두지 않기만 하면 자동으로 동작합니다.
즉, namespace 폴더 안에 __init__.py를 만들 필요가 없으며, 인터프리터가 자동으로 해당 디렉터리들을 하나의 네임스페이스로 인식합니다.
구버전 파이썬: pkgutil 모듈 활용하기
파이썬 3.3 미만 버전에서는 표준 모듈인 pkgutil을 사용하여 특정 네임스페이스에 모듈을 '추가'할 수 있습니다. Package-1/namespace/__init__.py와 Package-2/namespace/__init__.py 두 파일 모두에 아래 두 줄을 추가하면 됩니다.
from pkgutil import extend_path __path__ = extend_path(__path__, __name__)
동작 원리
extend_path() 함수는 sys.path에 있는 디렉터리들 중에서 패키지 이름과 동일한 이름을 가진 하위 디렉터리를 모두 찾아 해당 패키지의 __path__에 추가해 줍니다.
이렇게 하면 두 패키지를 각각 독립적으로 배포하면서도, 사용자 입장에서는 하나의 통합된 네임스페이스 패키지처럼 사용할 수 있습니다. 이를 통해 대규모 프로젝트에서 코드를 모듈화하고 유지보수성을 크게 향상시킬 수 있습니다.