Considerations for caching Poetry in GHA

[Hasenpfote]

GitHub Actions で Poetry 自身のキャッシュを行うための考察.

動機

1. 時間
   GHA で Lint や Test の度に Poetry を用意する必要がある.
   準備をするのにそれなりの時間を要するため, Poetry 自身をキャッシュできるか考察をする.
   snok/install-poetry@v1 で実現できなかったことにも起因する.
2. 制限
   根本的には Included storage and minutes

対象

• OS は Linux / Windows / macOS
• 特に指定がなければ Poetry (1.3.1)
• actions/cache@v3

話題

• POETRY_HOME を指定することで起きる不具合
• Poetry のローカルキャッシュ
• Windows 上でシンボリックリンク復元に問題がある
• Windows 上で poetry run tox - e py が意図しないバージョンを参照する

外部の問題

• Poetry (1.3.1) でWindows に POETRY_HOME を指定すると動作が怪しい
• actions/cache@v3 の Windows におけるシンボリックリンク復元動作が怪しい

成果物

• Draft - 1
• Draft - 2
• Draft - 3
• Draft - 4
• Draft - 5

[Hasenpfote]

Draft - 1

正常に動作することを確認済み.

機能

• Linux / macOS / Windows で Poetry をキャッシュし再利用可能
• Poetry が生成する仮想環境をキャッシュし再利用可能

YAML

name: Draft - 1

on: workflow_dispatch

permissions:
  contents: read

jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        python-version: ['3.7', '3.8']
        os: [ubuntu-20.04, macos-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v3

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

      - name: Make cache paths
        id: make-cache-paths
        shell: bash
        run: |
          if [ "$RUNNER_OS" == "Windows" ]; then
            PATH1='~\AppData\Roaming\pypoetry'
            PATH2='~\AppData\Roaming\Python\Scripts'
            echo 'CACHE_PATHS<<EOF' >> $GITHUB_ENV
            echo -e "${PATH1}\n${PATH2}" >> $GITHUB_ENV
            echo 'EOF' >> $GITHUB_ENV
          else
            PATH='~/.local'
            echo "CACHE_PATHS=${PATH}" >> $GITHUB_ENV
          fi

      - name: Load cached Poetry installation
        id: cached-poetry
        uses: actions/cache@v3
        with:
          path: |
            ${{ env.CACHE_PATHS }}
          key: poetry-${{ matrix.os }}-python-${{ matrix.python-version }}

      - name: Install Poetry for Linux/macOS
        if: runner.os != 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: bash
        env:
          POETRY_HOME: ~/.local
        run: |
          curl -sSL https://install.python-poetry.org | python3 -

      - name: Install Poetry for Windows
        if: runner.os == 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: pwsh
        run: |
          (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

      - name: Add paths for macOS
        if: runner.os == 'macOS'
        shell: bash
        run: |
          echo "$HOME/.local/bin" >> $GITHUB_PATH

      - name: Add paths for Windows
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          Add-Content $env:GITHUB_PATH "$env:APPDATA\pypoetry\venv\Scripts"

      - name: Configure Poetry
        run: |
          poetry config virtualenvs.in-project true

      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v3
        with:
          path: .venv
          key: venv-${{ matrix.os }}-python-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}

      - name: Install dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: poetry install --no-interaction --no-root --with dev

      - name: Install project
        run: poetry install --no-interaction --only-root

      - name: Get the environment name for Tox
        id: vars
        shell: python
        run: |
          import os
          with open(os.environ['GITHUB_OUTPUT'], 'a') as fh:
              value = ''.join(str(${{ matrix.python-version }}).split('.', 2)[0:2])
              print(f'env=py{value}', file=fh)

      - name: Test with pytest
        run: |
          #poetry run tox -e py # This is not possible on Windows.
          poetry run tox -e ${{ steps.vars.outputs.env }}

備考

for Linux

基本的には何もしなくてもキャッシュ機構が利用可能.

for macOS

パスを通しておく必要がある.

      - name: Add paths for macOS
        if: runner.os == 'macOS'
        shell: bash
        run: |
          echo "$HOME/.local/bin" >> $GITHUB_PATH  

for Windows

POETRY_HOME を指定すると挙動が怪しくなるので, ここでは Poetry のデフォルト動作に任せた.
インストール完了時に

とパスを通すように促されるが, C:\Users\runneradmin\AppData\Roaming\Python\Scripts はキャッシュからの復元時には動作しない.
常時動作をさせるには, 次のように C:\Users\runneradmin\AppData\Roaming\pypoetry\venv\Scripts を指定する.

      - name: Add paths for Windows
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          Add-Content $env:GITHUB_PATH "$env:APPDATA\pypoetry\venv\Scripts"

その他

• shell の使い分け
  Linux / macOS は bash で特に問題はない.
  Windows は止めたほうがよいかも.
  Tox 内で allowlist_externals = poetry で上位の poetry を利用しようとした際に
  環境変数に格納されるパスが POSIX-style になり Tox が認識しなくなった.
• Tox の実行
  Linux / macOS は poetry run tox -e py で実行が可能.
  Windows は...
• キャッシュするパス
  ~\AppData\Local\pypoetry は省いても動作に支障なし.
  [2022/12/24] 分量が多いので話題をまとめる.

課題

• Windows のキャッシュ対象は依存度が高すぎる
  POETRY_HOME を指定した際の挙動を考察する必要がある.

[Hasenpfote]

[2022/12/24] 指定自体に問題はなさそうである.

POETRY_HOME を指定することで起きる不具合

キャッシュ復元時のシンボリックリンクの作成で失敗

Windows で POETRY_HOME を指定すると失敗する例のひとつ.

• POETRY_HOME: ~\.local にするとキャッシュの復元時にシンボリックリンクの作成で失敗
• POETRY_HOME: ~\local も同様
• POETRY_HOME: C:\Users\runneradmin\.local も同様

関連がありそうな issue

• How to install Poetry on Windows so that it becomes portable? #6875
• How to install Poetry on Windows so that it becomes portable? #7035
  

デフォルトとは異なる POETRY_HOME 指定時のディレクトリ構造

[Hasenpfote]

Draft - 2

正常に動作することを確認済み.

機能

• Linux / macOS / Windows で Poetry をキャッシュし再利用可能
• Poetry が生成する仮想環境をキャッシュし再利用可能
• 各種設定を matrix に移行

YAML

name: Draft - 2

on: workflow_dispatch

permissions:
  contents: read

jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-20.04, macos-latest, windows-latest]
        python-version: ['3.7', '3.8']
        include:
          - os: ubuntu-20.04
            poetry_home: ~/.local
            poetry_path: ''
            poetry_cache_paths: ~/.local
          - os: macos-latest
            poetry_home: ~/.local
            poetry_path: ${HOME}/.local/bin
            poetry_cache_paths: ~/.local
          - os: windows-latest
            poetry_home: ''
            poetry_path: ${APPDATA}\pypoetry\venv\Scripts
            poetry_cache_paths: |
              ~\AppData\Roaming\pypoetry
              ~\AppData\Roaming\Python\Scripts
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v3

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

      - name: Load cached Poetry installation
        id: cached-poetry
        uses: actions/cache@v3
        with:
          path: ${{ matrix.poetry_cache_paths }}
          key: poetry-${{ matrix.os }}-python-${{ matrix.python-version }}

      - name: Install Poetry for Linux/macOS
        if: runner.os != 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: bash
        env:
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          curl -sSL https://install.python-poetry.org | python3 -

      - name: Install Poetry for Windows
        if: runner.os == 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: pwsh
        env:
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

      - name: Add Poetry to the PATH environment variable
        if: matrix.poetry_path != ''
        shell: bash
        run: |
          echo "${{ matrix.poetry_path }}" >> $GITHUB_PATH

      - name: Configure Poetry
        run: |
          poetry config virtualenvs.in-project true

      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v3
        with:
          path: .venv
          key: venv-${{ matrix.os }}-python-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}

      - name: Install dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: poetry install --no-interaction --no-root --with dev

      - name: Install project
        run: poetry install --no-interaction --only-root

      - name: Get the environment name for Tox
        id: vars
        shell: python
        run: |
          import os
          with open(os.environ['GITHUB_OUTPUT'], 'a') as fh:
              value = ''.join(str(${{ matrix.python-version }}).split('.', 2)[0:2])
              print(f'env=py{value}', file=fh)

      - name: Test with pytest
        run: |
          #poetry run tox -e py # This is not possible on Windows.
          poetry run tox -e ${{ steps.vars.outputs.env }}

備考

その他

[Hasenpfote]

Poetry のローカルキャッシュ

Poetry 自身のキャッシュには含めなくても動作に支障はなし.
ローカルの Windows 機で確認したところ, 容量が 500MB 超と表示される.
GHA の場合はそこまで肥大化はしないと思われるが, 制限に影響しそうではある.

設定一覧

for Linux

POETRY_HOME: ~/.local

for macOS

POETRY_HOME: ~/.local

for Windows

POETRY_HOME:

キャッシュサイズの遷移

非常に小さいプロジェクトの初回と次回起動の終了時に計測したサイズ.

for Linux

初回起動の終了時

次回起動の終了時

for macOS

初回起動の終了時

次回起動の終了時

for Windows

初回起動の終了時

次回起動の終了時

[Hasenpfote]

Draft - 3

正常に動作することを確認済み.

Draft - 2 をベースに各 OS で Poetry のデフォルトインストールを実施.

機能

• Linux / macOS / Windows で Poetry をキャッシュし再利用可能
• Poetry が生成する仮想環境をキャッシュし再利用可能
• 各種設定を matrix に移行
• Poetry のデフォルトインストールに準拠

YAML

name: Draft - 3

on: workflow_dispatch

permissions:
  contents: read

jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-20.04, macos-latest, windows-latest]
        python-version: ['3.7', '3.8']
        include:
          - os: ubuntu-20.04
            poetry_home: ''
            poetry_path: ''
            poetry_cache_paths: |
              ~/.local/share/pypoetry
              ~/.local/bin/poetry
          - os: macos-latest
            poetry_home: ''
            poetry_path: ${HOME}/.local/bin
            poetry_cache_paths: |
              ~/Library/Application Support/pypoetry
              ~/.local/bin/poetry
          - os: windows-latest
            poetry_home: ''
            poetry_path: ${APPDATA}\pypoetry\venv\Scripts
            poetry_cache_paths: |
              ~\AppData\Roaming\pypoetry
              ~\AppData\Roaming\Python\Scripts\poetry.exe
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v3

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

      - name: Load cached Poetry installation
        id: cached-poetry
        uses: actions/cache@v3
        with:
          path: ${{ matrix.poetry_cache_paths }}
          key: poetry-${{ matrix.os }}-python-${{ matrix.python-version }}

      - name: Install Poetry for Linux/macOS
        if: runner.os != 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: bash
        env:
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          curl -sSL https://install.python-poetry.org | python3 -

      - name: Install Poetry for Windows
        if: runner.os == 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: pwsh
        env:
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

      - name: Add Poetry to the PATH environment variable
        if: matrix.poetry_path != ''
        shell: bash
        run: |
          echo "${{ matrix.poetry_path }}" >> $GITHUB_PATH

      - name: Configure Poetry
        run: |
          poetry config virtualenvs.in-project true

      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v3
        with:
          path: .venv
          key: venv-${{ matrix.os }}-python-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}

      - name: Install dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: poetry install --no-interaction --no-root --with dev

      - name: Install project
        run: poetry install --no-interaction --only-root

      - name: Get the environment name for Tox
        id: vars
        shell: python
        run: |
          import os
          with open(os.environ['GITHUB_OUTPUT'], 'a') as fh:
              value = ''.join(str(${{ matrix.python-version }}).split('.', 2)[0:2])
              print(f'env=py{value}', file=fh)

      - name: Test with pytest
        run: |
          #poetry run tox -e py # This is not possible on Windows.
          poetry run tox -e ${{ steps.vars.outputs.env }}

備考

• Windows のみ Poetry のフルパスが必要
  actions/cache@v3 のシンボリックリンク復元に何か問題がある可能性が高い.
  本例ではフルパスとすることで問題を回避することが可能なので様子見をする.

その他

適用パターン.

Poetry のデフォルトインストールに準拠

        include:
          - os: ubuntu-20.04
            poetry_home: ''
            poetry_path: ''
            poetry_cache_paths: |
              ~/.local/share/pypoetry
              ~/.local/bin/poetry
          - os: macos-latest
            poetry_home: ''
            poetry_path: ${HOME}/.local/bin
            poetry_cache_paths: |
              ~/Library/Application Support/pypoetry
              ~/.local/bin/poetry
          - os: windows-latest
            poetry_home: ''
            poetry_path: ${APPDATA}\pypoetry\venv\Scripts
            poetry_cache_paths: |
              ~\AppData\Roaming\pypoetry
              ~\AppData\Roaming\Python\Scripts\poetry.exe

snok/install-poetry@v1 のデフォルト設定風

        include:
          - os: ubuntu-20.04
            poetry_home: ''
            poetry_path: ''
            poetry_cache_paths: |
              ~/.local/share/pypoetry
              ~/.local/bin/poetry
          - os: macos-latest
            poetry_home: ~/.local
            poetry_path: ${HOME}/.local/bin
            poetry_cache_paths: |
              ~/.local/VERSION
              ~/.local/bin/poetry
              ~/.local/venv
          - os: windows-latest
            poetry_home: ~\.local
            poetry_path: ${USERPROFILE}\.local\venv\Scripts
            poetry_cache_paths: |
              ~\.local\VERSION
              ~\.local\venv

[Hasenpfote]

Windows 上でシンボリックリンク復元に問題がある

Draft - 3 をベースに POETRY_HOME: ~\.local で再考.

シンボリックリンクの復元に失敗する例

          - os: windows-latest
            poetry_home: ~\.local
            poetry_path: ${USERPROFILE}\.local\venv\Scripts
            poetry_cache_paths: |
              ~\.local\VERSION
              ~\.local\bin\poetry.exe
              ~\.local\venv

シンボリックリンクの復元を回避する例

          - os: windows-latest
            poetry_home: ~\.local
            poetry_path: ${USERPROFILE}\.local\venv\Scripts
            poetry_cache_paths: |
              ~\.local\VERSION
              #~\.local\bin\poetry.exe
              ~\.local\venv

備考

POETRY_HOME を指定の件は消えて, actions/cache@v3 の問題が濃厚になった.
[2022/12/27]

• Unable to restore symlinks from cache on Windows #1043
• Cache compression - cross OS support #984

[Hasenpfote]

Draft - 4

正常に動作することを確認済み.
Draft - 3 をベースに Tox 実行コマンドを修正.

機能

• Linux / macOS / Windows で Poetry をキャッシュし再利用可能
• Poetry が生成する仮想環境をキャッシュし再利用可能
• 各種設定を matrix に移行
• Poetry のデフォルトインストールに準拠
• Poetry のバージョンを指定可能

YAML

name: Draft - 4

on: workflow_dispatch

permissions:
  contents: read

jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-20.04, macos-latest, windows-latest]
        python-version: ['3.7', ]
        include:
          - os: ubuntu-20.04
            poetry_version: '1.3.1'
            poetry_home: ''
            poetry_path: ''
            poetry_cache_paths: |
              ~/.local/share/pypoetry
              ~/.local/bin/poetry
          - os: macos-latest
            poetry_version: '1.3.1'
            poetry_home: ''
            poetry_path: ${HOME}/.local/bin
            poetry_cache_paths: |
              ~/Library/Application Support/pypoetry
              ~/.local/bin/poetry
          - os: windows-latest
            poetry_version: '1.3.1'
            poetry_home: ''
            poetry_path: ${APPDATA}\pypoetry\venv\Scripts
            poetry_cache_paths: |
              ~\AppData\Roaming\pypoetry
              ~\AppData\Roaming\Python\Scripts\poetry.exe
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v3

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

      - name: Load cached Poetry installation
        id: cached-poetry
        uses: actions/cache@v3
        with:
          path: ${{ matrix.poetry_cache_paths }}
          key: temp-poetry-${{ matrix.os }}-python-${{ matrix.python-version }}

      - name: Install Poetry for Linux/macOS
        if: runner.os != 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: bash
        env:
          POETRY_VERSION: ${{ matrix.poetry_version }}
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          curl -sSL https://install.python-poetry.org | python3 -

      - name: Install Poetry for Windows
        if: runner.os == 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: pwsh
        env:
          POETRY_VERSION: ${{ matrix.poetry_version }}
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

      - name: Add Poetry to the PATH environment variable
        if: matrix.poetry_path != ''
        shell: bash
        run: |
          echo "${{ matrix.poetry_path }}" >> $GITHUB_PATH
  
      - name: Configure Poetry
        run: |
          poetry config virtualenvs.in-project true

      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v3
        with:
          path: .venv
          key: temp-venv-${{ matrix.os }}-python-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}

      - name: Install dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: poetry install --no-interaction --no-root --with dev

      - name: Install project
        run: poetry install --no-interaction --only-root

      - name: Test with pytest
        shell: bash
        run: |
          if [ $RUNNER_OS == 'Windows' ]; then
            # Avoid referencing the wrong Python version.
            VER='${{ matrix.python-version }}'
            ARR=(${VER//./ })
            poetry run tox -e "py${ARR[0]}${ARR[1]}"
          else
            poetry run tox -e py
          fi

備考

問題点の整理をすると, POETRY_HOME 指定の有無に関係なく
actions/cache@v3 がキャッシュを復元する際にシンボリックリンクが作成できずに失敗する.
Windows 時のシンボリックリンク復元問題 に帰結する.

[Hasenpfote]

Windows 上で poetry run tox -e py が意図しないバージョンを参照する

Managing environments によると

By default, Poetry will try to use the Python version used during Poetry’s installation to create the virtual environment for the current project.

なので Linux では正常な動作となっている.

問題点

一方で Windows は


Poetry で使う仮想環境が 3.11 であることを示している.

この異常な動作の根本原因は, Linux/maxOS には存在しない異物である Python Launcher for Windows

対処方法

poetry install の前に poetry env use で明示的に指定をする.

      - name: Set the environment used by Poetry on Windows 1/2
        if: runner.os == 'Windows' && steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        id: py
        shell: bash
        run: |
          VER='${{ matrix.python-version }}'
          ARR=(${VER//./ })
          echo "tag=${ARR[0]}.${ARR[1]}" >> $GITHUB_OUTPUT

      - name: Set the environment used by Poetry on Windows 2/2
        if: runner.os == 'Windows' && steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        env:
          PY_PYTHON: ${{ steps.py.outputs.tag }}
        run: |
          poetry env use py

      - name: Install dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: |
          poetry install --no-interaction --no-root --with dev

[Hasenpfote]

Draft - 5

正常に動作することを確認済み.
Draft - 4 をベースに Windows 上での不具合を修正.

機能

• Linux / macOS / Windows で Poetry をキャッシュし再利用可能
• Poetry が生成する仮想環境をキャッシュし再利用可能
• 各種設定を matrix に移行
• Poetry のデフォルトインストールに準拠
• Poetry のバージョンを指定可能
• Windows 上で正しい仮想環境を作成

YAML

name: Draft - 5

on: workflow_dispatch

permissions:
  contents: read

jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-20.04, macos-latest, windows-latest]
        python-version: ['3.7', ]
        poetry_version: ['1.3.1']
        include:
          - os: ubuntu-20.04
            poetry_home: ''
            poetry_path: ''
            poetry_cache_paths: |
              ~/.local/share/pypoetry
              ~/.local/bin/poetry
          - os: macos-latest
            poetry_home: ''
            poetry_path: ${HOME}/.local/bin
            poetry_cache_paths: |
              ~/Library/Application Support/pypoetry
              ~/.local/bin/poetry
          - os: windows-latest
            poetry_home: ''
            #poetry_path: ${APPDATA}\Python\Scripts
            poetry_path: ${APPDATA}\pypoetry\venv\Scripts
            poetry_cache_paths: |
              ~\AppData\Roaming\pypoetry
              ~\AppData\Roaming\Python\Scripts\poetry.exe

    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v3

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

      - name: Load cached Poetry installation
        id: cached-poetry
        uses: actions/cache@v3
        with:
          path: ${{ matrix.poetry_cache_paths }}
          key: temp-0-poetry-${{ matrix.poetry_version }}-${{ matrix.os }}-python-${{ matrix.python-version }}

      - name: Install Poetry for Linux/macOS
        if: runner.os != 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: bash
        env:
          POETRY_VERSION: ${{ matrix.poetry_version }}
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          curl -sSL https://install.python-poetry.org | python3 -

      - name: Install Poetry for Windows
        if: runner.os == 'Windows' && steps.cached-poetry.outputs.cache-hit != 'true'
        shell: pwsh
        env:
          POETRY_VERSION: ${{ matrix.poetry_version }}
          POETRY_HOME: ${{ matrix.poetry_home }}
        run: |
          (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

      - name: Add Poetry to the PATH environment variable
        if: matrix.poetry_path != ''
        shell: bash
        run: |
          echo "${{ matrix.poetry_path }}" >> $GITHUB_PATH
  
      - name: Configure Poetry
        run: |
          poetry config virtualenvs.in-project true

      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v3
        with:
          path: .venv
          key: temp-0-venv-${{ matrix.os }}-python-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}

      - name: Set the environment used by Poetry on Windows 1/2
        if: runner.os == 'Windows' && steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        id: py
        shell: bash
        run: |
          VER='${{ matrix.python-version }}'
          ARR=(${VER//./ })
          echo "tag=${ARR[0]}.${ARR[1]}" >> $GITHUB_OUTPUT

      - name: Set the environment used by Poetry on Windows 2/2
        if: runner.os == 'Windows' && steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        env:
          PY_PYTHON: ${{ steps.py.outputs.tag }}
        run: |
          poetry env use py

      - name: Install dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: |
          poetry install --no-interaction --no-root --with dev

      - name: Install project
        run: |
          poetry install --no-interaction --only-root

      - name: Test with pytest
        run: |
          poetry run tox -e py

備考