In scope of this pull request we add possibility to cache python dependencies. We added cache input parameter to the action. For now, input will accept the following values:

• pip - enable caching for pip dependencies
• pipenv - enable caching for pipenv dependencies

ADR: #247
Related issue: #226

Description

Action will try to search requirements.txt for pip or Pipfile.lock for pipenv files in the repository and throw error if no one is found. The hash of found files will be used as part of cache key (the same approach like actions/cache recommends). The following key cache will be used:

• For pip: setup-python-${{ runner.os }}-pip-${{ hashFiles('') }}
• For pipenv: setup-python-${{ runner.os }}-python-${{resolved-python-version}}-pipenv-${{ hashFiles('') }}

Action will cache:

• Pip (global cache directory retrieved via pip cache dir)
• Pipenv (virtualenv directories $HOME/.virtualenvs for Windows and $HOME/.local/share/virtualenvs for Linux, macOS)

Besides we add cache-dependency-path input. This input will accept an array or regex of dependency files. The field will accept a path (relative to the repository root) to dependency files. If the provided path contains wildcards, the action will search all matching files and calculate a common hash like the ${{ hashFiles('**/requirements-dev.txt') }} YAML construction does.

Example of yml

• For pip

 uses: actions/setup-python@v2
  with:
    python-version: '3.9'
    cache: 'pip'

• For pipenv:

 uses: actions/setup-python@v2
  with:
    python-version: '3.9'
    cache: 'pipenv'

Note:

• It's not breaking change because it requires additional field and nothing changes by default.
• License tests are falling. But we have changes to fix it. We've decided to stay with implementation, because approximately 60 licenses were changed. When changes are reviewed, we will add licenses to the existing pull request.

What's done:

• - Implementation of python's caching
• - Adding tests for python's caching
• - Adding documentation
• - Update licenses