ruby: put resolved Ruby's bin dir on `$PATH` for `gem` invocations by xiaoyanli-lyft · Pull Request #2021 · j178/prek

xiaoyanli-lyft · 2026-04-27T17:57:08Z

Summary

build_gemspec, resolve_gems, install_single_gem, and install_gems_sequential in crates/prek/src/languages/ruby/gem.rs all spawn <ruby> -S gem .... Ruby's -S flag searches $PATH for the named script.

The rv-ruby tarballs that prek auto-downloads ship gem next to ruby in the same bin/ directory, but prek wasn't putting that directory on $PATH for these child commands. In environments without a system Ruby on PATH (e.g. a vanilla Docker image / CI container), the -S lookup fails and Ruby aborts with:

/<PREK_HOME>/tools/ruby/<version>/bin/ruby: No such file or directory -- gem (LoadError)

The first place this trips is build_gemspec (called from Ruby::install before install_gems), so the user-visible failure is Failed to install hook ...: Failed to build gemspecs. Once that's worked around, gem install --explain would fail identically — same root cause for all four call sites.

This is distinct from #2006 / #2017, which fixed missing gems/bin/ruby shim used at hook run time. The bug here is at hook install time and is not mitigated by 0.3.11 (gem.rs is unchanged across v0.3.10..v0.3.11).

Reproduction repo / context: filed as a separate issue with the full repro alongside this PR.

Fix

Prepend the resolved Ruby's bin dir to $PATH for every ruby -S gem invocation:

New ruby_path_env(&RubyResult) -> Result<OsString> helper that uses prek_consts::prepend_paths (same helper used by Ruby::run).
gem_env now takes &RubyResult in addition to gem_home and sets PATH alongside the existing GEM_HOME / BUNDLE_* / MAKEFLAGS env. Returns Result so the prepend_paths join error can propagate (vanishingly rare in practice).
build_gemspec doesn't have a GEM_HOME to set so it doesn't use gem_env, but it sets PATH directly via the same helper.

Test plan

cargo fmt --check -p prek — clean
cargo clippy -p prek --all-targets -- -D warnings — clean
cargo test -p prek --bin prek — 400 passed; 0 failed (existing unit tests, including all five languages::ruby::gem::tests::*)
New integration test: languages::ruby::auto_download_gem_install_without_gem_on_path (CI-only, mirrors the existing auto_download gating). It:
- pins language_version: '3.2.9' to force prek to auto-download Ruby via rv-ruby (and asserts a tools/ruby/3.2.9* directory exists after the run);
- drops a .gemspec into the local repo so build_gemspec runs;
- sets additional_dependencies: ["webrick"] so resolve_gems (gem install --explain) and install_single_gem (gem install) run;
- scrubs ruby and gem from $PATH via the existing remove_bin_from_path helper, so ruby -S gem ... only resolves if the resolved Ruby's bin dir is prepended (i.e. the test would have failed before this fix with the LoadError quoted above).

The pre-existing auto_download test only ran ruby --version and never hit gem; gemspec_workflow used language_version: system and so picked gem up from the system PATH. The new test combines auto-download + gem operations + scrubbed PATH to lock the regression in.

Manual verification of the failure mode (without this fix)

In a container with no system Ruby:

default_language_version:
    ruby: 3.2.1
repos:
  - repo: https://github.com/jumanjihouse/pre-commit-hooks
    rev: 3.0.0
    hooks:
      - id: rubocop

prek install-hooks
# error: Failed to install hook `rubocop`
#   caused by: Failed to build gemspecs
#   caused by: Command `gem build` exited with an error:
#   /.../tools/ruby/3.2.1/bin/ruby: No such file or directory -- gem (LoadError)

With this patch, prek prepends <ruby_prefix>/bin to $PATH, ruby -S gem resolves, and the install proceeds.

`build_gemspec`, `resolve_gems`, `install_single_gem` and `install_gems_sequential` all spawn `<ruby> -S gem ...`. Ruby's `-S` flag searches `$PATH` for the named script. The rv-ruby tarballs that prek auto-downloads ship `gem` next to `ruby` in the same `bin/` directory, but prek wasn't putting that directory on `$PATH` for these child commands. In environments without a system Ruby on `PATH` (e.g. a vanilla Docker image), the `-S` lookup fails and Ruby aborts with: /<PREK_HOME>/tools/ruby/<version>/bin/ruby: No such file or directory -- gem (LoadError) Prepend the resolved Ruby's bin dir to `$PATH` for every `ruby -S gem` invocation. `gem_env` now also takes the resolved `RubyResult` and sets `PATH`; `build_gemspec` (which doesn't use `gem_env` since it has no `GEM_HOME` to set) sets `PATH` directly via the same helper. Made-with: Cursor

codecov · 2026-04-27T17:59:01Z

Codecov Report

❌ Patch coverage is 93.33333% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 92.22%. Comparing base (6b9db86) to head (e2f02fe).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
crates/prek/src/languages/ruby/gem.rs	93.33%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2021      +/-   ##
==========================================
+ Coverage   92.19%   92.22%   +0.03%     
==========================================
  Files         117      117              
  Lines       23781    23790       +9     
==========================================
+ Hits        21924    21940      +16     
+ Misses       1857     1850       -7

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copilot

Pull request overview

Fixes Ruby hook install-time failures when prek uses an auto-downloaded rv-ruby toolchain by ensuring ruby -S gem ... can actually find the bundled gem script (which Ruby locates via $PATH).

Changes:

Add a ruby_path_env helper to prepend the resolved Ruby toolchain’s bin/ directory to PATH.
Apply the computed PATH to all ruby -S gem ... invocation sites (including build_gemspec and the shared gem_env helper).

prek-ci-bot · 2026-04-27T18:05:29Z

📦 Cargo Bloat Comparison

Binary size change: -0.77% (26.0 MiB → 25.8 MiB)

Expand for cargo-bloat output

Head Branch Results

 File  .text     Size             Crate Name
 1.3%   2.6% 332.0KiB        aws_lc_sys aws_lc_0_39_1_aes_gcm_encrypt_avx512
 1.3%   2.6% 332.0KiB        aws_lc_sys aws_lc_0_39_1_aes_gcm_decrypt_avx512
 0.3%   0.7%  84.0KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.7%  82.2KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.2%   0.5%  61.1KiB             prek? <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  56.8KiB              prek prek::languages::<impl prek::config::Language>::install::{{closure}}
 0.2%   0.4%  53.3KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.4%  46.8KiB              prek prek::run::{{closure}}
 0.2%   0.3%  41.3KiB              prek prek::cli::run::run::run::{{closure}}
 0.1%   0.3%  33.3KiB             prek? <prek::cli::RunArgs as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_39_1_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  28.0KiB             prek? <prek::config::_::<impl serde_core::de::Deserialize for prek::config::Config>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2%  27.6KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_39_1_edwards25519_scalarmuldouble
 0.1%   0.2%  27.4KiB               std core::ptr::drop_in_place<prek::languages::<impl prek::config::Language>::install::{{closure}}>
 0.1%   0.2%  26.4KiB              prek prek::cli::try_repo::try_repo::{{closure}}
 0.1%   0.2%  22.7KiB              prek prek::hooks::meta_hooks::MetaHooks::run::{{closure}}
 0.1%   0.2%  22.5KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  22.3KiB         [Unknown] Lp384_montjscalarmul_alt_p384_montjadd
 0.1%   0.2%  21.5KiB      clap_builder clap_builder::parser::parser::Parser::get_matches_with
41.2%  86.3%  10.6MiB                   And 23741 smaller methods. Use -n N to show more.
47.7% 100.0%  12.3MiB                   .text section size, the file size is 25.8MiB

Base Branch Results

 File  .text     Size             Crate Name
 1.2%   2.6% 332.0KiB        aws_lc_sys aws_lc_0_39_1_aes_gcm_encrypt_avx512
 1.2%   2.6% 332.0KiB        aws_lc_sys aws_lc_0_39_1_aes_gcm_decrypt_avx512
 0.3%   0.7%  84.0KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.6%  82.2KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.2%   0.5%  60.9KiB             prek? <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  56.8KiB              prek prek::languages::<impl prek::config::Language>::install::{{closure}}
 0.2%   0.4%  53.3KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.4%  46.8KiB              prek prek::run::{{closure}}
 0.2%   0.3%  41.3KiB              prek prek::cli::run::run::run::{{closure}}
 0.1%   0.3%  33.1KiB             prek? <prek::cli::RunArgs as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_39_1_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  28.0KiB             prek? <prek::config::_::<impl serde_core::de::Deserialize for prek::config::Config>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2%  27.6KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_39_1_edwards25519_scalarmuldouble
 0.1%   0.2%  27.4KiB               std core::ptr::drop_in_place<prek::languages::<impl prek::config::Language>::install::{{closure}}>
 0.1%   0.2%  26.4KiB              prek prek::cli::try_repo::try_repo::{{closure}}
 0.1%   0.2%  23.0KiB              prek prek::hooks::meta_hooks::MetaHooks::run::{{closure}}
 0.1%   0.2%  22.5KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  22.3KiB         [Unknown] Lp384_montjscalarmul_alt_p384_montjadd
 0.1%   0.2%  21.5KiB      clap_builder clap_builder::parser::parser::Parser::get_matches_with
41.5%  86.4%  10.8MiB                   And 23794 smaller methods. Use -n N to show more.
48.0% 100.0%  12.5MiB                   .text section size, the file size is 26.0MiB

prek-ci-bot · 2026-04-27T18:05:30Z

⚡️ Hyperfine Benchmarks

Summary: 0 regressions, 0 improvements above the 10% threshold.

Environment

OS: Linux 6.17.0-1010-azure
CPU: 4 cores
prek version: prek 0.3.11+9 (7efdd91 2026-04-28)
Rust version: rustc 1.95.0 (59807616e 2026-04-14)
Hyperfine version: hyperfine 1.20.0

CLI Commands

Benchmarking basic commands in the main repo:

`prek --version`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base --version`	2.2 ± 0.1	2.1	2.4	1.02 ± 0.04
`prek-head --version`	2.2 ± 0.1	2.1	2.5	1.00

`prek list`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base list`	8.7 ± 0.1	8.5	9.0	1.00
`prek-head list`	8.7 ± 0.1	8.5	9.6	1.00 ± 0.02

`prek validate-config .pre-commit-config.yaml`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base validate-config .pre-commit-config.yaml`	3.1 ± 0.0	3.0	3.1	1.01 ± 0.02
`prek-head validate-config .pre-commit-config.yaml`	3.0 ± 0.0	2.9	3.2	1.00

`prek sample-config`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base sample-config`	2.5 ± 0.0	2.4	2.6	1.00
`prek-head sample-config`	2.5 ± 0.0	2.4	2.6	1.01 ± 0.02

Cold vs Warm Runs

Comparing first run (cold) vs subsequent runs (warm cache):

`prek run --all-files (cold - no cache)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run --all-files`	142.5 ± 2.3	138.7	147.0	1.01 ± 0.03
`prek-head run --all-files`	141.4 ± 2.7	137.8	144.8	1.00

`prek run --all-files (warm - with cache)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run --all-files`	141.4 ± 3.4	135.4	146.8	1.01 ± 0.03
`prek-head run --all-files`	140.2 ± 2.8	135.6	144.5	1.00

Full Hook Suite

Running the builtin hook suite on the benchmark workspace:

`prek run --all-files (full builtin hook suite)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run --all-files`	140.0 ± 3.4	133.9	145.9	1.00
`prek-head run --all-files`	143.1 ± 15.5	135.0	247.5	1.02 ± 0.11

Individual Hook Performance

Benchmarking each hook individually on the test repo:

`prek run trailing-whitespace --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run trailing-whitespace --all-files`	20.3 ± 0.4	19.7	21.4	1.00
`prek-head run trailing-whitespace --all-files`	20.6 ± 1.6	19.4	25.7	1.02 ± 0.08

`prek run end-of-file-fixer --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run end-of-file-fixer --all-files`	26.8 ± 2.1	23.6	31.2	1.00 ± 0.12
`prek-head run end-of-file-fixer --all-files`	26.7 ± 2.3	23.2	30.7	1.00

`prek run check-json --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run check-json --all-files`	11.8 ± 0.5	11.3	14.0	1.04 ± 0.06
`prek-head run check-json --all-files`	11.4 ± 0.4	10.7	12.1	1.00

`prek run check-yaml --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run check-yaml --all-files`	11.0 ± 0.4	10.7	12.9	1.02 ± 0.04
`prek-head run check-yaml --all-files`	10.8 ± 0.1	10.7	11.1	1.00

`prek run check-toml --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run check-toml --all-files`	11.0 ± 0.3	10.5	11.6	1.01 ± 0.03
`prek-head run check-toml --all-files`	11.0 ± 0.2	10.6	11.5	1.00

`prek run check-xml --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run check-xml --all-files`	10.9 ± 0.2	10.5	11.2	1.00
`prek-head run check-xml --all-files`	10.9 ± 0.2	10.4	11.5	1.00 ± 0.03

`prek run detect-private-key --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run detect-private-key --all-files`	17.2 ± 1.4	15.2	19.8	1.00 ± 0.12
`prek-head run detect-private-key --all-files`	17.2 ± 1.5	15.0	20.3	1.00

`prek run fix-byte-order-marker --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run fix-byte-order-marker --all-files`	21.8 ± 1.8	19.4	25.3	1.01 ± 0.12
`prek-head run fix-byte-order-marker --all-files`	21.5 ± 1.8	19.1	25.5	1.00

Installation Performance

Benchmarking hook installation (fast path hooks skip Python setup):

`prek install-hooks (cold - no cache)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base install-hooks`	4.5 ± 0.1	4.4	4.6	1.00
`prek-head install-hooks`	4.5 ± 0.1	4.4	4.6	1.00 ± 0.02

`prek install-hooks (warm - with cache)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base install-hooks`	4.4 ± 0.1	4.4	4.5	1.00
`prek-head install-hooks`	4.5 ± 0.0	4.4	4.5	1.01 ± 0.02

File Filtering/Scoping Performance

Testing different file selection modes:

`prek run (staged files only)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run`	47.9 ± 0.9	46.4	49.5	1.00 ± 0.02
`prek-head run`	47.9 ± 0.7	46.4	48.8	1.00

`prek run --files '*.json' (specific file type)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run --files '*.json'`	8.1 ± 0.1	7.9	8.2	1.01 ± 0.01
`prek-head run --files '*.json'`	8.0 ± 0.1	7.9	8.1	1.00

Workspace Discovery & Initialization

Benchmarking hook discovery and initialization overhead:

`prek run --dry-run --all-files (measures init overhead)`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run --dry-run --all-files`	13.2 ± 0.8	12.4	14.6	1.04 ± 0.06
`prek-head run --dry-run --all-files`	12.7 ± 0.2	12.4	13.1	1.00

Meta Hooks Performance

Benchmarking meta hooks separately:

`prek run check-hooks-apply --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run check-hooks-apply --all-files`	13.0 ± 0.1	12.8	13.2	1.03 ± 0.02
`prek-head run check-hooks-apply --all-files`	12.7 ± 0.1	12.5	13.1	1.00

`prek run check-useless-excludes --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run check-useless-excludes --all-files`	11.4 ± 0.1	11.2	11.6	1.00
`prek-head run check-useless-excludes --all-files`	11.4 ± 0.1	11.2	11.5	1.00 ± 0.01

`prek run identity --all-files`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`prek-base run identity --all-files`	9.9 ± 0.1	9.7	10.0	1.00
`prek-head run identity --all-files`	9.9 ± 0.1	9.7	10.0	1.00 ± 0.01

Covers the auto-downloaded Ruby + gemspec/additional_dependencies path with `gem` scrubbed from PATH. Without the fix in 880edab the test would fail at hook install with `LoadError: ... -- gem`. Exercises all four call sites touched by the fix: build_gemspec, resolve_gems, install_single_gem, and (on resolve fallback) install_gems_sequential. Made-with: Cursor

Top-level import triggered `unused_imports` on Windows where the only caller is gated behind `#[cfg(not(target_os = "windows"))]`. Move it inside the function so the import follows the same gate. Made-with: Cursor

Copilot

Pull request overview

This PR fixes Ruby hook install-time failures when prek auto-downloads Ruby (rv-ruby) but the parent process PATH does not include a gem executable, by ensuring the resolved Ruby’s bin/ directory is on PATH for all ruby -S gem ... invocations.

Changes:

Add a helper to compute a PATH value with the resolved Ruby’s bin/ prepended, and apply it to all ruby -S gem ... call sites during gemspec build / dependency resolution / gem install.
Adjust gem environment setup (gem_env) to set PATH (in addition to GEM_HOME and bundler-related vars) and propagate join errors.
Add an integration regression test that scrubs ruby/gem from PATH and verifies hook installation still succeeds when Ruby is auto-downloaded.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
`crates/prek/src/languages/ruby/gem.rs`	Ensures `ruby -S gem` can locate the bundled `gem` script by prepending the resolved Ruby `bin/` dir to `PATH` for install-time gem operations.
`crates/prek/tests/languages/ruby.rs`	Adds a CI-only regression test covering auto-downloaded Ruby + gem operations with `ruby`/`gem` removed from `PATH`.

remove_bin_from_path strips the entire directory that contains the named binary. On Ubuntu CI that directory is /usr/bin, which also holds git -- and prek shells out to git, failing with "Failed to find git: cannot find binary path". Fix by symlinking git into a fresh stub directory that intentionally contains no ruby or gem, then prepending that stub to PATH. Verified locally with CI=1 (rv-ruby auto-downloaded, gemspec built, webrick installed, hook ran). Made-with: Cursor

Copilot

Pull request overview

This PR fixes Ruby hook install-time failures when prek auto-downloads Ruby (rv-ruby) in environments where no system ruby/gem exists on PATH, by ensuring ruby -S gem ... can locate the gem script shipped alongside the resolved Ruby interpreter.

Changes:

Prepend the resolved Ruby toolchain’s bin/ directory to PATH for all ruby -S gem ... invocations during gemspec build / gem resolution / gem installs.
Refactor gem install environment setup to propagate PATH join errors via Result.
Add a CI-only integration regression test that scrubs ruby and gem from PATH while exercising gemspec build + dependency install.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
crates/prek/src/languages/ruby/gem.rs	Adds a helper to build a `PATH` with the resolved Ruby `bin/` prepended and applies it to all gem-related `ruby -S` subprocesses.
crates/prek/tests/languages/ruby.rs	Adds an integration regression test covering auto-downloaded Ruby gem operations when `ruby`/`gem` are absent from `PATH`.

j178 · 2026-04-28T03:26:46Z

Thanks!

This MR contains the following updates: | Package | Update | Change | |---|---|---| | [prek](https://github.com/j178/prek) | patch | `0.3.1` → `0.3.13` | MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot). **Proposed changes to behavior should be submitted there as MRs.** --- ### Release Notes <details> <summary>j178/prek (prek)</summary> ### [`v0.3.13`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0313) [Compare Source](j178/prek@v0.3.12...v0.3.13) Released on 2026-05-06. ##### Bug fixes - Respect hook filters for message files ([#2049](j178/prek#2049)) ##### Documentation - Add Godot Engine to users in README ([#2047](j178/prek#2047)) ##### Contributors - [@j178](https://github.com/j178) - [@Calinou](https://github.com/Calinou) ### [`v0.3.12`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0312) [Compare Source](j178/prek@v0.3.11...v0.3.12) Released on 2026-05-05. ##### Highlights `auto_update.cooldown_days` is now available in both the user-level global config (`~/.config/prek/prek.toml` on Linux and macOS, or `$XDG_CONFIG_HOME/prek/prek.toml` when set; `%APPDATA%\prek\prek.toml` on Windows) and project config. Set a user default for `prek auto-update`, then override it per project when a repository needs a different update cadence. ```toml [auto_update] cooldown_days = 7 ``` ##### Enhancements - Add global auto-update cooldown config ([#2041](j178/prek#2041)) - Add project auto-update cooldown config ([#2044](j178/prek#2044)) - Support `language: dart` ([#1146](j178/prek#1146)) ##### Bug fixes - Pass commit message file to workspace hooks ([#2043](j178/prek#2043)) - Preserve non-UTF8 filenames from git ([#2023](j178/prek#2023)) - ruby: put resolved Ruby's bin dir on `$PATH` for `gem` invocations ([#2021](j178/prek#2021)) ##### Documentation - Update docs with the new logo and icon ([#2025](j178/prek#2025)) - Point schema docs to SchemaStore ([#2039](j178/prek#2039)) ##### Contributors - [@j178](https://github.com/j178) - [@xiaoyanli-lyft](https://github.com/xiaoyanli-lyft) - [@Lutra-Fs](https://github.com/Lutra-Fs) ### [`v0.3.11`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0311) [Compare Source](j178/prek@v0.3.10...v0.3.11) Released on 2026-04-27. ##### Highlights Hook entries now have an explicit `shell` option for shell snippets. Set `shell: sh`, `bash`, `pwsh`, `powershell`, or `cmd` when an entry should be evaluated by that shell; leaving it unset keeps prek's direct argv execution. `prek auto-update` can now filter tag candidates before choosing an update. Both options take glob patterns: use `--include-tag` to only consider matching tag names, and `--exclude-tag` to skip matching tags such as moving tags or prereleases. ##### Enhancements - Add `auto-update --exclude-repo <repo>` to skip repos ([#1983](j178/prek#1983)) - Add `auto-update --exit-code` to exit with non-zero on updates ([#2002](j178/prek#2002)) - Add `auto-update --include-tag <pattern>`/`--exclude-tag <pattern>` to filter tags ([#1984](j178/prek#1984)) - Adds an explicit `shell` hook option for entries that should run as shell source ([#2004](j178/prek#2004)) - Make `--hook-dir` optional for hook-impl ([#1989](j178/prek#1989)) - Skip shim warning when `--script-version` is missing ([#1990](j178/prek#1990)) ##### Bug fixes - Install Ruby executable in gem bin ([#2017](j178/prek#2017)) - Use dedicated Android npm package ([#1982](j178/prek#1982)) - Use stable repo keys without breaking cached clones ([#1995](j178/prek#1995)) ##### Documentation - Explain prek name ([#1980](j178/prek#1980)) - Clarify `pass_filenames` concurrency docs ([#1999](j178/prek#1999)) - Reorganize documentation references ([#2005](j178/prek#2005)) - Clarify hook author manifest env docs ([#1991](j178/prek#1991)) - docs: add Sentry to users list ([#1981](j178/prek#1981)) ##### Contributors - [@j178](https://github.com/j178) ### [`v0.3.10`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#0310) [Compare Source](j178/prek@v0.3.9...v0.3.10) Released on 2026-04-21. ##### Enhancements - Disallow rev for non-remote repos in schema ([#1964](j178/prek#1964)) - Hide up-to-date output in non-verbose mode ([#1942](j178/prek#1942)) - Improve merge conflict marker detection ([#1937](j178/prek#1937)) - Keep finished hooks visible ([#1967](j178/prek#1967)) - Preserve frozen comment spacing in auto-update ([#1945](j178/prek#1945)) - Reimplement `@j178/prek` npm package ([#1973](j178/prek#1973)) ##### Bug fixes - Prefer stable Rust toolchains ([#1974](j178/prek#1974)) ##### Documentation - Add `SKILL.md` for prek ([#1950](j178/prek#1950)) - Document `gh skill install j178/prek prek` to install prek skill for agents ([#1951](j178/prek#1951)) - Improve compatibility and migration docs ([#1940](j178/prek#1940)) ##### Other changes - Sync latest identify tags ([#1947](j178/prek#1947)) ##### Contributors - [@github-actions](https://github.com/github-actions) - [@renovate](https://github.com/renovate) - [@j178](https://github.com/j178) ### [`v0.3.9`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#039) [Compare Source](j178/prek@v0.3.8...v0.3.9) Released on 2026-04-13. ##### Highlight `prek auto-update` is now stricter about pinned revisions and more useful in CI. It now keeps `rev` and `# frozen:` comments in sync, can detect [impostor commits](https://docs.zizmor.sh/audits/#impostor-commit) when validating pinned SHAs, and lets you use `prek auto-update --check` to fail on both available updates and frozen-ref mismatches without rewriting the config. Examples: ```console $ prek auto-update # updates revs and repairs stale `# frozen:` comments $ prek auto-update --freeze # writes frozen SHAs with matching `# frozen: <tag>` comments $ prek auto-update --check # exits non-zero when updates are available, a `# frozen:` comment is stale, # or a pinned SHA does not belong to the fetched upstream refs ``` ##### Enhancements - Check and sync frozen comments during auto-update ([#1896](j178/prek#1896)) - Handle impostor commits in auto-update ([#1919](j178/prek#1919)) - Add experimental `language: dotnet` support ([#1871](j178/prek#1871)) - Honor repo and worktree `core.hooksPath` ([#1892](j178/prek#1892)) - Add `prek run --no-fail-fast` to override config file ([#1859](j178/prek#1859)) - Add `forbid-new-submodules` as builtin hook ([#1853](j178/prek#1853)) - Clean stale patch files in `cache gc` ([#1877](j178/prek#1877)) - Display auto-update results by config entry ([#1922](j178/prek#1922)) - Restrict patch directory permissions ([#1876](j178/prek#1876)) - Show tag names in `auto-update --freeze` output ([#1916](j178/prek#1916)) - Use a bitset for hook stages ([#1860](j178/prek#1860)) ##### Bug fixes - Canonicalize CWD and GIT\_ROOT paths ([#1878](j178/prek#1878)) - Ensure quotes are added for non-string revisions in `auto-update` ([#1936](j178/prek#1936)) ##### Documentation - Update docs for case of hooks modifying files with a non-zero exit code ([#1879](j178/prek#1879)) ##### Contributors - [@RicardoVercetti](https://github.com/RicardoVercetti) - [@nathanjmcdougall](https://github.com/nathanjmcdougall) - [@renovate](https://github.com/renovate) - [@sadjow](https://github.com/sadjow) - [@j178](https://github.com/j178) ### [`v0.3.8`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#038) [Compare Source](j178/prek@v0.3.6...v0.3.8) Released on 2026-03-23. ##### Enhancements - Add experimental `language: deno` support ([#1516](j178/prek#1516)) - Add `pretty-format-json` as builtin hook ([#915](j178/prek#915)) - Add `check-vcs-permalinks` as builtin hook ([#1842](j178/prek#1842)) - Add `check-illegal-windows-names` as builtin hook ([#1841](j178/prek#1841)) - Add `check-shebang-scripts-are-executable` builtin hook ([#1847](j178/prek#1847)) - Add `destroyed-symlinks` builtin hook ([#1851](j178/prek#1851)) - Add `file-contents-sorter` as builtin hook ([#1846](j178/prek#1846)) - Add `--all` flag to `prek uninstall` ([#1817](j178/prek#1817)) - Improve file pattern parse errors ([#1829](j178/prek#1829)) - Validate `uv` binary after download ([#1825](j178/prek#1825)) ##### Bug fixes - Fix workspace-relative added file paths ([#1852](j178/prek#1852)) - Relax alias-anchor ratio check for check-yaml ([#1839](j178/prek#1839)) ##### Contributors - [@j178](https://github.com/j178) - [@shaanmajid](https://github.com/shaanmajid) - [@mvanhorn](https://github.com/mvanhorn) - [@feliblo](https://github.com/feliblo) - [@Tiryoh](https://github.com/Tiryoh) ### [`v0.3.6`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#036) [Compare Source](j178/prek@v0.3.5...v0.3.6) Released on 2026-03-16. ##### Enhancements - Allow selectors for hook ids containing colons ([#1782](j178/prek#1782)) - Rename `prek install-hooks` to `prek prepare-hooks` and `prek install --install-hooks` to `prek install --prepare-hooks` ([#1766](j178/prek#1766)) - Retry auth-failed repo clones with terminal prompts enabled ([#1761](j178/prek#1761)) ##### Performance - Optimize `detect_private_key` by chunked reading and using aho-corasick ([#1791](j178/prek#1791)) - Optimize `fix_byte_order_marker` by shifting file contents in place ([#1790](j178/prek#1790)) ##### Bug fixes - Align stage defaulting behavior with pre-commit ([#1788](j178/prek#1788)) - Make sure child output is drained in the PTY subprocess ([#1768](j178/prek#1768)) - fix(golang): use `GOTOOLCHAIN=local` when probing system go ([#1797](j178/prek#1797)) ##### Documentation - Disambiguate “hook” terminology by renaming "Git hooks" to "Git shims" ([#1776](j178/prek#1776)) - Document compatibility with pre-commit ([#1767](j178/prek#1767)) - Update configuration.md with TOML 1.1 notes ([#1764](j178/prek#1764)) ##### Other changes - Sync latest identify tags ([#1798](j178/prek#1798)) ##### Contributors - [@github-actions](https://github.com/github-actions) - [@j178](https://github.com/j178) - [@pcastellazzi](https://github.com/pcastellazzi) - [@deadnews](https://github.com/deadnews) - [@copilot-swe-agent](https://github.com/copilot-swe-agent) ### [`v0.3.5`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#035) [Compare Source](j178/prek@v0.3.4...v0.3.5) Released on 2026-03-09. ##### Enhancements - Add automatic Ruby download support using rv binaries ([#1668](j178/prek#1668)) - Adjust open file limit on process startup ([#1705](j178/prek#1705)) - Allow parallel gem retry ([#1732](j178/prek#1732)) - Enable system-proxy feature on reqwest ([#1738](j178/prek#1738)) - Expose `--git-dir` to force hook installation target ([#1723](j178/prek#1723)) - Pass `--quiet`, `--verbose`, and `--no-progress` through `prek install` into generated hook scripts ([#1753](j178/prek#1753)) - Respect `core.sharedRepository` for hook permissions ([#1755](j178/prek#1755)) - Support legacy mode hook script ([#1706](j178/prek#1706)) - rust: support `cli:` git dependency 4th segment package disambiguation ([#1747](j178/prek#1747)) ##### Bug fixes - Fix Python `__main__.py` entry ([#1741](j178/prek#1741)) - python: strip `UV_SYSTEM_PYTHON` from `uv venv` and `pip install` commands ([#1756](j178/prek#1756)) ##### Other changes - Sync latest identify tags ([#1733](j178/prek#1733)) ##### Contributors - [@Dev-iL](https://github.com/Dev-iL) - [@tennox](https://github.com/tennox) - [@shaanmajid](https://github.com/shaanmajid) - [@is-alnilam](https://github.com/is-alnilam) - [@github-actions](https://github.com/github-actions) - [@j178](https://github.com/j178) ### [`v0.3.4`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#034) [Compare Source](j178/prek@v0.3.3...v0.3.4) Released on 2026-02-28. ##### Enhancements - Allow `pass_filenames` to accept a positive integer ([#1698](j178/prek#1698)) - Install and compile gems in parallel ([#1674](j178/prek#1674)) - Sync identify file-type mappings with pre-commit identify ([#1660](j178/prek#1660)) - Use `--locked` for Rust `cargo install` commands ([#1661](j178/prek#1661)) - Add `PREK_MAX_CONCURRENCY` environment variable for configuring maximum concurrency ([#1697](j178/prek#1697)) - Add `PREK_LOG_TRUNCATE_LIMIT` environment variable for configuring log truncation ([#1679](j178/prek#1679)) - Add support for `python -m prek` ([#1686](j178/prek#1686)) ##### Bug fixes - Skip invalid Rust toolchains instead of failing ([#1699](j178/prek#1699)) ##### Performance - Bitset-based TagSet refactor: precompute tag masks and speed up hook type filtering ([#1665](j178/prek#1665)) ##### Documentation - Document `winget install j178.Prek` ([#1670](j178/prek#1670)) ##### Contributors - [@uplsh580](https://github.com/uplsh580) - [@Svecco](https://github.com/Svecco) - [@dbast](https://github.com/dbast) - [@drichardson](https://github.com/drichardson) - [@JP-Ellis](https://github.com/JP-Ellis) - [@j178](https://github.com/j178) - [@is-alnilam](https://github.com/is-alnilam) - [@copilot-swe-agent](https://github.com/copilot-swe-agent) ### [`v0.3.3`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#033) [Compare Source](j178/prek@v0.3.2...v0.3.3) Released on 2026-02-15. ##### Enhancements - Read Python version specifier from hook repo `pyproject.toml` ([#1596](j178/prek#1596)) - Add `#:schema` directives to generated prek.toml ([#1597](j178/prek#1597)) - Add `prek util list-builtins` command ([#1600](j178/prek#1600)) - Expand install source detection to `mise`, `uv tool`, `pipx`, and `asdf` ([#1605](j178/prek#1605), [#1607](j178/prek#1607)) - Add progress bar to `cache clean` and show removal summary ([#1616](j178/prek#1616)) - Make `yaml-to-toml` CONFIG argument optional ([#1593](j178/prek#1593)) - `prek uninstall` removes legacy scripts too ([#1622](j178/prek#1622)) ##### Bug fixes - Fix underflow when formatting summary output ([#1626](j178/prek#1626)) - Match `files/exclude` filter against relative path of nested project ([#1624](j178/prek#1624)) - Select `musllinux` wheel tag for uv on musl-based distros ([#1628](j178/prek#1628)) ##### Documentation - Clarify `prek list` description ([#1604](j178/prek#1604)) ##### Contributors - [@ichoosetoaccept](https://github.com/ichoosetoaccept) - [@shaanmajid](https://github.com/shaanmajid) - [@soraxas](https://github.com/soraxas) - [@9999years](https://github.com/9999years) - [@j178](https://github.com/j178) ### [`v0.3.2`](https://github.com/j178/prek/blob/HEAD/CHANGELOG.md#032) [Compare Source](j178/prek@v0.3.1...v0.3.2) Released on 2026-02-06. ##### Highlights - **`prek.toml` is here!** You can now use `prek.toml` as an alternative to `.pre-commit-config.yaml` for configuring prek. `prek.toml` mirrors the structure of `.pre-commit-config.yaml`, but TOML is less error-prone. Your existing `.pre-commit-config.yaml` will continue to work, but for new users and new projects, `prek.toml` may make more sense. If you want to switch, run `prek util yaml-to-toml` to convert YAML configs to `prek.toml`. See [configuration docs](configuration.md) for details. For example, this config: ```yaml repos: - repo: https://github.com/pre-commit/pre-commit-hooks rev: v6.0.0 hooks: - id: check-yaml ``` Can be written as `prek.toml` like this: ```toml [[repos]] repo = "https://github.com/pre-commit/pre-commit-hooks" rev = "v6.0.0" hooks = [ { id = "check-yaml" } ] ``` - **`serde-yaml` has been replaced with `serde-saphyr`** We replaced the long-deprecated `serde-yaml` crate with [`serde-saphyr`](https://crates.io/crates/serde-saphyr) for YAML parsing. It is written in safe Rust and has better error messages, performance, and security. This lets us provide precise location information for configuration parsing errors, which should make it easier to fix config issues. For example, this invalid config: ```yaml repos: - repo: https://github.com/crate-ci/typos hooks: - id: typos ``` Before: ```console $ prek run error: Failed to parse `.pre-commit-config.yaml` caused by: Invalid remote repo: missing field `rev` ``` Now: ```console $ prek run error: Failed to parse `.pre-commit-config.yaml` caused by: error: line 2 column 5: missing field `rev` at line 2, column 5 --> <input>:2:5 | 1 | repos: 2 | - repo: https://github.com/crate-ci/typos | ^ missing field `rev` at line 2, column 5 3 | hooks: 4 | - id: typos | ``` - **`prek util` subcommands** We added a new `prek util` top-level command for miscellaneous utilities that don't fit into other categories. The first two utilities are: - `prek util identify`: shows the identification tags of files that prek uses for file filtering, which can be useful for debugging and writing `types/types_or/exclude_types` filters. - `prek util yaml-to-toml`: converts `.pre-commit-config.yaml` to `prek.toml`. We also moved `prek init-template-dir` under `prek util` for better organization. The old `prek init-template-dir` command is still available (hidden) as an alias for backward compatibility. ##### Enhancements - Add `prek util identify` subcommand ([#1554](j178/prek#1554)) - Add `prek util yaml-to-toml` to convert `.pre-commit-config.yaml` to `prek.toml` ([#1584](j178/prek#1584)) - Detect install source for actionable upgrade hints ([#1540](j178/prek#1540)) - Detect prek installed by the standalone installer ([#1545](j178/prek#1545)) - Implement `serialize_yaml_scalar` using `serde-saphyr` ([#1534](j178/prek#1534)) - Improve max cli arguments length calculation ([#1518](j178/prek#1518)) - Move `identify` and `init-template-dir` under the `prek util` top-level command ([#1574](j178/prek#1574)) - Replace serde-yaml with serde-saphyr (again) ([#1520](j178/prek#1520)) - Show precise location for config parsing error ([#1530](j178/prek#1530)) - Support `Julia` language ([#1519](j178/prek#1519)) - Support `prek.toml` ([#1271](j178/prek#1271)) - Added `PREK_QUIET` environment variable support ([#1513](j178/prek#1513)) - Remove upper bound constraint of uv version ([#1588](j178/prek#1588)) ##### Bug fixes - Do not make the child a session leader ([#1586](j178/prek#1586)) - Fix FilePattern schema to accept plain strings ([#1564](j178/prek#1564)) - Use semver fallback sort when tag timestamps are equal ([#1579](j178/prek#1579)) ##### Documentation - Add `OpenClaw` to the list of users ([#1517](j178/prek#1517)) - Add `cachix/devenv`, `apache/lucene`, `copper-project/copper-rs` as projects using prek ([#1531](j178/prek#1531), [#1514](j178/prek#1514), [#1569](j178/prek#1569)) - Add document about authoring remote hooks ([#1571](j178/prek#1571)) - Add `llms.txt` generation for LLM-friendly documentation ([#1553](j178/prek#1553)) - Document using `--refresh` to pick up `.prekignore` changes ([#1575](j178/prek#1575)) - Fix PowerShell completion instruction syntax ([#1568](j178/prek#1568)) - Update quick start to use `prek.toml` ([#1576](j178/prek#1576)) ##### Other changes - Include `prek.toml` in run hint for config filename ([#1578](j178/prek#1578)) ##### Contributors - [@fatelei](https://github.com/fatelei) - [@domenkozar](https://github.com/domenkozar) - [@makeecat](https://github.com/makeecat) - [@fllesser](https://github.com/fllesser) - [@j178](https://github.com/j178) - [@copilot-swe-agent](https://github.com/copilot-swe-agent) - [@oopscompiled](https://github.com/oopscompiled) - [@rmuir](https://github.com/rmuir) - [@shaanmajid](https://github.com/shaanmajid) </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this MR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this MR, check this box --- This MR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).

Copilot AI review requested due to automatic review settings April 27, 2026 17:57

xiaoyanli-lyft requested a review from j178 as a code owner April 27, 2026 17:57

Copilot AI reviewed Apr 27, 2026

View reviewed changes

Comment thread crates/prek/src/languages/ruby/gem.rs

xiaoyanli-lyft added 2 commits April 27, 2026 11:36

Scope remove_bin_from_path import to non-Windows test

2a05883

Top-level import triggered `unused_imports` on Windows where the only caller is gated behind `#[cfg(not(target_os = "windows"))]`. Move it inside the function so the import follows the same gate. Made-with: Cursor

Copilot AI review requested due to automatic review settings April 27, 2026 18:41

Copilot AI reviewed Apr 27, 2026

View reviewed changes

Comment thread crates/prek/tests/languages/ruby.rs Outdated

xiaoyanli-lyft added 2 commits April 27, 2026 11:49

fix

068caeb

Copilot AI review requested due to automatic review settings April 27, 2026 18:57

Copilot AI reviewed Apr 27, 2026

View reviewed changes

j178 added the bug Something isn't working label Apr 28, 2026

Drop the test

e2f02fe

j178 merged commit 3268a83 into j178:master Apr 28, 2026
34 checks passed

BrewTestBot mentioned this pull request May 5, 2026

prek 0.3.12 Homebrew/homebrew-core#280938

Merged

Uh oh!

Conversation

xiaoyanli-lyft commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Fix

Test plan

Manual verification of the failure mode (without this fix)

Uh oh!

codecov Bot commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

prek-ci-bot Bot commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 Cargo Bloat Comparison

Head Branch Results

Base Branch Results

Uh oh!

prek-ci-bot Bot commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚡️ Hyperfine Benchmarks

prek --version

prek list

prek validate-config .pre-commit-config.yaml

prek sample-config

prek run --all-files (cold - no cache)

prek run --all-files (warm - with cache)

prek run --all-files (full builtin hook suite)

prek run trailing-whitespace --all-files

prek run end-of-file-fixer --all-files

prek run check-json --all-files

prek run check-yaml --all-files

prek run check-toml --all-files

prek run check-xml --all-files

prek run detect-private-key --all-files

prek run fix-byte-order-marker --all-files

prek install-hooks (cold - no cache)

prek install-hooks (warm - with cache)

prek run (staged files only)

prek run --files '*.json' (specific file type)

prek run --dry-run --all-files (measures init overhead)

prek run check-hooks-apply --all-files

prek run check-useless-excludes --all-files

prek run identity --all-files

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

j178 commented Apr 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

xiaoyanli-lyft commented Apr 27, 2026 •

edited

Loading

codecov Bot commented Apr 27, 2026 •

edited

Loading

prek-ci-bot Bot commented Apr 27, 2026 •

edited

Loading

prek-ci-bot Bot commented Apr 27, 2026 •

edited

Loading

`prek --version`

`prek list`

`prek validate-config .pre-commit-config.yaml`

`prek sample-config`

`prek run --all-files (cold - no cache)`

`prek run --all-files (warm - with cache)`

`prek run --all-files (full builtin hook suite)`

`prek run trailing-whitespace --all-files`

`prek run end-of-file-fixer --all-files`

`prek run check-json --all-files`

`prek run check-yaml --all-files`

`prek run check-toml --all-files`

`prek run check-xml --all-files`

`prek run detect-private-key --all-files`

`prek run fix-byte-order-marker --all-files`

`prek install-hooks (cold - no cache)`

`prek install-hooks (warm - with cache)`

`prek run (staged files only)`

`prek run --files '*.json' (specific file type)`

`prek run --dry-run --all-files (measures init overhead)`

`prek run check-hooks-apply --all-files`

`prek run check-useless-excludes --all-files`

`prek run identity --all-files`