Support `prek.toml` by j178 · Pull Request #1271 · j178/prek

j178 · 2025-12-23T11:30:10Z

Closes #593

codecov · 2025-12-23T11:31:43Z

Codecov Report

❌ Patch coverage is 91.37931% with 25 lines in your changes missing coverage. Please review.
✅ Project coverage is 91.57%. Comparing base (d42b733) to head (af5b4d1).
⚠️ Report is 12 commits behind head on master.

Files with missing lines	Patch %	Lines
crates/prek/src/cli/auto_update.rs	82.43%	13 Missing ⚠️
crates/prek/src/cli/sample_config.rs	88.88%	4 Missing ⚠️
crates/prek/src/hook.rs	50.00%	3 Missing ⚠️
crates/prek/src/workspace.rs	94.73%	2 Missing ⚠️
crates/prek/src/cli/try_repo.rs	96.96%	1 Missing ⚠️
crates/prek/src/config.rs	98.78%	1 Missing ⚠️
crates/prek/src/main.rs	80.00%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##           master    #1271    +/-   ##
========================================
  Coverage   91.57%   91.57%            
========================================
  Files          92       92            
  Lines       17912    18122   +210     
========================================
+ Hits        16403    16596   +193     
- Misses       1509     1526    +17

☔ 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.

github-actions · 2025-12-23T11:35:31Z

📦 Cargo Bloat Comparison

Binary size change: +1.72% (23.2 MiB → 23.6 MiB)

Expand for cargo-bloat output

Head Branch Results

 File  .text    Size             Crate Name
 0.3%   0.8% 80.5KiB             prek? <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.3%   0.7% 71.3KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.6% 65.6KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.2%   0.5% 51.2KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.5% 50.5KiB              prek prek::languages::<impl prek::config::Language>::install::{{closure}}
 0.2%   0.4% 41.8KiB              prek prek::cli::run::run::run::{{closure}}
 0.2%   0.4% 40.7KiB              prek prek::run::{{closure}}
 0.1%   0.3% 31.1KiB             prek? <prek::cli::RunArgs as clap_builder::derive::Args>::augment_args
 0.1%   0.3% 28.4KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.3% 28.3KiB              prek prek::identify::by_extension::{{closure}}
 0.1%   0.2% 24.9KiB             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% 22.6KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2% 22.2KiB              prek prek::hooks::meta_hooks::MetaHooks::run::{{closure}}
 0.1%   0.2% 21.2KiB      clap_builder clap_builder::parser::parser::Parser::get_matches_with
 0.1%   0.2% 20.6KiB              prek prek::hooks::meta_hooks::MetaHooks::run::{{closure}}
 0.1%   0.2% 20.0KiB   cargo_metadata? <cargo_metadata::_::<impl serde_core::de::Deserialize for cargo_metadata::Package>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2% 19.5KiB              prek prek::archive::unzip::{{closure}}
 0.1%   0.2% 19.5KiB              prek prek::cli::run::filter::collect_files_from_args::{{closure}}
 0.1%   0.2% 19.3KiB               std core::ptr::drop_in_place<prek::languages::<impl prek::config::Language>::install::{{closure}}>
 0.1%   0.2% 19.2KiB              prek <prek::languages::ruby::ruby::Ruby as prek::languages::LanguageImpl>::install::{{closure}}
38.3%  91.5%  9.0MiB                   And 20867 smaller methods. Use -n N to show more.
41.8% 100.0%  9.9MiB                   .text section size, the file size is 23.6MiB

Base Branch Results

 File  .text    Size             Crate Name
 0.3%   0.8% 76.3KiB             prek? <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.3%   0.7% 72.1KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.7% 65.7KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.2%   0.5% 51.2KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.5% 50.8KiB              prek prek::languages::<impl prek::config::Language>::install::{{closure}}
 0.2%   0.4% 44.1KiB              prek prek::run::{{closure}}
 0.2%   0.4% 43.4KiB              prek prek::identify::by_extension::{{closure}}
 0.2%   0.4% 41.7KiB              prek prek::cli::run::run::run::{{closure}}
 0.1%   0.3% 31.9KiB             prek? <prek::cli::RunArgs as clap_builder::derive::Args>::augment_args
 0.1%   0.3% 28.4KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2% 24.5KiB             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% 22.6KiB      serde_saphyr saphyr_parser_bw::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2% 22.1KiB              prek prek::hooks::meta_hooks::MetaHooks::run::{{closure}}
 0.1%   0.2% 21.2KiB      clap_builder clap_builder::parser::parser::Parser::get_matches_with
 0.1%   0.2% 20.0KiB   cargo_metadata? <cargo_metadata::_::<impl serde_core::de::Deserialize for cargo_metadata::Package>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2% 19.7KiB              prek prek::hooks::meta_hooks::MetaHooks::run::{{closure}}
 0.1%   0.2% 19.6KiB              prek prek::archive::unzip::{{closure}}
 0.1%   0.2% 19.4KiB              prek prek::cli::run::filter::collect_files_from_args::{{closure}}
 0.1%   0.2% 19.4KiB              prek prek::cli::run::filter::collect_files_from_args::{{closure}}
 0.1%   0.2% 19.3KiB               std core::ptr::drop_in_place<prek::languages::<impl prek::config::Language>::install::{{closure}}>
37.9%  91.2%  8.8MiB                   And 20376 smaller methods. Use -n N to show more.
41.6% 100.0%  9.7MiB                   .text section size, the file size is 23.2MiB

pygarap · 2026-01-13T01:40:00Z

@j178 if prek.toml is the equivalent of .pre-commit-config.yaml, why not rename it to prek-config.toml and also add support for prek-hooks.toml as the equivalent of .pre-commit-hooks.yaml?

ulgens · 2026-01-14T00:41:57Z

if prek.toml is the equivalent of .pre-commit-config.yaml, why not rename it to prek-config.toml and also add support for prek-hooks.toml as the equivalent of .pre-commit-hooks.yaml?

Similar question here. Will this be an alternative to .pre-commit-config.yaml file or is it to keep prek settings?

OJFord · 2026-01-14T20:50:54Z

@ulgens The description is 'Closes #593', it's the former. (Also as you can see clearly from:
https://github.com/j178/prek/pull/1271/changes#diff-ff219642554f55d0b52b321bd22873805b5075725d97a9caabd22f3e53f0c63bR132)

Regarding the name, my 2p would be that prek.toml makes more sense if you forget the history. It's a toml file, obviously it's some kind of config, it doesn't need to be called that the same way I don't have Cargo-config.toml or pyproject-config.toml. (In fairness, it does seem more popular in the JS world to have *.config.js, but I suppose back to my first point - unlike toml, js isn't readily apparent as a config file.)

ulgens · 2026-01-17T21:20:51Z

@OJFord Oh, thank you. Checking it again now, it seems clear but I was confused at the time.

pygarap · 2026-01-17T21:23:24Z

But what about prek-hooks.toml?

Support `prek sample-config --format toml`

Copilot

Pull request overview

Adds first-class support for a TOML-based configuration file (prek.toml) alongside existing .pre-commit-config.yaml configs, including updated workspace discovery, CLI behavior, and documentation.

Changes:

Add TOML config loading and recognize prek.toml (with defined filename precedence).
Update CLI commands (sample-config, try-repo, auto-update) to generate/read/update TOML configs.
Refresh docs and integration/unit snapshots to cover TOML + new messaging.

Reviewed changes

Copilot reviewed 36 out of 38 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
docs/configuration.md	Documents `prek.toml`, precedence rules, and TOML/YAML examples.
docs/cli.md	Updates CLI reference to include `sample-config --format`.
crates/prek/tests/workspace.rs	Updates workspace discovery snapshots/error messaging for TOML support.
crates/prek/tests/validate.rs	Uses renamed consts for YAML config filename.
crates/prek/tests/try_repo.rs	Updates `try-repo` snapshots for generated `prek.toml` output.
crates/prek/tests/sample_config.rs	Adds coverage for TOML sample config output and `--format`.
crates/prek/tests/run.rs	Adds/updates tests for precedence and running with `prek.toml`.
crates/prek/tests/meta_hooks.rs	Updates tests to use renamed YAML config constant.
crates/prek/tests/list.rs	Updates “no config found” snapshot for TOML awareness.
crates/prek/tests/languages/swift.rs	Renames manifest const usage in tests.
crates/prek/tests/languages/script.rs	Renames YAML config const usage in tests.
crates/prek/tests/languages/python.rs	Renames manifest const usage in tests.
crates/prek/tests/languages/golang.rs	Renames config/manifest const usage in tests.
crates/prek/tests/install.rs	Renames YAML config const usage in tests.
crates/prek/tests/hook_impl.rs	Updates snapshots and constants for TOML-aware discovery.
crates/prek/tests/common/mod.rs	Updates workspace helpers to write YAML config via new const.
crates/prek/tests/cache.rs	Updates tracked-config filename constants.
crates/prek/tests/builtin_hooks.rs	Updates YAML config constant usage in tests.
crates/prek/tests/auto_update.rs	Adds TOML auto-update coverage (including comment preservation).
crates/prek/src/workspace.rs	Adds config filename precedence, TOML discovery, and updated errors.
crates/prek/src/snapshots/prek__config__tests__read_yaml_config.snap	New snapshot for YAML config parsing test naming.
crates/prek/src/snapshots/prek__config__tests__read_toml_config.snap	New snapshot covering TOML config parsing.
crates/prek/src/snapshots/prek__config__tests__meta_hooks-5.snap	Updates meta-hooks snapshot to include `prek.toml`.
crates/prek/src/main.rs	Routes cache dir output to “important” stdout; wires new sample-config args.
crates/prek/src/hooks/meta_hooks.rs	Expands meta-hook config file matching to include `prek.toml`.
crates/prek/src/hook.rs	Renames manifest const and updates related tests.
crates/prek/src/config.rs	Adds TOML parsing path + error variant; adds TOML parsing tests/snapshots.
crates/prek/src/cli/try_repo.rs	Generates a TOML config for `try-repo` via `toml_edit`.
crates/prek/src/cli/sample_config.rs	Adds TOML sample config + format selection + improved file creation.
crates/prek/src/cli/mod.rs	Adds `SampleConfigFormat`/`--format` and new `-f` target handling.
crates/prek/src/cli/install.rs	Uses unified `CONFIG_FILENAMES` fallback list.
crates/prek/src/cli/hook_impl.rs	Updates missing-config error matching for renamed variant.
crates/prek/src/cli/cache_gc.rs	Updates handling of config “not found” after removing `NotFound` variant.
crates/prek/src/cli/auto_update.rs	Adds TOML rewrite path using `toml_edit` and keeps YAML behavior.
crates/prek/Cargo.toml	Adds `toml_edit` dependency.
crates/prek-consts/src/lib.rs	Introduces `PREK_TOML`, renamed constants, and `CONFIG_FILENAMES`.
Cargo.toml	Adds workspace dependency for `toml_edit`.
Cargo.lock	Locks `toml_edit` and transitive deps.

Copilot · 2026-02-04T12:34:29Z

+static SAMPLE_CONFIG_TOML: &str = indoc::indoc! {r#"
+#:schema: https://json.schemastore.org/prek.json
+# Configuration file for `prek`, a git hook framework written in Rust.
+# See https://prek.j178.dev for more information.
+
+[[repos]]
+repo = "builtin"
+hooks = [
+    { id = "trailing-whitespace" },
+    { id = "end-of-file-fixer" },
+    { id = "check-added-large-files" },
+]"#};


SAMPLE_CONFIG_TOML currently ends at the closing ] without a trailing newline (the raw string terminator is on the same line). This makes the generated prek.toml file differ from typical POSIX text-file conventions and from the integration test snapshot expectations (which include a final newline). Consider adding a trailing newline to the TOML template and using write! vs writeln! consistently for stdout vs file output to avoid double blank lines.

update schema url

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).

j178 added the enhancement New feature or request label Dec 23, 2025

j178 changed the title ~~prektoml~~ Support prek.toml Dec 23, 2025

j178 marked this pull request as draft December 23, 2025 11:31

j178 force-pushed the prektoml branch 4 times, most recently from e7f23ae to ac9aae2 Compare December 24, 2025 08:07

j178 force-pushed the prektoml branch 2 times, most recently from ba41b8f to 9250c04 Compare December 31, 2025 03:13

j178 force-pushed the master branch from 0573b0f to 549f3ae Compare January 7, 2026 14:45

j178 added this to the v0.3.0 milestone Jan 19, 2026

j178 force-pushed the prektoml branch 6 times, most recently from b51aab5 to a95d7a7 Compare February 3, 2026 15:43

j178 added 4 commits February 4, 2026 18:10

Support prek.toml configuration file

fa9a698

Support prek sample-config --format toml (#1546)

68e6085

Support `prek sample-config --format toml`

Support prek.toml in auto-update (#1547)

f9758c4

Generate prek.toml in try-repo (#1549)

2e9cd17

j178 force-pushed the prektoml branch 2 times, most recently from f7a7700 to 20bdc34 Compare February 4, 2026 11:40

j178 marked this pull request as ready for review February 4, 2026 12:23

Copilot AI review requested due to automatic review settings February 4, 2026 12:23

Copilot started reviewing on behalf of j178 February 4, 2026 12:24 View session

Copilot AI reviewed Feb 4, 2026

View reviewed changes

Add documentation about prek.toml (#1560)

af5b4d1

update schema url

j178 force-pushed the prektoml branch from 20bdc34 to af5b4d1 Compare February 5, 2026 08:52

j178 merged commit d784a47 into master Feb 5, 2026
49 checks passed

j178 deleted the prektoml branch February 5, 2026 09:10

BrewTestBot mentioned this pull request Feb 6, 2026

prek 0.3.2 Homebrew/homebrew-core#266179

Merged

Uh oh!

Conversation

j178 commented Dec 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov Bot commented Dec 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

github-actions Bot commented Dec 23, 2025 • edited by prek-ci-bot Bot 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!

pygarap commented Jan 13, 2026

Uh oh!

ulgens commented Jan 14, 2026

Uh oh!

OJFord commented Jan 14, 2026

Uh oh!

ulgens commented Jan 17, 2026

Uh oh!

pygarap commented Jan 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

j178 commented Dec 23, 2025 •

edited

Loading

codecov Bot commented Dec 23, 2025 •

edited

Loading

github-actions Bot commented Dec 23, 2025 •

edited by prek-ci-bot Bot

Loading

pygarap commented Jan 17, 2026 •

edited

Loading