[python] cx_Freeze를 사용하여 작성한 실행 파일에서 외부 라이브러리 사용하기
cx_Freeze는 Python 프로그램을 실행 파일로 변환하는 도구입니다. 이 도구를 사용하면 Python 프로그램을 외부 환경에 의존하지 않는 독립적인 실행 파일로 만들 수 있습니다. 이때, 프로그램이 외부 라이브러리를 사용한다면, 해당 라이브러리도 함께 포함해야 합니다.
아래는 cx_Freeze를 사용하여 한 실행 파일 안에서 외부 라이브러리를 포함하는 방법입니다.
1. 프로젝트 구조 설정
프로젝트 폴더/
├── main.py
├── library/
│ ├── library.py
│ └── __init__.py
└── setup.py
- main.py: 실행 파일로 변환할 메인 Python 스크립트 파일입니다.
- library/: 외부 라이브러리를 포함한 디렉토리입니다.
- setup.py: cx_Freeze 설정 파일입니다.
2. setup.py 작성
from cx_Freeze import setup, Executable
# 실행 파일에 포함할 외부 라이브러리 경로
include_files = ['library']
setup(
name='MyProgram',
version='1.0',
description='My Python Program',
executables=[Executable('main.py')],
options={
'build_exe': {
'include_files': include_files,
}
}
)
setup.py는 cx_Freeze의 설정 파일로, 실행 파일을 만들기 위해 필요한 정보들을 담고 있습니다. include_files에는 외부 라이브러리를 포함한 경로를 지정해야 합니다.
3. 실행 파일 생성
터미널에서 다음 명령을 실행하여 cx_Freeze를 이용해 실행 파일을 생성합니다.
$ python setup.py build
이 명령을 실행하면 build 폴더가 생성되고, 그 안에 실행 파일이 생성됩니다.
4. 실행 파일 실행
build 폴더 안에 생성된 실행 파일을 실행하면, 프로그램이 외부 라이브러리를 사용하며 정상적으로 동작하는 것을 확인할 수 있습니다.
이처럼 cx_Freeze를 사용하면 외부 라이브러리를 포함한 실행 파일을 만들 수 있어, Python 프로그램을 더 편리하게 배포하고 실행할 수 있습니다.
참고 자료
- cx_Freeze 공식 문서: https://cx-freeze.readthedocs.io