Skip to content

Commit a5e9cbf

Browse files
authored
docs: update version references to v8.2.0 (#932)
## Summary - update README and docs `uses: astral-sh/setup-uv@...` examples to the v8.2.0 commit SHA - replace stale `v8.1.0` comments with `v8.2.0` Fixes #931 ## Validation - npm ci --ignore-scripts - npm run all
1 parent c5680ec commit a5e9cbf

5 files changed

Lines changed: 39 additions & 39 deletions

File tree

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Set up your GitHub Actions workflow with a specific version of [uv](https://docs
2626

2727
```yaml
2828
- name: Install the latest version of uv
29-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
29+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
3030
```
3131
3232
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
4242

4343
```yaml
4444
- name: Install uv with all available options
45-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
45+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
4646
with:
4747
# The version of uv to install (default: searches for version in config files, then latest)
4848
version: ""
@@ -148,7 +148,7 @@ This will override any python version specifications in `pyproject.toml` and `.p
148148

149149
```yaml
150150
- name: Install the latest version of uv and set the python version to 3.13t
151-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
151+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
152152
with:
153153
python-version: 3.13t
154154
- run: uv pip install --python=3.13t pip
@@ -166,7 +166,7 @@ jobs:
166166
steps:
167167
- uses: actions/checkout@v5
168168
- name: Install the latest version of uv and set the python version
169-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
169+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
170170
with:
171171
python-version: ${{ matrix.python-version }}
172172
- name: Test with python ${{ matrix.python-version }}
@@ -183,7 +183,7 @@ It also controls where [the venv gets created](#activate-environment), unless `v
183183

184184
```yaml
185185
- name: Install uv based on the config files in the working-directory
186-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
186+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
187187
with:
188188
working-directory: my/subproject/dir
189189
```
@@ -225,7 +225,7 @@ For example:
225225
- name: Checkout the repository
226226
uses: actions/checkout@main
227227
- name: Install the latest version of uv
228-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
228+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
229229
with:
230230
enable-cache: true
231231
- name: Test
@@ -237,7 +237,7 @@ To install a specific version of Python, use
237237

238238
```yaml
239239
- name: Install the latest version of uv
240-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
240+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
241241
with:
242242
enable-cache: true
243243
- name: Install Python 3.12
@@ -256,7 +256,7 @@ output:
256256
uses: actions/checkout@main
257257
- name: Install the default version of uv
258258
id: setup-uv
259-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
259+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
260260
- name: Print the installed version
261261
run: echo "Installed uv version is ${{ steps.setup-uv.outputs.uv-version }}"
262262
```

docs/advanced-version-configuration.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ This document covers advanced options for configuring which version of uv to ins
66

77
```yaml
88
- name: Install the latest version of uv
9-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
9+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
1010
with:
1111
version: "latest"
1212
```
@@ -15,7 +15,7 @@ This document covers advanced options for configuring which version of uv to ins
1515
1616
```yaml
1717
- name: Install a specific version of uv
18-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
18+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
1919
with:
2020
version: "0.4.4"
2121
```
@@ -28,21 +28,21 @@ to install the latest version that satisfies the range.
2828
2929
```yaml
3030
- name: Install a semver range of uv
31-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
31+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
3232
with:
3333
version: ">=0.4.0"
3434
```
3535
3636
```yaml
3737
- name: Pinning a minor version of uv
38-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
38+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
3939
with:
4040
version: "0.4.x"
4141
```
4242
4343
```yaml
4444
- name: Install a pep440-specifier-satisfying version of uv
45-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
45+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
4646
with:
4747
version: ">=0.4.25,<0.5"
4848
```
@@ -54,7 +54,7 @@ You can change this behavior using the `resolution-strategy` input:
5454

5555
```yaml
5656
- name: Install the lowest compatible version of uv
57-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
57+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
5858
with:
5959
version: ">=0.4.0"
6060
resolution-strategy: "lowest"
@@ -76,7 +76,7 @@ uv defined as a dependency in `pyproject.toml` or `requirements.txt`.
7676

7777
```yaml
7878
- name: Install uv based on the version defined in pyproject.toml
79-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
79+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
8080
with:
8181
version-file: "pyproject.toml"
8282
```
@@ -87,7 +87,7 @@ silently picking up a newer uv until the lockfile is updated.
8787

8888
```yaml
8989
- name: Install uv based on the version locked in uv.lock
90-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
90+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
9191
with:
9292
version-file: "uv.lock"
9393
```

docs/caching.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The computed cache key is available as the `cache-key` output:
2323
```yaml
2424
- name: Setup uv
2525
id: setup-uv
26-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
26+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
2727
with:
2828
enable-cache: true
2929
- name: Print cache key
@@ -50,7 +50,7 @@ You can optionally define a custom cache key suffix.
5050
```yaml
5151
- name: Enable caching and define a custom cache key suffix
5252
id: setup-uv
53-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
53+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
5454
with:
5555
enable-cache: true
5656
cache-suffix: "optional-suffix"
@@ -89,15 +89,15 @@ changes. If you use relative paths, they are relative to the working directory.
8989

9090
```yaml
9191
- name: Define a cache dependency glob
92-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
92+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
9393
with:
9494
enable-cache: true
9595
cache-dependency-glob: "**/pyproject.toml"
9696
```
9797

9898
```yaml
9999
- name: Define a list of cache dependency globs
100-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
100+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
101101
with:
102102
enable-cache: true
103103
cache-dependency-glob: |
@@ -107,15 +107,15 @@ changes. If you use relative paths, they are relative to the working directory.
107107

108108
```yaml
109109
- name: Define an absolute cache dependency glob
110-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
110+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
111111
with:
112112
enable-cache: true
113113
cache-dependency-glob: "/tmp/my-folder/requirements*.txt"
114114
```
115115

116116
```yaml
117117
- name: Never invalidate the cache
118-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
118+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
119119
with:
120120
enable-cache: true
121121
cache-dependency-glob: ""
@@ -128,7 +128,7 @@ By default, the cache will be restored.
128128

129129
```yaml
130130
- name: Don't restore an existing cache
131-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
131+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
132132
with:
133133
enable-cache: true
134134
restore-cache: false
@@ -142,7 +142,7 @@ By default, the cache will be saved.
142142

143143
```yaml
144144
- name: Don't save the cache after the run
145-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
145+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
146146
with:
147147
enable-cache: true
148148
save-cache: false
@@ -168,7 +168,7 @@ It defaults to `setup-uv-cache` in the `TMP` dir, `D:\a\_temp\setup-uv-cache` on
168168

169169
```yaml
170170
- name: Define a custom uv cache path
171-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
171+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
172172
with:
173173
cache-local-path: "/path/to/cache"
174174
```
@@ -187,7 +187,7 @@ input.
187187

188188
```yaml
189189
- name: Don't prune the cache before saving it
190-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
190+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
191191
with:
192192
enable-cache: true
193193
prune-cache: false
@@ -205,7 +205,7 @@ To force managed Python installs, set `UV_PYTHON_PREFERENCE=only-managed`.
205205

206206
```yaml
207207
- name: Cache Python installs
208-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
208+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
209209
with:
210210
enable-cache: true
211211
cache-python: true
@@ -223,7 +223,7 @@ If you want to ignore this, set the `ignore-nothing-to-cache` input to `true`.
223223

224224
```yaml
225225
- name: Ignore nothing to cache
226-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
226+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
227227
with:
228228
enable-cache: true
229229
ignore-nothing-to-cache: true

docs/customization.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ are automatically verified by this action. The sha256 hashes can be found on the
1010

1111
```yaml
1212
- name: Install a specific version and validate the checksum
13-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
13+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
1414
with:
1515
version: "0.3.1"
1616
checksum: "e11b01402ab645392c7ad6044db63d37e4fd1e745e015306993b07695ea5f9f8"
@@ -39,7 +39,7 @@ The `archive_format` field is currently ignored.
3939

4040
```yaml
4141
- name: Use a custom manifest file
42-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
42+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
4343
with:
4444
manifest-file: "https://example.com/my-custom-manifest.ndjson"
4545
```
@@ -58,7 +58,7 @@ You can disable this by setting the `add-problem-matchers` input to `false`.
5858

5959
```yaml
6060
- name: Install the latest version of uv without problem matchers
61-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
61+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
6262
with:
6363
add-problem-matchers: false
6464
```

docs/environment-and-tools.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This allows directly using it in later steps:
99

1010
```yaml
1111
- name: Install the latest version of uv and activate the environment
12-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
12+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
1313
with:
1414
activate-environment: true
1515
- run: uv pip install pip
@@ -20,7 +20,7 @@ By default, the venv is created at `.venv` inside the `working-directory`.
2020
You can customize the venv location with `venv-path`, for example to place it in the runner temp directory:
2121

2222
```yaml
23-
- uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
23+
- uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
2424
with:
2525
activate-environment: true
2626
venv-path: ${{ runner.temp }}/custom-venv
@@ -51,7 +51,7 @@ are not sufficient, you can provide a custom GitHub token with the necessary per
5151

5252
```yaml
5353
- name: Install the latest version of uv with a custom GitHub token
54-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
54+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
5555
with:
5656
github-token: ${{ secrets.CUSTOM_GITHUB_TOKEN }}
5757
```
@@ -69,7 +69,7 @@ input:
6969

7070
```yaml
7171
- name: Install the latest version of uv with a custom tool dir
72-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
72+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
7373
with:
7474
tool-dir: "/path/to/tool/dir"
7575
```
@@ -88,7 +88,7 @@ If you want to change this behaviour (especially on self-hosted runners) you can
8888

8989
```yaml
9090
- name: Install the latest version of uv with a custom tool bin dir
91-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
91+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
9292
with:
9393
tool-bin-dir: "/path/to/tool-bin/dir"
9494
```
@@ -105,7 +105,7 @@ This action supports expanding the `~` character to the user's home directory fo
105105

106106
```yaml
107107
- name: Expand the tilde character
108-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
108+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
109109
with:
110110
cache-local-path: "~/path/to/cache"
111111
tool-dir: "~/path/to/tool/dir"
@@ -122,7 +122,7 @@ If you want to ignore this, set the `ignore-empty-workdir` input to `true`.
122122

123123
```yaml
124124
- name: Ignore empty workdir
125-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
125+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
126126
with:
127127
ignore-empty-workdir: true
128128
```
@@ -145,7 +145,7 @@ This action sets several environment variables that influence uv's behavior and
145145

146146
```yaml
147147
- name: Example using environment variables
148-
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
148+
uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
149149
with:
150150
python-version: "3.12"
151151
tool-dir: "/custom/tool/dir"

0 commit comments

Comments
 (0)