Repolode
chriskiehl

chriskiehl/Gooey

단일 데코레이터로 argparse 기반 명령줄 프로그램을 데스크톱 GUI로 바꿔 주는 Python 라이브러리입니다.

스타
21,896
포크
1,047
열린 이슈
172
마지막 커밋
15시간 전

어떤 프로젝트인가요?

Gooey는 argparse를 사용하는 Python 콘솔 프로그램을 감싸고, 프로그램의 인자 선언을 바탕으로 그래픽 인터페이스를 생성합니다. 파서를 만드는 함수에 @Gooey 데코레이터를 추가하기만 하면 입력 필드, 체크박스, 드롭다운 등의 컨트롤이 있는 창을 띄울 수 있으며, 스크립트는 기존과 동일하게 실행됩니다.

기본적으로 Gooey는 각 argparse 액션을 적절한 위젯에 자동으로 대응시킵니다. ArgumentParser 대신 GooeyParser를 사용하면 파일 및 디렉터리 선택기, 날짜 및 시간 선택기, 슬라이더, 비밀번호 입력 필드, 목록 상자 등의 위젯을 직접 선택할 수 있습니다. 레이아웃, 창 크기, 설정 화면(기본 또는 고급), 메뉴, 프로그램 출력에 정규식을 적용해 표시하는 진행률 표시줄도 데코레이터 인자로 설정할 수 있습니다.

Gooey는 Python 3을 지원하며, README에는 Python 2 사용자는 이전 릴리스 버전을 고정해야 한다고 안내되어 있습니다. 여러 언어의 번역을 포함하고 있으며, PyInstaller로 실행 파일을 패키징할 수 있습니다.

핵심 기능

  • 01단일 @Gooey 데코레이터로 argparse 프로그램에 GUI를 추가합니다.
  • 02argparse 액션을 위젯에 자동으로 대응시키며, GooeyParser를 사용하면 위젯을 직접 선택할 수 있습니다.
  • 03파일, 디렉터리, 날짜, 시간, 색상 선택기와 슬라이더 위젯을 제공합니다.
  • 04프로그램 출력에서 정규식이 일치하는 내용을 바탕으로 진행률 표시줄을 표시하며, 선택적으로 남은 시간도 보여 줍니다.
  • 05정보, 메시지, 링크, HTML 대화상자를 포함한 메뉴 바를 제공합니다.
  • 06JSON 언어 파일을 통한 국제화를 지원합니다.

활용 사례

  • 프로그래머가 아닌 동료가 내부 Python 스크립트를 클릭만으로 사용할 수 있는 인터페이스를 제공합니다.
  • 데이터 처리 또는 파일 변환 유틸리티를 감싸 사용자가 시각적으로 입력 파일을 선택할 수 있게 합니다.
  • Python CLI 도구를 폼 인터페이스를 갖춘 독립 실행형 Windows 또는 데스크톱 실행 파일로 패키징합니다.

빠른 시작

  1. 1

    pip으로 PyPI에서 Gooey를 설치하세요

    pip install Gooey
  2. 2

    argparse 메인 함수에 @Gooey 데코레이터를 적용하세요

사용 전 알아둘 점

  • Python 2는 더 이상 지원되지 않습니다. Python 2 사용자는 이전 릴리스를 지정하고 wxPython을 수동으로 설치해야 합니다.
  • Gooey는 wxPython에 의존하지만, Python 2에서는 pip 설치 과정의 일부로 wxPython을 설치할 수 없습니다.

포함된 컬렉션

토픽

#python#gui#argparse#cli#desktop-app#wxpython

자주 묻는 질문

Gooey은(는) 무엇인가요?
단일 데코레이터로 argparse 기반 명령줄 프로그램을 데스크톱 GUI로 바꿔 주는 Python 라이브러리입니다. Gooey는 argparse를 사용하는 Python 콘솔 프로그램을 감싸고, 프로그램의 인자 선언을 바탕으로 그래픽 인터페이스를 생성합니다. 파서를 만드는 함수에 @Gooey 데코레이터를 추가하기만 하면 입력 필드, 체크박스, 드롭다운 등의 컨트롤이 있는 창을 띄울 수 있으며, 스크립트는 기존과 동일하게 실행됩니다.
Gooey은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Gooey은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Gooey은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Gooey의 마지막 커밋은 2026년 11월 7일입니다.
Gooey은(는) 어디에 사용할 수 있나요?
프로그래머가 아닌 동료가 내부 Python 스크립트를 클릭만으로 사용할 수 있는 인터페이스를 제공합니다. 데이터 처리 또는 파일 변환 유틸리티를 감싸 사용자가 시각적으로 입력 파일을 선택할 수 있게 합니다. Python CLI 도구를 폼 인터페이스를 갖춘 독립 실행형 Windows 또는 데스크톱 실행 파일로 패키징합니다.
Gooey는 어떻게 설치하나요?
pip으로 PyPI에서 Gooey를 설치하세요: pip install Gooey argparse 메인 함수에 @Gooey 데코레이터를 적용하세요
Gooey은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/chriskiehl/Gooey

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트