[python] cx_Freeze 설정 파일에서 의존성 패키지 설정하기

22 Nov 2023

python

cx_Freeze는 Python 프로그램을 실행 파일로 변환해주는 도구입니다. 이때, 프로그램이 의존하는 외부 패키지들을 함께 실행 파일에 포함해야 합니다. 이번 포스트에서는 cx_Freeze 설정 파일에서 의존성 패키지를 설정하는 방법에 대해 알아보겠습니다.

1. 설정 파일 생성

먼저, 프로젝트 루트 디렉토리에 setup.py라는 이름으로 설정 파일을 생성합니다.

# setup.py

from cx_Freeze import setup, Executable

options = {
    'build_exe': {
        'packages': ['numpy', 'pandas'],  # 의존성 패키지 설정
    },
}

executables = [
    Executable('main.py'),  # 컴파일할 main script 파일 설정
]

setup(name='My Program',
      version='1.0',
      description='My Program Description',
      options=options,
      executables=executables)

packages 속성에 의존하는 패키지들을 리스트 형태로 설정합니다. 이 예제에서는 numpy와 pandas 패키지를 의존성 패키지로 설정하였습니다.

2. 컴파일

터미널에서 다음 명령을 실행하여 프로그램을 컴파일합니다.

$ python setup.py build

컴파일이 완료되면 build 디렉토리에 실행 파일이 생성됩니다.

3. 실행 시 의존성 패키지 확인

컴파일한 실행 파일을 실행하여 의존성 패키지가 올바르게 포함되었는지 확인할 수 있습니다.

$ ./main

만약, 실행 중에 의존성 패키지가 없다는 오류가 발생한다면, setup.py 파일에서 의존성 패키지를 정확하게 설정했는지 다시 한 번 확인해보세요.

이제, cx_Freeze 설정 파일에서 의존성 패키지를 설정하여 Python 프로그램을 실행 파일로 만드는 방법에 대해 알아보았습니다. 이를 통해 프로그램을 배포하는 과정을 보다 편리하고 안정적으로 처리할 수 있습니다.

참고 자료

cx_Freeze Documentation: https://cx-freeze.readthedocs.io
Python Packaging User Guide: https://packaging.python.org