여러 버전에서 시를 사용하여 Python용 GitHub Actions CI를 구성하는 방법

여러 버전에서 시를 사용하여 Python용 GitHub Actions CI를 구성하는 방법은 무엇입니까?

Poetry를 사용하여 Python 프로젝트를 위한 강력한 GitHub Actions CI 파이프라인을 설정하고 여러 Python 버전에서 테스트하여 호환성과 안정성을 보장하는 방법을 알아보세요.

지속적 통합(CI)은 최신 소프트웨어 개발 워크플로우에서 중요한 부분입니다. Poetry를 사용하여 종속성과 환경을 관리하는 경우 이 가이드는 여러 Python 버전에서 Python 프로젝트를 위한 강력한 GitHub Actions CI 파이프라인을 구성하는 데 도움이 될 것입니다. 실제적인 예를 보려면 이 GitHub 리포지토리(jdevto/python-poetry-hello)의 실제 코드를 참조할 수 있습니다. ?

---

왜 Python 프로젝트에 시를 사용하는가? ?

Poetry는 Python 종속성 관리 및 패키징을 단순화합니다. 다음을 제공합니다:

• 종속성 및 프로젝트 메타데이터를 위한 명확한 pyproject.toml 파일.
• 가상 환경 관리 시스템
• 종속성을 빌드, 게시 및 관리하는 명령

---

여러 버전에서 시를 사용하여 Python용 GitHub 작업 구성

다음은 Python 버전 3.9~3.13에서 Poetry를 사용하여 CI 파이프라인을 자동화하기 위한 완전한 GitHub Actions 워크플로 구성입니다. 이 예에는 세 가지 유형의 트리거가 포함되어 있습니다. 즉, 기본 분기로 푸시, 풀 요청 및 예약된 일일 크론 작업입니다. 자신의 요구 사항에 맞게 이러한 트리거를 조정할 수 있습니다.

name: ci

on:
  push:
    branches:
      - main
  pull_request:
  schedule:
    - cron: 0 12 * * *
  workflow_dispatch:

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
      fail-fast: false

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python-version }}

      - name: Install Poetry
        run: |
          curl -sSL https://install.python-poetry.org | python3 -
          echo "PATH=$HOME/.local/bin:$PATH" >> $GITHUB_ENV

      - name: Install dependencies with Poetry
        run: |
          cd hello-world
          poetry install --with dev

      - name: Set PYTHONPATH to include the source directory
        run: echo "PYTHONPATH=$PWD/hello-world" >> $GITHUB_ENV

      - name: Run tests
        run: |
          cd hello-world
          poetry run pytest --cov=hello-world --cov-report=term-missing

---

워크플로의 주요 단계

1. 결제 코드

actions/checkout@v4 작업은 이후 단계에서 사용할 수 있도록 저장소에서 코드를 가져옵니다.

2. Python 설정

actions/setup-python@v4 작업은 매트릭스 전략을 사용하여 지정된 Python 버전을 설치하므로 여러 Python 버전에서 테스트를 실행할 수 있습니다.

3. 시 설치

스크립트는 공식 설치 방법을 사용하여 최신 버전의 Poetry를 설치하고 PATH에 추가되었는지 확인합니다.

4. 종속성 설치

poetry install --with dev는 개발 종속성을 포함하여 프로젝트의 모든 종속성을 설치합니다.

5. PYTHONPATH 설정

PYTHONPATH 환경 변수는 src 디렉터리를 포함하도록 구성되어 테스트 중에 적절한 모듈 가져오기를 가능하게 합니다.

6. 테스트 실행

poetry run pytest는 --cov=src --cov-report=term-missing을 통해 적용 범위 보고를 활성화하여 프로젝트에 정의된 테스트를 실행합니다.

---

향상된 기능

1. 종속성에 대한 캐싱 추가

작업 속도를 높이기 위해 Poetry 종속성을 캐시할 수 있습니다.

name: ci

on:
  push:
    branches:
      - main
  pull_request:
  schedule:
    - cron: 0 12 * * *
  workflow_dispatch:

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
      fail-fast: false

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python-version }}

      - name: Install Poetry
        run: |
          curl -sSL https://install.python-poetry.org | python3 -
          echo "PATH=$HOME/.local/bin:$PATH" >> $GITHUB_ENV

      - name: Install dependencies with Poetry
        run: |
          cd hello-world
          poetry install --with dev

      - name: Set PYTHONPATH to include the source directory
        run: echo "PYTHONPATH=$PWD/hello-world" >> $GITHUB_ENV

      - name: Run tests
        run: |
          cd hello-world
          poetry run pytest --cov=hello-world --cov-report=term-missing

변경된 사항이 없는 경우 종속성 재설치를 건너뛰려면 종속성을 설치하기 전에 이 단계를 추가하세요.

---

결론

이 GitHub Actions 워크플로를 구성하면 여러 Python 버전에 대한 테스트를 자동화하고 Poetry를 사용하는 Python 프로젝트가 항상 최상의 상태를 유지할 수 있습니다. 이 설정에는 종속성을 설치하고, 테스트를 실행하고, 더 빠른 빌드를 위해 종속성을 캐시하는 단계가 포함됩니다. ?

질문이나 제안사항이 있으면 언제든지 공유해 주세요! ? 더 많은 영감과 작업 예제를 보려면 GitHub 저장소(jdevto/python-poetry-hello)를 방문하세요.

위 내용은 여러 버전에서 시를 사용하여 Python용 GitHub Actions CI를 구성하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!