개발 환경 설정¶
BeeWare에 기여하려면 개발 환경을 설정해야 합니다.
선행 조건¶
다음 필수 구성 요소를 설치해야 합니다.
BeeWare는 Python 3.10+이 필요합니다. 또한 가상 환경 관리 방법(예:
venv)이 필요합니다.
설치된 Python 버전을 확인하려면 다음 명령어를 실행하세요:
$ python3 --version
여러 버전의 Python이 설치된 경우, python3를 특정 버전 번호(예: python3.13)로 대체해야 할 수 있습니다.
최근에 출시된 Python 버전(예: 3.14.0과 같이 ".0" 또는 ".1" 마이크로 버전 번호를 가진 버전)은 사용하지 않는 것이 좋습니다. 이는 macOS에서 Python을 지원하기 위해 필요한 도구가 최근 출시된 안정 버전용으로는 일반적으로 제공되지 않거나 지연되기 때문입니다.
BeeWare는 Python 3.10+이 필요합니다. 또한 가상 환경 관리 방법(예:
venv)이 필요합니다.
설치된 Python 버전을 확인하려면 다음 명령어를 실행하세요:
$ python3 --version
여러 버전의 Python이 설치된 경우, python3를 특정 버전 번호(예: python3.13)로 대체해야 할 수 있습니다.
최근에 출시된 Python 버전(예: 3.14.0과 같이 ".0" 또는 ".1" 마이크로 버전 번호를 가진 버전)은 사용하지 않는 것이 좋습니다. 이는 Linux에서 Python을 지원하기 위해 필요한 도구가 최근 출시된 안정판 Python 버전에 대해 일반적으로 제공되지 않거나 지연되기 때문입니다.
BeeWare는 Python 3.10+이 필요합니다. 또한 가상 환경 관리 방법(예:
venv)이 필요합니다.
설치된 Python 버전을 확인하려면 다음 명령어를 실행하세요:
C:\...>py -3 --version
여러 버전의 Python이 설치된 경우, -3를 특정 버전 번호(예: -python3.13)로
대체해야 할 수 있습니다.
최근에 출시된 Python 버전(예: 3.14.0과 같이 ".0" 또는 ".1" 마이크로 버전 번호를 가진 버전)은 피하는 것이 좋습니다. 이는 Windows에서 Python을 지원하기 위해 필요한 도구가 최근 출시된 안정판 Python 버전에 대해 일반적으로 제공되지 않거나 지연되기 때문입니다.
개발 환경 설정하기¶
BeeWare 개발 환경을 설정하는 권장 방법은 가상 환경을 사용한 후, BeeWare의 개발 버전과 그 종속성을 설치하는 것입니다.
BeeWare 저장소를 복제하세요¶
다음으로 GitHub의 BeeWare 페이지로 이동하여, 아직 하지 않았다면 저장소를 포크하여 본인 계정에 복제하세요. 다음으로, 포크한 페이지에서 "<> 코드" 버튼을 클릭하세요. 컴퓨터에 GitHub 데스크톱 애플리케이션이 설치되어 있다면 "GitHub 데스크톱으로 열기"를 선택할 수 있습니다. 그렇지 않은 경우 제공된 HTTPS URL을 복사한 후 명령줄을 사용하여 해당 URL로 저장소를 컴퓨터에 복제하세요:
BeeWare 저장소를 포크한 후 다음을 수행하세요:
$ git clone https://github.com/<your username>/beeware.git
(GitHub 사용자 이름을 대체)
BeeWare 저장소를 포크한 후 다음을 수행하세요:
$ git clone https://github.com/<your username>/beeware.git
(GitHub 사용자 이름을 대체)
BeeWare 저장소를 포크한 후 다음을 수행하세요:
C:\...>git clone https://github.com/<your username>/beeware.git
(GitHub 사용자 이름을 대체)
가상 환경 생성¶
가상 환경을 설정하고 pip를 업그레이드하려면 다음을 실행하십시오:
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
이제 프롬프트 앞에 (.venv) 접두사가 붙어 있어야 합니다.
설치 BeeWare¶
이제 소스 코드를 확보했으므로, 개발 환경에 (https://setuptools.pypa.io/en/latest/userguide/development_mode.html)을 [editable install]BeeWare할 수 있습니다. 다음 명령어를 실행하세요:
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
프리커밋 활성화¶
BeeWare는 pre-commit이라는 도구를 사용하여 간단한 문제를 식별하고 코드 서식을 표준화합니다. 이는 git 커밋을 최종 확정하기 전에 일련의 코드 린터를 자동으로 실행하는 git 훅을 설치함으로써 이루어집니다. pre-commit을 활성화하려면 다음 명령을 실행하세요:
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
이제 BeeWare 해킹을 시작할 준비가 되었습니다!