[python] cx_Freeze를 사용하여 파이썬 모듈을 실행 파일로 변환하는 방법

파이썬 프로그램을 실행 파일로 변환하면 사용자가 파이썬 인터프리터를 설치하지 않고도 프로그램을 실행할 수 있습니다. 이를 가능하게 해주는 도구 중 하나는 cx_Freeze입니다. cx_Freeze는 파이썬 스크립트와 필요한 종속성을 번들로 묶어 실행 파일을 만들어줍니다.

cx_Freeze 설치

먼저 cx_Freeze를 설치해야 합니다. pip를 사용하여 다음 명령을 실행합니다:

pip install cx_Freeze

설정 파일 작성

cx_Freeze는 설정 파일을 사용하여 번들에 포함할 모듈과 종속성을 지정합니다. 프로젝트 폴더에 setup.py라는 이름의 설정 파일을 만들고 다음과 같이 작성합니다:

from cx_Freeze import setup, Executable

setup(
    name="MyApp",
    version="0.1",
    description="My Python Application",
    executables=[Executable("main.py")],
    options={
        "build_exe": {
            "packages": ["numpy", "pandas"],  # 필요한 패키지들
            "include_files": ["data.csv"],  # 필요한 파일들
        }
    }
)

위 설정 파일에서 name, version, description은 애플리케이션에 대한 정보를 지정하는 부분입니다. executables는 실행 파일로 변환할 스크립트를 지정합니다. 위 예제에서는 main.py를 변환합니다. options에서는 번들에 포함할 패키지와 파일을 지정합니다. 위 예제에서는 numpy, pandas 패키지와 data.csv 파일을 번들에 포함합니다.

실행 파일 생성

설정 파일을 작성했다면, 명령 프롬프트 또는 터미널에서 다음과 같이 setup.py를 실행하여 실행 파일을 생성할 수 있습니다:

python setup.py build

위 명령을 실행하면 build 폴더가 생성되고 그 안에 실행 파일이 생성됩니다.

실행 파일 실행

실행 파일이 생성되었다면, 해당 파일을 더블 클릭하여 실행할 수 있습니다. 사용자 컴퓨터에 파이썬 인터프리터가 설치되어 있지 않아도 실행 파일은 독립적으로 실행됩니다.

결론

cx_Freeze를 사용하여 파이썬 모듈을 실행 파일로 변환하는 방법을 살펴보았습니다. 이를 통해 사용자는 파이썬 인터프리터를 따로 설치하지 않아도 파이썬 애플리케이션을 실행할 수 있게 됩니다. 추가로 실행 파일에 필요한 패키지나 파일을 정확하게 지정하여 번들에 포함시키는 것이 중요합니다. cx_Freeze의 자세한 사용법은 공식 문서를 참조하시기 바랍니다.

참고 자료