Skip to content

Commit 67f8535

Browse files
authored
Bump version to 0.5.0 (#2631)
Prepare the 0.5.0 release.
1 parent 4546bef commit 67f8535

8 files changed

Lines changed: 95 additions & 17 deletions

File tree

‎.github/ISSUE_TEMPLATE/bug_report.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ body:
2727

2828
- type: input
2929
attributes:
30-
label: "Version (current: 0.4.14)"
30+
label: "Version (current: 0.5.0)"
3131
description: What version of prek are you using? (see `prek -V`)
3232
placeholder: e.g., prek 0.2.3 (7fe75a86d 2025-09-29)
3333
validations:

‎CHANGELOG.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,83 @@
11
# Changelog
22

3+
## 0.5.0
4+
5+
Released on 2026-08-27.
6+
7+
### Highlights
8+
9+
#### Choose where hook toolchains come from
10+
11+
`language_version` now accepts a source `preference` alongside the version
12+
`request`, letting you control where prek looks for a compatible toolchain when
13+
it creates a hook environment. Use `managed` (the default) or `system` to choose
14+
which source prek tries first while still allowing fallback and downloads. Use
15+
`only-managed` or `only-system` to require one source.
16+
17+
For example, this local Ruff hook requires a Python 3.12 toolchain managed by
18+
prek:
19+
20+
```yaml
21+
repos:
22+
- repo: local
23+
hooks:
24+
- id: ruff
25+
name: ruff
26+
language: python
27+
entry: ruff check
28+
additional_dependencies: [ruff]
29+
language_version:
30+
request: "3.12"
31+
preference: only-managed
32+
```
33+
34+
With `only-managed`, prek reuses a compatible toolchain from its managed store
35+
or downloads one when needed. It never falls back to Python from `PATH`, an OS
36+
package manager, or a version manager, so toolchain selection does not depend on
37+
the developer or CI machine's external environment.
38+
39+
Existing scalar values such as `language_version: "3.12"` continue to work. See
40+
[toolchain management and `language_version`](https://prek.j178.dev/0.5.0/languages/#toolchain-management-and-language_version)
41+
for the full source-selection behavior. ([#2613](https://github.com/j178/prek/pull/2613))
42+
43+
### Breaking changes
44+
45+
The breaking changes in this release are mostly small cleanups, and most users should not be affected.
46+
47+
- Group names can no longer start with `@`. This prefix is now reserved for special group selectors such as the new `@ungrouped` selector. ([#2617](https://github.com/j178/prek/pull/2617))
48+
- `PREK_MAX_CONCURRENCY` has been removed. Use `PREK_CONCURRENT_HOOKS` and `PREK_CONCURRENT_BATCHES` to control hook and per-hook batch concurrency separately. ([#2620](https://github.com/j178/prek/pull/2620))
49+
- The top-level `prek init-template-dir` command has been removed. Use `prek util init-template-dir`, or `prek init-templatedir` for drop-in compatibility with `pre-commit`. ([#2623](https://github.com/j178/prek/pull/2623))
50+
- `prek auto-update` has been removed. Use `prek update`, or `prek autoupdate` for drop-in compatibility with `pre-commit`. ([#2619](https://github.com/j178/prek/pull/2619))
51+
52+
### Enhancements
53+
54+
- Add configurable toolchain source preferences ([#2613](https://github.com/j178/prek/pull/2613))
55+
- Allow explicit `language: python` to opt out of fast-path hooks ([#2608](https://github.com/j178/prek/pull/2608))
56+
- Group `run` and `update` options in CLI help ([#2629](https://github.com/j178/prek/pull/2629))
57+
- Preserve terminal theme contrast for status labels ([#2592](https://github.com/j178/prek/pull/2592))
58+
- Add `@ungrouped` group selector ([#2617](https://github.com/j178/prek/pull/2617))
59+
- Retry uv installation with static musl binary ([#2600](https://github.com/j178/prek/pull/2600))
60+
- Support `{hook_repo}` placeholder in hook `entry` ([#2602](https://github.com/j178/prek/pull/2602))
61+
62+
### Bug fixes
63+
64+
- Expose the git work tree to hooks running outside the git root ([#2579](https://github.com/j178/prek/pull/2579))
65+
- Isolate local hook environment installation ([#2615](https://github.com/j178/prek/pull/2615))
66+
- Preserve hook config deserialization error locations ([#2573](https://github.com/j178/prek/pull/2573))
67+
- Resolve hook log files from their config directory ([#2580](https://github.com/j178/prek/pull/2580))
68+
- Track explicit config paths as absolute paths ([#2574](https://github.com/j178/prek/pull/2574))
69+
70+
### Documentation
71+
72+
- Document prek run architecture ([#2630](https://github.com/j178/prek/pull/2630))
73+
- Publish versioned documentation ([#2626](https://github.com/j178/prek/pull/2626))
74+
75+
### Contributors
76+
77+
- @jeromeheissler
78+
- @gurgeous
79+
- @j178
80+
381
## 0.4.14
482

583
Released on 2026-08-17.

‎Cargo.lock‎

Lines changed: 4 additions & 4 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎Cargo.toml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,17 @@ members = ["crates/*"]
33
resolver = "3"
44

55
[workspace.package]
6-
version = "0.4.14"
6+
version = "0.5.0"
77
edition = "2024"
88
rust-version = "1.96"
99
repository = "https://github.com/j178/prek"
1010
homepage = "https://prek.j178.dev/"
1111
license = "MIT"
1212

1313
[workspace.dependencies]
14-
prek-consts = { path = "crates/prek-consts", version = "0.4.14" }
15-
prek-identify = { path = "crates/prek-identify", version = "0.4.14" }
16-
prek-pty = { path = "crates/prek-pty", version = "0.4.14" }
14+
prek-consts = { path = "crates/prek-consts", version = "0.5.0" }
15+
prek-identify = { path = "crates/prek-identify", version = "0.5.0" }
16+
prek-pty = { path = "crates/prek-pty", version = "0.5.0" }
1717

1818
aho-corasick = { version = "1.1.4" }
1919
annotate-snippets = { version = "0.12.13" }

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ On Linux and macOS:
5959
<!-- --8<-- [start: linux-standalone-install] -->
6060

6161
```bash
62-
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.4.14/prek-installer.sh | sh
62+
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/j178/prek/releases/download/v0.5.0/prek-installer.sh | sh
6363
```
6464

6565
<!-- --8<-- [end: linux-standalone-install] -->
@@ -69,7 +69,7 @@ On Windows:
6969
<!-- --8<-- [start: windows-standalone-install] -->
7070

7171
```powershell
72-
powershell -ExecutionPolicy ByPass -c "irm https://github.com/j178/prek/releases/download/v0.4.14/prek-installer.ps1 | iex"
72+
powershell -ExecutionPolicy ByPass -c "irm https://github.com/j178/prek/releases/download/v0.5.0/prek-installer.ps1 | iex"
7373
```
7474

7575
<!-- --8<-- [end: windows-standalone-install] -->

‎docs/integrations.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,21 +26,21 @@ A common pattern is to copy the binary into your own image:
2626

2727
```dockerfile
2828
FROM debian:bookworm-slim
29-
COPY --from=ghcr.io/j178/prek:0.4.14 /prek /usr/local/bin/prek
29+
COPY --from=ghcr.io/j178/prek:0.5.0 /prek /usr/local/bin/prek
3030
```
3131

3232
If you prefer, you can also run the distroless image directly:
3333

3434
```bash
35-
docker run --rm ghcr.io/j178/prek:0.4.14 --version
35+
docker run --rm ghcr.io/j178/prek:0.5.0 --version
3636
```
3737

3838
### Alpine
3939

4040
The Alpine variant includes `prek`, Git, CA certificates, a shell, and the Alpine package manager.
4141

4242
```bash
43-
docker run --rm ghcr.io/j178/prek:0.4.14-alpine --version
43+
docker run --rm ghcr.io/j178/prek:0.5.0-alpine --version
4444
```
4545

4646
Use `X.Y.Z-alpine3.24` to pin both the prek and Alpine versions, or `alpine3.24` to pin only the
@@ -67,7 +67,7 @@ Loaded 1 attestation from GitHub API
6767

6868
!!! tip
6969

70-
Use a specific version tag (e.g., `ghcr.io/j178/prek:0.4.14`) or image
70+
Use a specific version tag (e.g., `ghcr.io/j178/prek:0.5.0`) or image
7171
digest rather than `latest` for verification.
7272

7373
## GitHub Actions

‎pyproject.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "maturin"
44

55
[project]
66
name = "prek"
7-
version = "0.4.14"
7+
version = "0.5.0"
88
description = "A fast Git hook manager written in Rust, designed as a drop-in alternative to pre-commit, reimagined."
99
authors = [{ name = "j178", email = "[email protected]" }]
1010
requires-python = ">=3.8"

‎uv.lock‎

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)