From ae3b92d1bdb308a10adfe7b8f408e5cc8c30f3f6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 12 Aug 2026 16:22:43 +0200 Subject: [PATCH] docs: update version references to v10.0.0 (#1014) Update `uses: astral-sh/setup-uv@...` references in documentation to `ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0`. Co-authored-by: eifinger --- README.md | 18 +++++++++--------- docs/advanced-version-configuration.md | 18 +++++++++--------- docs/caching.md | 24 ++++++++++++------------ docs/customization.md | 6 +++--- docs/environment-and-tools.md | 16 ++++++++-------- 5 files changed, 41 insertions(+), 41 deletions(-) diff --git a/README.md b/README.md index 913f0ef..2c1fd60 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ Set up your GitHub Actions workflow with a specific version of [uv](https://docs ```yaml - name: Install the latest version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 ``` If you do not specify a version, this action will look for a [required-version](https://docs.astral.sh/uv/reference/settings/#required-version) @@ -42,7 +42,7 @@ Have a look under [Advanced Configuration](#advanced-configuration) for detailed ```yaml - name: Install uv with all available options - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: # The version of uv to install, e.g., "0.5.0", "latest", or "latest-known" (default: searches for version in config files, then latest) version: "" @@ -156,7 +156,7 @@ python 3.13 ``` ```yaml -- uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 +- uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version-file: ".tool-versions" ``` @@ -167,7 +167,7 @@ a warning. ```yaml - name: Install the latest version of uv and set the python version to 3.13t - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: python-version: 3.13t - run: uv pip install --python=3.13t pip @@ -185,7 +185,7 @@ jobs: steps: - uses: actions/checkout@v5 - name: Install the latest version of uv and set the python version - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: python-version: ${{ matrix.python-version }} - name: Test with python ${{ matrix.python-version }} @@ -202,7 +202,7 @@ It also controls where [the venv gets created](#activate-environment), unless `v ```yaml - name: Install uv based on the config files in the working-directory - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: working-directory: my/subproject/dir ``` @@ -244,7 +244,7 @@ For example: - name: Checkout the repository uses: actions/checkout@main - name: Install the latest version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true - name: Test @@ -256,7 +256,7 @@ To install a specific version of Python, use ```yaml - name: Install the latest version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true - name: Install Python 3.12 @@ -275,7 +275,7 @@ output: uses: actions/checkout@main - name: Install the default version of uv id: setup-uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 - name: Print the installed version run: echo "Installed uv version is ${{ steps.setup-uv.outputs.uv-version }}" ``` diff --git a/docs/advanced-version-configuration.md b/docs/advanced-version-configuration.md index e00daa5..605312c 100644 --- a/docs/advanced-version-configuration.md +++ b/docs/advanced-version-configuration.md @@ -6,7 +6,7 @@ This document covers advanced options for configuring which version of uv to ins ```yaml - name: Install the latest version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: "latest" ``` @@ -19,7 +19,7 @@ When `manifest-file` is set, `latest-known` still selects a version from setup-u ```yaml - name: Install the latest version of uv known to setup-uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: "latest-known" ``` @@ -28,7 +28,7 @@ When `manifest-file` is set, `latest-known` still selects a version from setup-u ```yaml - name: Install a specific version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: "0.4.4" ``` @@ -41,21 +41,21 @@ to install the latest version that satisfies the range. ```yaml - name: Install a semver range of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: ">=0.4.0" ``` ```yaml - name: Pinning a minor version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: "0.4.x" ``` ```yaml - name: Install a pep440-specifier-satisfying version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: ">=0.4.25,<0.5" ``` @@ -67,7 +67,7 @@ You can change this behavior using the `resolution-strategy` input: ```yaml - name: Install the lowest compatible version of uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: ">=0.4.0" resolution-strategy: "lowest" @@ -92,7 +92,7 @@ as `UV_PYTHON`. Only a single Python version is supported; multiple fallback ver ```yaml - name: Install uv based on the version defined in pyproject.toml - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version-file: "pyproject.toml" ``` @@ -103,7 +103,7 @@ silently picking up a newer uv until the lockfile is updated. ```yaml - name: Install uv based on the version locked in uv.lock - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version-file: "uv.lock" ``` diff --git a/docs/caching.md b/docs/caching.md index b5c734e..eff1097 100644 --- a/docs/caching.md +++ b/docs/caching.md @@ -23,7 +23,7 @@ The computed cache key is available as the `cache-key` output: ```yaml - name: Setup uv id: setup-uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true - name: Print cache key @@ -53,7 +53,7 @@ You can optionally define a custom cache key suffix. ```yaml - name: Enable caching and define a custom cache key suffix id: setup-uv - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true cache-suffix: "optional-suffix" @@ -92,7 +92,7 @@ changes. If you use relative paths, they are relative to the working directory. ```yaml - name: Define a cache dependency glob - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true cache-dependency-glob: "**/pyproject.toml" @@ -100,7 +100,7 @@ changes. If you use relative paths, they are relative to the working directory. ```yaml - name: Define a list of cache dependency globs - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true cache-dependency-glob: | @@ -110,7 +110,7 @@ changes. If you use relative paths, they are relative to the working directory. ```yaml - name: Define an absolute cache dependency glob - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true cache-dependency-glob: "/tmp/my-folder/requirements*.txt" @@ -118,7 +118,7 @@ changes. If you use relative paths, they are relative to the working directory. ```yaml - name: Never invalidate the cache - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true cache-dependency-glob: "" @@ -131,7 +131,7 @@ By default, the cache will be restored. ```yaml - name: Don't restore an existing cache - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true restore-cache: false @@ -145,7 +145,7 @@ By default, the cache will be saved. ```yaml - name: Don't save the cache after the run - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true save-cache: false @@ -171,7 +171,7 @@ It defaults to `setup-uv-cache` in the `TMP` dir, `D:\a\_temp\setup-uv-cache` on ```yaml - name: Define a custom uv cache path - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: cache-local-path: "/path/to/cache" ``` @@ -188,7 +188,7 @@ If you want to prune the cache before saving it, enable cache pruning with the ` ```yaml - name: Prune the cache before saving it - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true prune-cache: true @@ -207,7 +207,7 @@ To force managed Python installs, set `UV_PYTHON_PREFERENCE=only-managed`. ```yaml - name: Cache Python installs - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true cache-python: true @@ -225,7 +225,7 @@ If you want to ignore this, set the `ignore-nothing-to-cache` input to `true`. ```yaml - name: Ignore nothing to cache - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: enable-cache: true ignore-nothing-to-cache: true diff --git a/docs/customization.md b/docs/customization.md index fd0e4fd..e19a35d 100644 --- a/docs/customization.md +++ b/docs/customization.md @@ -10,7 +10,7 @@ are automatically verified by this action. The sha256 hashes can be found on the ```yaml - name: Install a specific version and validate the checksum - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: version: "0.3.1" checksum: "e11b01402ab645392c7ad6044db63d37e4fd1e745e015306993b07695ea5f9f8" @@ -39,7 +39,7 @@ The `archive_format` field is currently ignored. ```yaml - name: Use a custom manifest file - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: manifest-file: "https://example.com/my-custom-manifest.ndjson" ``` @@ -58,7 +58,7 @@ You can disable this by setting the `add-problem-matchers` input to `false`. ```yaml - name: Install the latest version of uv without problem matchers - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: add-problem-matchers: false ``` diff --git a/docs/environment-and-tools.md b/docs/environment-and-tools.md index 9f0a9f1..d4492c0 100644 --- a/docs/environment-and-tools.md +++ b/docs/environment-and-tools.md @@ -9,7 +9,7 @@ This allows directly using it in later steps: ```yaml - name: Install the latest version of uv and activate the environment - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: activate-environment: true - run: uv pip install pip @@ -20,7 +20,7 @@ By default, the venv is created at `.venv` inside the `working-directory`. You can customize the venv location with `venv-path`, for example to place it in the runner temp directory: ```yaml -- uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 +- uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: activate-environment: true venv-path: ${{ runner.temp }}/custom-venv @@ -51,7 +51,7 @@ are not sufficient, you can provide a custom GitHub token with the necessary per ```yaml - name: Install the latest version of uv with a custom GitHub token - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: github-token: ${{ secrets.CUSTOM_GITHUB_TOKEN }} ``` @@ -69,7 +69,7 @@ input: ```yaml - name: Install the latest version of uv with a custom tool dir - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: tool-dir: "/path/to/tool/dir" ``` @@ -88,7 +88,7 @@ If you want to change this behaviour (especially on self-hosted runners) you can ```yaml - name: Install the latest version of uv with a custom tool bin dir - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: tool-bin-dir: "/path/to/tool-bin/dir" ``` @@ -105,7 +105,7 @@ This action supports expanding the `~` character to the user's home directory fo ```yaml - name: Expand the tilde character - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: cache-local-path: "~/path/to/cache" tool-dir: "~/path/to/tool/dir" @@ -122,7 +122,7 @@ If you want to ignore this, set the `ignore-empty-workdir` input to `true`. ```yaml - name: Ignore empty workdir - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: ignore-empty-workdir: true ``` @@ -146,7 +146,7 @@ This action sets several environment variables that influence uv's behavior and ```yaml - name: Example using environment variables - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0 + uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0 with: python-version: "3.12" tool-dir: "/custom/tool/dir"