Python 개발 가이드라인
GitLab은 reStructuredText 마크업 렌더링을 위해 Python을 의존성으로 사용합니다. Python 3이 필요합니다.
설치
시스템에 Python을 설치하는 여러 가지 방법이 있습니다. 프로덕션에서 사용하는 것과 동일한 버전을 사용할 수 있도록 하려면 pyenv를 사용하는 것을 권장합니다. 이는 루비 세계의 rbenv와 유사하게 작동합니다.
macOS
macOS에서는 다음과 같이 pyenv를 Homebrew를 사용하여 설치할 수 있습니다:
brew install pyenv
Windows
pyenv는 공식적으로 Windows를 지원하지 않으며 Windows Subsystem for Linux 외부의 Windows에서는 작동하지 않습니다. Windows 사용자는 pyenv-win을 사용할 수 있습니다.
Windows에서 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에는 직접적으로 Python 스크립트가 포함되어 있지는 않지만, reStructuredText 마크업을 렌더링하기 위해 Python에 의존하므로, 개발 머신에서 이를 실행할 수 있도록 프로젝트 수준에서 종속성을 추적해야 합니다.
최근에는 Gemfile 및 Bundler 프로젝트에 Python에 대응되는 것이 소개되었습니다: Pipfile 및 Pipenv.
Pipfile에는 이제 종속성이 포함되어 있습니다. 이를 설치하려면 다음 명령을 실행하세요:
pipenv install
이 명령을 실행하면 필요한 Python 버전과 pip 종속성이 모두 설치됩니다.
사용 지침
Pipenv 환경에서 어떤 Python 코드든 실행하려면 먼저 응용 프로그램의 종속성을 기반으로 virtualenv를 시작해야 합니다. Pipenv를 사용하면 이를 실행하는 것은 다음과 같이 간단합니다:
pipenv shell
해당 명령을 실행한 후에 GitLab을 동일한 쉘에서 실행하면 pipenv install로 설치된 Python 및 종속성을 사용합니다.
도움말