pyinstaller --onefile --name ClipboardPlainText clipboard_plain_text.py
Python 프로그램을 EXE 파일로 만드는 방법
======================================
1. 준비 사항
------------
Windows에서 Python 스크립트를 실행 파일(.exe)로 만들려면 보통 PyInstaller를 사용합니다.
먼저 명령 프롬프트 또는 PowerShell에서 아래 명령으로 PyInstaller를 설치합니다.
pip install pyinstaller
2. 기본 EXE 생성 방법
---------------------
예를 들어 Python 파일 이름이 아래와 같다고 가정합니다.
clipboard_plain_text.py
해당 파일이 있는 폴더에서 아래 명령을 실행합니다.
pyinstaller --onefile --console clipboard_plain_text.py
빌드가 완료되면 아래 위치에 EXE 파일이 생성됩니다.
dist\clipboard_plain_text.exe
3. 실행 파일 이름 지정하기
--------------------------
EXE 파일 이름을 원하는 이름으로 지정하려면 --name 옵션을 사용합니다.
추천 명령:
pyinstaller --onefile --name ClipboardPlainText clipboard_plain_text.py
생성되는 실행 파일 위치:
dist\ClipboardPlainText.exe
4. 콘솔 창 없이 실행되도록 만들기
---------------------------------
실행할 때 검은 콘솔 창이 뜨지 않게 하려면 --noconsole 옵션을 사용할 수 있습니다.
pyinstaller --onefile --noconsole --name ClipboardPlainText clipboard_plain_text.py
단, 프로그램 안에서 print()로 메시지를 출력하는 경우에는 콘솔 창이 없으면 메시지가 보이지 않습니다.
처음 테스트할 때는 --console 옵션을 사용하는 것이 좋습니다.
5. 권장 테스트 순서
------------------
처음에는 아래 명령으로 빌드하는 것을 추천합니다.
pyinstaller --onefile --console --name ClipboardPlainText clipboard_plain_text.py
정상 동작이 확인되면 필요에 따라 콘솔 창 없는 버전으로 다시 빌드합니다.
pyinstaller --onefile --noconsole --name ClipboardPlainText clipboard_plain_text.py
6. 사용 방법
------------
1) Word, 웹페이지, 메일 등에서 서식 있는 텍스트를 복사합니다.
2) ClipboardPlainText.exe를 실행합니다.
3) 클립보드 내용이 서식 없는 텍스트로 변환됩니다.
4) 원하는 곳에 붙여넣습니다.
7. 참고 사항
------------
PyInstaller로 만든 단일 EXE 파일은 Windows Defender나 백신에서 경고가 나올 수 있습니다.
이런 경우가 반드시 악성코드라는 뜻은 아니며, PyInstaller 단일 실행 파일에서 종종 발생하는 오탐 케이스입니다.
회사 PC나 여러 사람에게 배포할 목적이라면 --onedir 방식이 더 안정적일 수 있습니다.
pyinstaller --onedir --name ClipboardPlainText clipboard_plain_text.py
이 경우 실행 파일은 아래 위치에 생성됩니다.
dist\ClipboardPlainText\ClipboardPlainText.exe
단, --onedir 방식은 EXE 파일 하나만 배포하는 것이 아니라 해당 폴더 전체를 함께 배포해야 합니다.