Pyvan이란?

Pyvan은 파이썬 스크립트를 윈도우용 독립 실행형 데스크톱 애플리케이션으로 변환하는 데 특화된 패키징 도구입니다. 기존의 번들링 툴과 차별화되는 점은 최종 바이너리에 소스 코드를 포함하면서도 수정이 가능하게 유지할 수 있다는 점입니다. 이는 디버깅이나 사용자 맞춤 설정이 필요한 상황에서 유리합니다.

기본 설치 및 사용법

사용을 위해선 먼저 Python 3.8 이상 환경이 필요하며, 다음 명령어로 Pyvan을 설치할 수 있습니다.

pip install pyvan

예를 들어 app.py라는 이름의 파이썬 스크립트가 존재할 경우, 이를 실행 가능한 프로그램으로 만들려면 아래와 같이 입력합니다.

pyvan app.py

GUI 기반 애플리케이션의 경우 터미널 창(콘솔)이 함께 뜨는 것을 방지하기 위해 --no-console 플래그를 추가할 수 있습니다.

pyvan app.py --no-console

고급 설정: 구성 파일 활용

더 세밀한 제어를 원한다면 동일 디렉터리 내에 van.py라는 설정 파일을 만들어 옵션을 정의할 수 있습니다. 다음은 그 예시입니다.

import pyvan

CONFIG = {
    "main_file_name": "app.py",
    "show_console": False,
    "requirements_path": "requirements.txt",
    "include_dependencies": True,
    "python_version_hint": "3.10",
    "auto_discover_packages": True,
    "additional_modules": ["requests", "pillow"],
    "exclude_packages": ["unittest", "pytest"],
    "force_include": [],
    "download_cache_dir": "./_cache",
    "output_directory": "./build",
    "source_code_subfolder": "src",
    "application_icon": "icon.ico",
    "debug_mode": False,
    "compression_level": 6
}

이 설정 파일을 기반으로 pyvan 명령어를 실행하면 지정된 규칙에 따라 패키징이 진행됩니다.

주요 활용 사례

• 내부 도구 배포: IT 관리자나 데이터 분석가가 만든 파이썬 스크립트를 일반 직원용 GUI 도구로 전환하여 배포할 때 유용합니다.
• 교육용 앱 제작: 학생들이 코드를 확인하고 수정하면서 실행할 수 있는 교육 소프트웨어 개발에 적합합니다.
• 오픈소스 데스크톱 앱 배포: 소스 공개를 원하면서도 설치 없이 바로 실행 가능한 형태로 제공하고자 할 때 효과적입니다.

모범 사례

• 의존성 관리 철저히 하기: requirements.txt 또는 pyproject.toml을 사용해 의존성을 명확히 정의하세요.
• 빌드 전 테스트 수행: 실제 실행 환경과 유사한 환경에서 동작 테스트를 완료한 후 빌드하세요.
• 아이콘 및 메타데이터 설정: 사용자 경험을 고려해 .ico 아이콘 파일을 포함시키고, 의미 있는 이름을 부여하세요.
• 버전 추적 유지: Git 등의 버전 관리 시스템을 활용해 어떤 소스로 빌드했는지 기록하세요.

호환 가능한 생태계 도구

Pyvan은 다른 파이썬 라이브러리와 함께 사용될 수 있으며, 대표적인 조합은 다음과 같습니다.

• Flet 또는 CustomTkinter: 현대적인 UI를 갖춘 앱 개발에 적합합니다.
• PyQt6 / PySide6: 복잡한 인터페이스가 필요한 프로젝트와 잘 어울립니다.
• httpx + Jinja2: 로컬 웹뷰 기반 데스크톱 앱 개발 시 활용 가능합니다.
• cx_Freeze와 비교: Pyvan은 경량화 및 소스 접근성 측면에서 보완적인 선택지가 될 수 있습니다.