Set up your GitHub Actions workflow with a specific version of rye.

• Install a version of rye and add it to the path
• Cache the installed version of rye to speed up consecutive runs on self-hosted runners
• Register problem matchers for error output
• Optional: Cache the virtual environment created by rye
• Optional: Verify the checksum of the downloaded rye executable

Example workflow can be found in this repo

- name: Install the latest version of rye
  uses: eifinger/setup-rye@v4

By default this action installs the version defined as default in action.yml. This gets automatically updated in a new release of this action when a new version of rye is released. If you don't want to wait for a new release of this action you can use use version: latest.

- name: Install a specific version
  uses: eifinger/setup-rye@v4
  with:
    version: 'latest'

You can also specify a specific version of rye

- name: Install a specific version
  uses: eifinger/setup-rye@v4
  with:
    version: '0.12.0'

You can also specify a checksum to validate the downloaded file. Checksums of versions 0.12.0 and later are automatically verified by this action. The sha265 hashes can be found on the releases page of the rye repo.

- name: Install a specific version and validate the checksum
  uses: eifinger/setup-rye@v4
  with:
    version: '0.12.0'
    checksum: 'c48d850e90649d868d512f60af67c74aa844d80f951fdb38589220662e709da7'

If you enable caching the virtual environment which gets created by rye under .venv will be cached. This can speed up runs which can reuse the cache by several minutes.

You can optionally define a custom cache key prefix.

- name: Enable caching and define a custom cache key prefix
  id: setup-rye
  uses: eifinger/setup-rye@v4
  with:
    enable-cache: true
    cache-prefix: 'optional-prefix'

When the cache was successfully restored the output cache-hit will be set to true and you can use it in subsequent steps. For the example above you can use it like this:

- name: Do something if the cache was restored
  if: steps.setup-rye.outputs.cache-hit == 'true'
  run: echo "Cache was restored"

If your rye project is not at the root of the repository you can specify the working directory relative to the repository root. This is useful for monorepos.

- name: Enable caching and define a working directory
  uses: eifinger/setup-rye@v4
  with:
    enable-cache: true
    working-directory: 'path/to/rye/project'

If you want to save the cache to a local path you can specify the path with the cache-local-storage-path input. This can be useful if you are on a self hosted runner and want to save time and network traffic.

- name: Enable caching and define a custom cache path
  uses: eifinger/setup-rye@v4
  with:
    enable-cache: true
    cache-local-storage-path: '/path/to/cache'

It is recommended to cleanup the storage path to avoid running out of disk space. One option is to use a cron job to delete files older than 7 days like below.

0 0 * * * find /home/ubuntu/setup-rye-cache -type d -mtime +7 -exec rm -rf {} \;

To avoid hitting the error API rate limit exceeded you can supply a GitHub token with the github-token input.

- name: Install rye and supply a GitHub token
  uses: eifinger/setup-rye@v4
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}

This action downloads rye from the releases of the rye repo and uses the GitHub Actions Toolkit to cache it as a tool to speed up consecutive runs especially on self-hosted runners.

The installed version of rye is then added to the runner path so other steps can just use it by calling rye. To prevent interfering the other rye processes on the same runner RYE_HOME gets set to the repository roots parent and is cleaned up after a workflow run.

No! This action was modelled as a drop-in replacement for actions/setup-python when using rye.

A simple example workflow could look like this:

- name: Checkout the repository
  uses: actions/checkout@v2
- name: Install the latest version of rye
  uses: eifinger/setup-rye@v4
  with:
    enable-cache: true
- name: Sync dependencies
  run: rye sync
- name: Lint
  run: rye lint