한글문서를 PDF로 자동 변환하는 실행파일 만들기 (파이썬 + PyInstaller 실무 활용)

한글문서를 PDF로 자동 변환하는 실행파일 만들기 (파이썬 + PyInstaller 실무 활용)

파이썬(Python)은 강력한 프로그래밍 언어로 다양한 자동화 작업에 널리 사용됩니다. 하지만 파이썬 스크립트는 기본적으로 .py 확장자이며, 이를 실행하려면 사용자의 PC에 파이썬이 설치되어 있어야 합니다.

하지만 공유하거나 배포해야 하는 상황이라면? 파이썬 코드를 실행파일(.exe)로 만들어 누구나 더블클릭 한 번으로 실행할 수 있게 만드는 것이 훨씬 유리하겠죠.

이번 글에서는 파이썬 스크립트를 EXE 실행파일로 변환하는 방법을 한글(.hwp) 문서를 PDF로 자동 변환하는 예제 코드를 통해 자세히 소개합니다.

---

✅ 왜 파이썬 코드를 실행파일로 만들까요?

• ✔️ 파이썬 미설치 환경에서도 실행 가능
• ✔️ 배포가 간편해짐
• ✔️ 더블클릭 한 번으로 실행
• ✔️ 콘솔 기반 자동화 도구 제작에 최적

---

🔧 PyInstaller로 EXE 만들기

파이썬 코드를 EXE로 만드는 가장 널리 사용되는 도구는 PyInstaller입니다.

📦 설치 방법

pip install pyinstaller

---

📄 예제: 한글 문서를 PDF로 변환하는 자동화 코드

이번 예제에서는 pyhwpx 라이브러리를 활용해 .hwp 또는 .hwpx 파일을 PDF로 자동 변환하는 코드를 작성합니다.

💡 예제 코드 (hwp_to_pdf.py)

import os
import sys

from pyhwpx import Hwp


def hwp_to_pdf(hwp_path):
    if not os.path.exists(hwp_path):
        print("❌ 파일이 존재하지 않습니다.")
        return

    try:
        hwp = Hwp()
        hwp.open(hwp_path)

        output_path = os.path.splitext(hwp_path)[0] + ".pdf"
        hwp.save_as(output_path)
        print(f"✅ PDF 저장 완료: {output_path}")
        hwp.quit()

    except Exception as e:
        print("⚠️ 변환 중 오류 발생:", e)

if __name__ == "__main__":
    if len(sys.argv) > 1:
        hwp_file = sys.argv[1]
        hwp_to_pdf(hwp_file)
    else:
        print("ℹ️ 변환할 .hwp 또는 .hwpx 파일을 드래그해서 실행해주세요.")

📌 위 코드는 사용자가 .hwp 또는 .hwpx 파일을 실행파일 위에 드래그앤드롭하면 자동으로 PDF로 변환되도록 설계되어 있습니다.

---

🛠 실행파일(.exe)로 만들기

명령어:

pyinstaller --onefile hwp_to_pdf.py

생성된 EXE 파일은 dist/hwp_to_pdf.exe 경로에 생성됩니다.
이 파일 하나만 다른 PC로 복사해도 실행이 가능합니다.

📌 주의사항

해당 PC에는 한컴오피스 또는 한글 뷰어가 설치되어 있어야 변환이 제대로 작동합니다.

 

py파일이 있는 폴더경로에 dist 폴더 및 실행파일이 생성됨

---

📎 --noconsole 옵션이란?

--noconsole 옵션은 실행 시 콘솔창(검은 창)을 띄우지 않도록 설정합니다.

pyinstaller --onefile --noconsole hwp_to_pdf.py

하지만 이 옵션을 사용하면 print() 메시지가 사용자에게 보이지 않기 때문에, 개발 중에는 생략하고, 배포 시에만 적용하는 것이 좋습니다.

또는 tkinter.messagebox를 활용하면 GUI 알림창으로 메시지를 표시할 수도 있습니다.

---

📂 실행 방법: 드래그앤드롭으로 변환하기

1. PDF로 변환할 .hwp 또는 .hwpx 파일을 준비합니다.
2. 생성된 실행파일(hwp_to_pdf.exe)에 해당 파일을 마우스로 드래그하여 올려놓습니다.
3. 자동으로 PDF로 변환되며, 같은 폴더에 .pdf 파일이 생성됩니다.

이 방식은 명령어 입력 없이도 직관적으로 사용할 수 있어 비개발자도 쉽게 활용할 수 있습니다.

한글문서 PDF 변환 실행파일(EXE) 실행

---

✅ 마무리

이번 글에서는 파이썬 코드를 실행파일로 만드는 방법을 실전 예제(한글 문서를 PDF로 변환)를 통해 소개했습니다.

업무 자동화나 내부 툴 제작, 배포 가능한 유틸리티 제작에 유용한 방식이니 실무에 적극 활용해보세요!

 

궁금한 점이나 확장 기능(GUI, 다중파일 변환 등)이 필요하시다면 댓글로 남겨주세요! 😊