[python] cx_Freeze를 사용하여 작성한 실행 파일에서 외부 라이브러리 사용하기

cx_Freeze는 Python 프로그램을 실행 파일로 변환하는 도구입니다. 이 도구를 사용하면 Python 프로그램을 외부 환경에 의존하지 않는 독립적인 실행 파일로 만들 수 있습니다. 이때, 프로그램이 외부 라이브러리를 사용한다면, 해당 라이브러리도 함께 포함해야 합니다.

아래는 cx_Freeze를 사용하여 한 실행 파일 안에서 외부 라이브러리를 포함하는 방법입니다.

1. 프로젝트 구조 설정

프로젝트 폴더/
├── main.py
├── library/
│   ├── library.py
│   └── __init__.py
└── setup.py

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 프로그램을 더 편리하게 배포하고 실행할 수 있습니다.

참고 자료