이 작업은 GitHub Actions 사용자에게 다음 기능을 제공합니다.
action.yml 참조
파이썬
steps :
- uses : actions/checkout@v4
- uses : actions/setup-python@v5
with :
python-version : ' 3.13 '
- run : python my_script.py
파이파이
steps :
- uses : actions/checkout@v4
- uses : actions/setup-python@v5
with :
python-version : ' pypy3.10 '
- run : python my_script.py
그랄파이
steps :
- uses : actions/checkout@v4
- uses : actions/setup-python@v5
with :
python-version : ' graalpy-24.0 '
- run : python my_script.py
python-version
입력은 선택 사항입니다. 제공되지 않은 경우 작업은 기본 .python-version
파일에서 버전을 확인하려고 시도합니다. .python-version
파일이 없으면 PATH의 Python 또는 PyPy 버전이 사용됩니다. PATH에 있는 Python 또는 PyPy의 기본 버전은 실행기마다 다르며 예기치 않게 변경될 수 있으므로 항상 python-version
또는 python-version-file
입력을 사용하여 명시적으로 Python 버전을 설정하는 것이 좋습니다.
이 작업은 먼저 로컬 도구 캐시에서 semver 일치를 확인합니다. 도구 캐시에서 특정 버전을 찾을 수 없는 경우 작업은 GitHub 릴리스에서 Python 버전을 다운로드하고 공식 PyPy dist에서 PyPy용 버전을 다운로드하려고 시도합니다.
GitHub 호스팅 실행기에서 로컬로 캐시된 Python 또는 PyPy 버전에 대한 자세한 내용은 GitHub Actions 실행기 이미지를 확인하세요.
python-version
입력은 의미 체계 버전 지정 사양과 일부 특수 버전 표기(예: semver ranges
, xy-dev syntax
등)를 지원합니다. 자세한 예는 고급 사용 가이드의 python-version 입력 사용 섹션을 참조하세요.
architecture
입력을 사용하면 필요한 Python 또는 PyPy 인터프리터 아키텍처( x86
, x64
또는 arm64
를 지정할 수 있습니다. 입력이 지정되지 않은 경우 아키텍처는 기본적으로 호스트 OS 아키텍처로 설정됩니다.
이 작업에는 종속성을 캐싱하고 복원하는 기능이 내장되어 있습니다. 종속성을 캐싱하기 위해 내부적으로 툴킷/캐시를 사용하지만 구성 설정이 덜 필요합니다. 지원되는 패키지 관리자는 pip
, pipenv
및 poetry
입니다. cache
입력은 선택 사항이며 캐싱은 기본적으로 꺼져 있습니다.
이 작업은 기본적으로 리포지토리에서 종속성 파일(pip의 경우 requirements.txt
또는 pyproject.toml
, Pipenv의 경우 Pipfile.lock
, 시의 경우 poetry.lock
)을 검색하고 해당 해시를 캐시 키의 일부로 사용합니다. 입력 cache-dependency-path
여러 종속성 파일이 사용되는 경우 사용하려는 해시에 대해 서로 다른 하위 디렉터리 또는 서로 다른 파일에 있는 경우에 사용됩니다.
pip
의 경우 작업은 전역 캐시 디렉터리를 캐시합니다.pipenv
의 경우 해당 작업은 virtualenv 디렉터리를 캐시합니다.poetry
의 경우 해당 작업은 virtualenv 디렉토리를 캐시합니다(발견된 각 시 프로젝트마다 하나씩).캐싱 pip 종속성:
steps :
- uses : actions/checkout@v4
- uses : actions/setup-python@v5
with :
python-version : ' 3.13 '
cache : ' pip ' # caching pip dependencies
- run : pip install -r requirements.txt
참고: 요구사항.txt 파일이 오랫동안 업데이트되지 않고 최신 버전의 종속성을 사용할 수 있는 경우 복원된 캐시는 사용되지 않으며 이로 인해 총 빌드 시간이 늘어날 수 있습니다.
요구 사항 파일 형식을 사용하면 논리 연산자(예: chardet>=3.0.4)를 사용하여 종속성 버전을 지정하거나 버전 없이 종속성을 지정할 수 있습니다. 이 경우 pip install -r 요구 사항.txt 명령은 항상 사용 가능한 최신 패키지 버전을 설치하려고 시도합니다. 캐시가 사용되도록 하려면 특정 종속성 버전을 고수하고 필요한 경우 수동으로 업데이트하세요.
고급 사용 가이드의 패키지 캐싱 섹션에서 pipenv
및 poetry
에 대한 cache
및 cache-dependency-path
사용 예를 참조하세요.
setup-python
사용setup-python
사용이 프로젝트의 스크립트와 문서는 MIT 라이선스에 따라 공개됩니다.
기여를 환영합니다! 기여자 가이드를 참조하세요.