workflows

reusable github workflows / actions

job templates

.github/workflows/tox.yml

new in v1.0.0

this job template will install python and invoke tox

parameters

• env: (json list of strings) the list of tox environment names to run
• os: (default: ubuntu-latest) passed through to runs-on
• arch: (json list of strings, default: '[""]') only used on windows to select the python executable
• wheel-tags: (default: false) whether to make a wheels artifact on tags
• submodules: (default: false) new in v1.1.0 passed along to actions/fast-checkout (note: was passed to actions/checkout before v1.4.0)

this action auto-detects python versions via the env name. here are some examples:

• py310: will run with python 3.10
• py310-wat: will also run with python 3.10
• pypy3: will run using pypy 3.11
• wat: will run with python 3.14
• py315: will install nightly 3.15 from deadsnakes and use that

example

jobs:
  main:
    uses: asottile/workflows/.github/workflows/tox.yml@v1.11.0
    with:
      env: '["py310", "py311", "pypy3"]'

actions

.github/actions/latest-git

new in v1.2.0

install the latest version of git

example

    steps:
    - uses: asottile/workflows/.github/actions/latest-git@v1.11.0

.github/actions/fast-checkout

new in v1.3.0

a replacement for actions/checkout that is way less slow

example

    steps:
    - uses: asottile/workflows/.github/actions/fast-checkout@v1.11.0