파이썬 개발 지침
GitLab은 reStructuredText 마크업 렌더링을 위해 파이썬을 의존성으로 요구합니다. Python 3이 필요합니다.
설치
시스템에 파이썬을 설치하는 여러 방법이 있습니다. 우리가 프로덕션에서 사용하는 것과 동일한 버전을 사용하려면, pyenv를 사용할 것을 권장합니다. 이는 루비 세계의 대응물인 rbenv와 유사하게 작동하고 행동합니다.
macOS
macOS에서 pyenv를 설치하려면 Homebrew를 사용할 수 있습니다:
brew install pyenv
Windows
pyenv는 윈도우를 공식적으로 지원하지 않으며, 윈도우 하위 시스템 외부에서는 작동하지 않습니다. 윈도우 사용자라면 pyenv-win을 사용할 수 있습니다.
윈도우에서 pyenv-win을 설치하려면 다음 PowerShell 명령을 실행하세요:
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
pyenv-win에 대해 더 알아보세요.
Linux
Linux에 pyenv를 설치하려면 아래 명령을 실행할 수 있습니다:
curl "https://pyenv.run" | bash
또는 배포판의 패키지 관리자를 통해 시스템 패키지로 pyenv를 찾을 수 있습니다.
자세한 내용은 pyenv 필수 조건에서 읽을 수 있습니다.
셸 통합
Pyenv 설치 시 Bash에 필요한 변경 사항이 추가됩니다. 다른 셸을 사용하는 경우, 추가로 필요한 단계를 확인하세요.
Fish를 사용하는 경우, Fisher용 플러그인을 설치할 수 있습니다:
fisher add fisherman/pyenv
또는 Oh My Fish용:
omf install pyenv
의존성 관리
GitLab은 파이썬 스크립트를 직접 포함하지 않지만, reStructuredText 마크업을 렌더링하기 위해 파이썬에 의존하므로, 개발 머신에서 이를 실행할 수 있도록 메인 프로젝트 수준에서 의존성을 추적해야 합니다.
최근에 파이썬에 Gemfile 및 Bundler 프로젝트에 상응하는 것이 도입되었습니다: Pipfile 및 Pipenv.
의존성이 포함된 Pipfile이 루트 폴더에 존재합니다. 이를 설치하려면 다음을 실행하세요:
pipenv install
이 명령을 실행하면 필요한 파이썬 버전과 pip 의존성을 모두 설치합니다.
사용 지침
Pipenv 환경에서 어떤 파이썬 코드를 실행하려면, 먼저 애플리케이션의 의존성을 기반으로 한 virtualenv를 시작해야 합니다. Pipenv을 사용하면, 다음을 실행하는 것이 간단합니다:
pipenv shell
이 명령을 실행한 후, 같은 셸에서 GitLab을 실행할 수 있으며, pipenv install 명령에서 설치된 파이썬 및 의존성을 사용합니다.
도움말