This action wraps around actions/setup-python allowing for deprecated CPython versions to be built from source instead of leading to a failure while appearing transparent in all other cases.

• Build and Setup Python
  • Table of contents
  • Basic usage
  • Motivation
  • Guarantees
  • Known limits
  • Performance
  • Security guarantees
  • Inputs
    • allow-build input
  • Outputs
  • FAQ
    • No file in (...) matched to [**/requirements.txt or **/pyproject.toml], make sure you have checked out the target repository
  • Contributing

For a more complete view on the actions see action.yml or look in the Inputs and Outputs sections. In general you could replace the original action with this one and it should already work (all its supported inputs are also supported in this one):

- uses: MatteoH2O1999/setup-python@v4
  with:
    python-version: '3.8'

But if you wish for a more optimized experience you could use inputs exclusive to this action:

- uses: MatteoH2O1999/setup-python@v4
  with:
    python-version: '3.8'
    allow-build: info
    cache-build: true
    cache: pip

While initially this action was meant to guarantee a successful build of all CPython versions 2.7, it has now become too complex to maintain it.

The new objective of this action is to provide a buffer when something gets yanked out by Github, as this will guarantee that if the pair (label, version) works, it will keep working. Older versions may still work, but no effort will be spent in ensuring so.

The objective of this action is to guarantee that for every major Python version starting from 3.7 at least one specific version can be successfully installed on the ...-latest images using the default architecture.

TLDR: If you use the major version specification (3.7 instead of 3.7.5) without specifying the architecture as shown in Basic usage this action is guaranteed to work (hopefully...😉) on all the ...-latest labels.

This action at the moment does not support:

• installing multiple Python versions
• building PyPy from source
• building from source in UNIX systems for a different architecture

This actions tries to but does not guarantee to work on any arbitrary pair (python-version, architecture).

The action's performance depends on the runner OS and on whether Python needs to be built, installed, restored from cache or is already installed:

1. Supported by actions/setup-python
   1. Already installed on runner
      1. ubuntu-latest → ~10s
      2. windows-latest → ~20s
      3. macos-latest → ~10s
   2. Available from actions/python-versions
      1. ubuntu-latest → ~20s
      2. windows-latest → ~1m
      3. macos-latest → ~30s
2. Not supported by actions/setup-python
   1. Already cached
      1. ubuntu-latest → ~20s
      2. windows-latest → ~30s
      3. macos-latest → ~30s
   2. Built from source
      1. ubuntu-latest → ~3m30s
      2. windows-latest → ~25m
      3. macos-latest → ~13m

This action is composite and uses the original actions/setup-python and a custom action MatteoH2O1999/build-and-install-python. Both are referenced by commit hash in order to provide better security: if you use this action using its commit hash it will be safe from future malicious edits to the tags.

This action supports the following inputs (in bold are the names of the exclusive inputs for this action):

This action can apply for different behaviors when it tries to install a CPython version not supported by actions/setup-python:

• error this emulates actions/setup-python and throws an error (thus failing the job) if the Python version cannot be downloaded from actions/python-versions;
• warn(default) this will proceed to build the specified version of CPython but will still throw a warning. This was chosen as the default behavior as the user may not know a deprecated version has been requested;
• info this will build from source and only print to the logs the fact that a specific Python version will be built from source;
• allow same as info but does not even print to logs the fact that CPython will be built from source;
• force this will force Python to be built from source regardless of whether actions/setup-python supports it or not.

This action will emit the following outputs:

This is a byproduct of actions/setup-python. If you wish to cache your pip dependencies, you need to have anywhere in your repository a requirements.txt or a pyproject.toml file. The solution in this case is either creating a blank requirements.txt file or stop caching pip (in order to do so simply remove cache: pip from your .yml file).

This action is pretty much only a wrapper for a javascript action. Any issue you might encounter with this action is probably caused by MatteoH2O1999/build-and-install-python. If you wish to contribute, you should do so there.