Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 

파이썬 - 소스 코드의 파일 경로를 지정한 모듈 로드

예를 들어, main.py 및 sub.py가 다음과 같이 있을 때,

$ pwd
/mnt/c/temp

$ cat main.py
print('main: loaded')

import sub
sub.sub_func()

$ cat sub.py
print('sub: loaded')

def sub_func():
    print('sub: sub_func called')

$ python main.py
main: loaded
sub: loaded
sub: sub_func called

다른 디렉터리에 있는 파이썬 소스 코드에서 저 sub.py를 실행하기 위해서는 SourceFileLoader 타입을 사용해 이렇게 작성할 수 있습니다.

$ pwd
/mnt/c/test

$ cat call_main.py
import os

print('call_main:', os.getcwd())

module_path = '/mnt/c/temp'
module_name = 'sub'

module_path = module_path + os.sep + module_name + '.py'

from importlib.machinery import SourceFileLoader
module = SourceFileLoader(module_name, module_path).load_module()  # sub.py 모듈 로드
print('call_main:', module.__name__)

module.__dict__['sub_func']()  # sub.py에 정의된 sub_func 함수 호출

$ python call_main.py
call_main: /mnt/c/test
sub: loaded
call_main: sub
sub: sub_func called

보통 다른 언어를 사용하던 개발자들, 특히 C# 개발자들이라면 SourceFileLoader.load_module() 메서드를 단순히 DLL 로드와 유사하다고 오해할 수 있는데, 위의 출력에서도 볼 수 있듯이 sub.py에 있는 코드 자체가 수행된다는 점에서 (로드가 아닌) Run이라는 점을 주의할 필요가 있습니다. (그래서 출력에 "sub: loaded"가 나타남)

게다가, 한 번 로드가 됐어도 다시 load_module 함수를 호출하면 재차 sub.py의 코드가 실행됩니다. 따라서 그런 부작용을 막고 싶다면 미리 sys.modules에서 조회하는 절차가 필요합니다.

$ cat call_main.py
import os
import sys


def is_loaded(module_name):
    return module_name in sys.modules


print('call_main:', os.getcwd())

module_path = '/mnt/c/temp'
module_name = 'sub'

module_path = module_path + os.sep + module_name + '.py'

from importlib.machinery import SourceFileLoader
module = SourceFileLoader(module_path, module_path).load_module()
print('call_main:', module.__name__)

module.__dict__['sub_func']()

# 만약 if 문 없이 실행하면 sub.py의 코드가 다시 실행됨
if not is_loaded(module_path):
    module = SourceFileLoader(module_path, module_path).load_module()




그렇다면, sub.py가 아닌 main.py를 로드하려면 어떻게 해야 할까요? 아쉽게도 이번에는 오류가 발생하는데요,

$ cat call_main.py
# ...[생략]...

print('call_main:', os.getcwd())

module_path = '/mnt/c/temp'
module_name = 'main'

# ...[생략]...

# main.py를 로드하므로 sub_func 검색/실행은 주석 처리
# module.__dict__['sub_func']()

$ python call_main.py
call_main: /mnt/c/test
main: loaded
Traceback (most recent call last):
  File "call_main.py", line 17, in <module>
    module = SourceFileLoader(module_path, module_path).load_module()
  File "<frozen importlib._bootstrap_external>", line 522, in _check_name_wrapper
  File "<frozen importlib._bootstrap_external>", line 1022, in load_module
  File "<frozen importlib._bootstrap_external>", line 847, in load_module
  File "<frozen importlib._bootstrap>", line 265, in _load_module_shim
  File "<frozen importlib._bootstrap>", line 702, in _load
  File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 843, in exec_module
  File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
  File "/mnt/c/temp/main.py", line 3, in <module>
    import sub
ModuleNotFoundError: No module named 'sub'

여기서도 또 주의해야 할 점이, main.py 자체를 로드하는데 실패한 것이 아니고, 그 내부의 코드를 실행하는 중에 오류가 발생했다는 점입니다. 위의 출력에 보면 분명히 main.py에 있던 "main: loaded" 메시지가 나오고 이후 "import sub"를 실행하는 시점에서 오류가 발생한 것입니다.

재미있는 건, 그렇다면 모듈이 로드된 것은 맞다고도 볼 수 있는데 sys.modules에는 main.py 모듈이 등록돼 있지 않습니다. 즉, 파이썬의 경우 (전통적인 의미의) 모듈 로딩과 그것의 실행이 모두 성공해야만 비로소 "loaded" 상태가 된다고 볼 수 있습니다.




그렇다면 위와 같은 경우에 sub.py까지 로드가 잘 되게 만들려면 어떻게 해야 할까요?

처음에는 cwd(current working directory)가 모듈 검색 경로에 포함될 거라 생각했는데요, 물론 call_main.py를 main.py와 함께 있는 디렉터리에서 실행하면 정상 동작을 하지만,

// call_main.py를 /mnt/c/temp 디렉터리에 복사

$ pwd
/mnt/c/temp

$ python call_main.py
call_main: /mnt/c/temp
main: loaded
sub: loaded
sub: sub_func called
call_main: /mnt/c/temp/main.py

단순히 main.py가 cwd와 같은 디렉터리라고 해서 실행되는 것도 아님을 아래의 실행 사례를 통해 확인할 수 있습니다.

// temp 디렉터리에서 ./test 디렉터리에 있는 call_main.py를 실행

$ pwd
/mnt/c/temp

$ python /mnt/c/test/call_main.py
call_main: /mnt/c/temp
main: loaded
Traceback (most recent call last):
  File "/mnt/c/test/call_main.py", line 18, in <module>
    module = SourceFileLoader(module_path, module_path).load_module()
  File "<frozen importlib._bootstrap_external>", line 522, in _check_name_wrapper
  File "<frozen importlib._bootstrap_external>", line 1022, in load_module
  File "<frozen importlib._bootstrap_external>", line 847, in load_module
  File "<frozen importlib._bootstrap>", line 265, in _load_module_shim
  File "<frozen importlib._bootstrap>", line 702, in _load
  File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 843, in exec_module
  File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
  File "/mnt/c/temp/main.py", line 3, in <module>
    import sub
ModuleNotFoundError: No module named 'sub'

이에 대한 정확한 기준은, 해당 경로가 sys.path에 포함돼 있는지입니다. 예를 들어, "python /mnt/c/test/call_main.py"라고 실행하면 sys.path는 기본적으로 이렇게 구성되는데,

[
    '/mnt/c/test', 
    '/home/kevin/miniconda3/envs/py38build/lib/python38.zip', 
    '/home/kevin/miniconda3/envs/py38build/lib/python3.8', 
    '/home/kevin/miniconda3/envs/py38build/lib/python3.8/lib-dynload', 
    '/home/kevin/miniconda3/envs/py38build/lib/python3.8/site-packages'
]

결국 최초 실행되는 call_main.py 파일을 포함한 경로(위의 경우 /mnt/c/test)가 sys.path에 포함되기 때문에 main.py는 sub.py를 찾을 수 없게 된 것입니다. 따라서 위의 코드를 어느 환경에서나 잘 동작하게 하려면 sys.path를 이런 식으로 조정해 주는 작업이 필요합니다.

module_path = '/mnt/c/temp'
module_name = 'main'

if not module_path in sys.path:
    sys.path.append(module_path)




참고로 SourceFileLoader.load_module 함수는 deprecated 되었으니,

Import arbitrary python source file. (Python 3.3+)
; https://stackoverflow.com/questions/19009932/import-arbitrary-python-source-file-python-3-3

대신 exec_module 함수를 사용하라고 권장하는군요. ^^ (그래도 테스트해보면 python 3.11까지도 잘 지원되고 있습니다.)

# module = SourceFileLoader(module_name, module_path).load_module()

loader = SourceFileLoader(module_name, module_path)
import types
mod = types.ModuleType(loader.name)
loader.exec_module(mod)




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 6/16/2025]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




1  2  3  4  5  6  7  8  9  10  11  12  [13]  14  15  ...
NoWriterDateCnt.TitleFile(s)
13652정성태6/21/202410406닷넷: 2267. C# - Linux 환경에서 (Reflection 없이) DLL AssemblyFileVersion 구하는 방법파일 다운로드2
13651정성태6/19/20249922닷넷: 2266. C# - (Reflection 없이) DLL AssemblyFileVersion 구하는 방법파일 다운로드1
13650정성태6/18/20249918개발 환경 구성: 713. "WSL --debug-shell"로 살펴보는 WSL 2 VM의 리눅스 환경
13649정성태6/18/20249008오류 유형: 910. windbg - !py 확장 명령어 실행 시 "failed to find python interpreter" (2)
13648정성태6/17/20249683오류 유형: 909. C# - DynamicMethod 사용 시 System.TypeAccessException
13647정성태6/16/202410893개발 환경 구성: 712. Windows - WSL 2의 네트워크 통신 방법 - 세 번째 이야기 (같은 IP를 공유하는 WSL 2 인스턴스) [1]
13646정성태6/14/20249062오류 유형: 908. Process Explorer - "Error configuring dump resources: The system cannot find the file specified."
13645정성태6/13/20249228개발 환경 구성: 711. Visual Studio로 개발 시 기본 등록하는 dev tag 이미지로 Docker Desktop k8s에서 실행하는 방법
13644정성태6/12/202410276닷넷: 2265. C# - System.Text.Json의 기본적인 (한글 등에서의) escape 처리 [1]
13643정성태6/12/20249349오류 유형: 907. MySqlConnector 사용 시 System.IO.FileLoadException 오류
13642정성태6/11/20249109스크립트: 65. 파이썬 - asgi 버전(2, 3)에 따라 달라지는 uvicorn 호스팅
13641정성태6/11/20249877Linux: 71. Ubuntu 20.04를 22.04로 업데이트
13640정성태6/10/202410333Phone: 21. C# MAUI - Android 환경에서의 파일 다운로드(DownloadManager)
13639정성태6/8/20249807오류 유형: 906. C# MAUI - Android Emulator에서 "Waiting For Debugger"로 무한 대기
13638정성태6/8/20249940오류 유형: 905. C# MAUI - 추가한 layout XML 파일이 Resource.Layout 멤버로 나오지 않는 문제
13637정성태6/6/20249266Phone: 20. C# MAUI - 유튜브 동영상을 MediaElement로 재생하는 방법
13636정성태5/30/20248840닷넷: 2264. C# - 형식 인자로 인터페이스를 갖는 제네릭 타입으로의 형변환파일 다운로드1
13635정성태5/29/202410448Phone: 19. C# MAUI - 안드로이드 "Share" 대상으로 등록하는 방법
13634정성태5/24/202411022Phone: 18. C# MAUI - 안드로이드 플랫폼에서의 Activity 제어 [1]
13633정성태5/22/202410346스크립트: 64. 파이썬 - ASGI를 만족하는 최소한의 구현 코드
13632정성태5/20/20249439Phone: 17. C# MAUI - Android 내에 Web 서비스 호스팅
13631정성태5/19/202410464Phone: 16. C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법 [1]
13630정성태5/19/20249579닷넷: 2263. C# - Thread가 Task보다 더 빠르다는 어떤 예제(?)
13629정성태5/18/202410018개발 환경 구성: 710. Android - adb.exe를 이용한 파일 전송
13628정성태5/17/20249293개발 환경 구성: 709. Windows - WHPX(Windows Hypervisor Platform)를 이용한 Android Emulator 가속
13627정성태5/17/20249436오류 유형: 904. 파이썬 - UnicodeEncodeError: 'ascii' codec can't encode character '...' in position ...: ordinal not in range(128)
1  2  3  4  5  6  7  8  9  10  11  12  [13]  14  15  ...