Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
cloud-lightning

GitHub Action

Setup Python and Poetry

v0.4.0

Setup Python and Poetry

cloud-lightning

Setup Python and Poetry

Setup a specific version of Python & Poetry with virtual environment caching

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: Setup Python and Poetry

              
  uses: finleyfamily/action-setup-python@v0.4.0
Learn more about this action in finleyfamily/action-setup-python

Choose a version

action-setup-python

A composite GitHub Action that sets up both Python and poetry with virtual environment caching in a single step.

This Action was started because I found myself repeating the same steps over and over again across jobs. Since Actions don't currently support YAML anchors, this was my next best option.

[DISCLAIMER] This Action can and will undergo breaking changes until there is a v1.0.0. There are a few features still lacking from the newly release composite Actions that are needed to improve functionality. The primary feature being support for conditions.

Requirements

  • actions/checkout needs to be run before this Action
  • the virtual environment needs to be created within the project for it to be cached (poetry config --local virtualenvs.in-project true)

Usage

steps:
  - uses: actions/checkout@v2
  - uses: ITProKyle/action-setup-python@v0.1.0 # it is HIGHLY recommended to pin this to a release
    with:
      python-version: 3.9

Inputs

Key Description
architecture The target architecture (x86, x64) of the Python interpreter.The target architecture (x86, x64) of the Python interpreter.
cache-key-suffix Temporary input to allow for slight customization of the cache key until full customization can be provided. This will be removed in the future.
ensure-cache-is-healthy Ensure the cached Python virtual environment is healthy. In most cases, this should be left set to true (default). (non-Windows only)
poetry-check Whether validate the content of the pyproject.toml file and its consistency with the poetry.lock file.
poetry-check-cmd The poetry command to run when checking the lock file (e.g. check). This command was changed in poetry 1.6 (default used by this action). To support older versions of poetry, provide a value for this input.
poetry-install Whether to run poetry install (or the value of poetry-install-cmd). Defaults to true.
poetry-install-args Additional args to pass to poetry install. Defaults to -vvv --remove-untracked
poetry-install-cmd Command for installing poetry project. Can be used to provide a custom install command. The value of poetry-install-args is appended after this. Defaults to poetry install. This is also a check for the existence of a Makefile with a setup-poetry target. If found, using it takes precedence.
poetry-preview Allow install of prerelease versions of Poetry.
poetry-version Poetry version to use. If version is not provided then latest stable version will be used.
python-version Version range or exact version of a Python version to use, using semver version range syntax.
token Used to pull python distributions from actions/python-versions. Since there's a default, this is typically not supplied by the user.

Outputs

Key Description
cache-hit Whether there was a cache hit for the Python virtual environment.
python-version The installed Python version. Useful when given a version range as input.