파이썬 스크립트(.py)를 실행 파일(.exe)로 변환하는 방법: PyInstaller 활용 가이드

Python으로 작성된 유용한 스크립트를 다른 사용자들에게 공유할 때, Python 환경 설정이나 라이브러리 설치 없이 바로 실행할 수 있도록 .exe 파일로 만드는 것이 매우 편리합니다. 오늘은 이 과정을 PyInstaller를 활용하여 알아보겠습니다.

1. PyInstaller 설치하기

가장 먼저 PyInstaller를 설치해야 합니다. PowerShell(또는 CMD)과 같은 터미널을 열고 다음 명령어를 입력해 주세요.

powershell

pip install pyinstaller

이 명령어를 실행하면 PyInstaller가 시스템에 성공적으로 설치됩니다.

2. 파이썬 스크립트를 .exe 파일로 변환하기 (콘솔 프로그램 기준)

이제 설치된 PyInstaller를 사용하여 파이썬 스크립트를 실행 파일로 변환해 보겠습니다. 예시로 hwp2pdf.py 스크립트가 C:\Temp 폴더에 있다고 가정하겠습니다. 해당 스크립트가 있는 폴더로 이동한 후 다음 명령어를 사용합니다.

powershell

cd C:\Temp
pyinstaller --onefile hwp2pdf.py

• --onefile 옵션: 이 옵션은 스크립트 실행에 필요한 Python 인터프리터, 라이브러리, DLL 등 모든 종속성 파일을 하나의 실행 파일(.exe) 안에 묶어주는 역할을 합니다. 이 덕분에 배포가 매우 편리해지며, 다른 PC에 Python이나 PyInstaller가 설치되어 있지 않아도 실행 파일을 통해 스크립트를 바로 실행할 수 있게 됩니다.

3. 변환 결과 확인

명령어 실행이 완료되면, 프로젝트 폴더 안에 dist와 build라는 새로운 폴더가 생성됩니다.

• dist\ 폴더: 실제 배포용 실행 파일인 hwp2pdf.exe가 이곳에 생성됩니다.
• build\ 폴더: 빌드 과정에서 생성되는 임시 파일들과 hwp2pdf.spec 파일(빌드 설정 정보)이 저장됩니다.

이제 dist 폴더 안에 있는 hwp2pdf.exe 파일만 복사하여 다른 PC(동일한 운영체제와 비트 수)에서 바로 실행하여 사용하실 수 있습니다. 이 방법을 통해 HWP 파일을 PDF로 변환하는 프로그램과 같은 유용한 스크립트를 더욱 쉽게 배포하실 수 있을 것입니다.