[PY] importlib.import_module 활용 가이드

 

 

목차

 

importlib.import_module 는 이름을 통해 동적으로 모듈을 가져올 수 있는 함수이다. 특정 디렉토리 내 파일을 모듈로 가져오고자 할 때 이 기능을 활용할 수 있다. 구성이 자주 변경되거나 사용자 입력에 따라 다른 모듈을 로드해야 하는 경우에 유용하게 사용된다.

 

1. 기본 접근법

만약 실행 중인 스크립트와 모듈이 같은 디렉토리에 위치하고 있다면, 단순히 모듈 이름을 사용하여 importlib.import_module 함수를 호출하면 된다.

import importlib

# 모듈 이름을 문자열로 지정
module = importlib.import_module('module_name')

# 모듈 내의 함수나 클래스 사용
module.some_function()

 

 

 

2. 디렉토리 내 파일 접근법

다음의 디렉토리 구조에서 mymodule.py를 가져와야 하는 상황이라고 가정한다.

project/
│
├── main.py
└── subdir/
    └── mymodule.py

 

2.1 경로 추가를 통한 접근 방법

• 경로 추가: subdir 를 Python의 모듈 검색 경로에 추가한다.
• 모듈 로딩: 이후 importlib.import_module을 사용해 mymodule을 불러올 수 있다.

import sys
import importlib

# Python의 모듈 검색 경로에 subdir를 추가
sys.path.append('/path/to/project/subdir')

# subdir 내의 mymodule 가져오기
mymodule = importlib.import_module('mymodule')

# mymodule 내의 함수 사용
mymodule.some_function()

 

2.2 직접 접근 방법

• 경로를 설정하지 않고 __init__.py 파일을 포함시킨 후 접근하는 방법도 있다.
• 이 구조는 하위 디렉토리를 패키지로 인식하여 모듈을 쉽게 불러올 수 있게 해준다.
• 위의 예시에서 subdir 디렉토리를 하나의 패키지로 처리하기 위해 subdir 내에 __init__.py 파일을 생성한다. 이 파일은 내용이 없어도 무방하다. __init__.py 파일의 존재는 해당 디렉토리가 패키지로 인식될 수 있게 한다.
• init 파일 생성 후, importlib.import_module 으로 패키지 내 모듈을 직접 불러올 수 있다.

import importlib

# 패키지 내 모듈 직접 가져오기
module = importlib.import_module('subdir.mymodule')

# 모듈 내의 함수나 클래스 사용
module.some_function()

 

 

 

 

3. 주의 사항

• 모듈 이름을 불러올 떈 .py 확장자를 적지 않는다.
• sys.path.append를 사용할 때는 절대 경로 또는 상대 경로를 정확히 지정해야 한다.
• 동적으로 모듈을 가져올 때는 해당 모듈의 종속성도 함께 고려되어야 한다.

 

 

4. 참고 사항

1. 성능 고려: 동적 모듈 로딩은 유용하지만, 불필요하게 반복적으로 사용될 경우 애플리케이션의 성능에 영향을 줄 수 있다. 필요한 경우에만 모듈을 동적으로 로드하고, 가능하면 모듈 로딩을 최소화하는 것이 좋다.
2. 보안 문제: 사용자 입력을 기반으로 모듈 이름을 동적으로 구성할 때는 주의가 필요하다. 예상치 못한 입력이 모듈 로딩 경로에 주입될 수 있으므로, 입력 값을 검증하거나 제한된 선택지에서만 선택하도록 하는 것이 안전하다.
3. 오류 처리: importlib.import_module은 지정된 모듈을 찾지 못할 때 ModuleNotFoundError를 발생시킨다. 모듈 로딩 과정에서 발생할 수 있는 다양한 예외를 적절히 처리하는 코드를 작성하는 것이 중요하다.
4. 환경 일관성: 다양한 환경(개발, 테스트, 프로덕션 등)에서 애플리케이션을 운영할 때 모든 환경에서 모듈 경로와 설정이 일관되게 유지되어야 한다. 이는 모듈이 예상대로 로드되고 실행되도록 보장한다.