Add deny-filename-pattern and require-filename-pattern hooks

[j178]

Add generic deny-filename-pattern and require-filename-pattern hooks for basename-only regex validation, covering the use case discussed in #2484.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.60%. Comparing base (97148cb) to head (77628b1).

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2488      +/-   ##
==========================================
+ Coverage   93.59%   93.60%   +0.01%     
==========================================
  Files         131      131              
  Lines       28275    28342      +67     
==========================================
+ Hits        26463    26530      +67     
  Misses       1812     1812              

☔ View full report in Codecov by Harness.
📢 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.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

Adds two new builtin hooks (deny-filename-pattern and require-filename-pattern) that validate selected files based on basename regex matching (without reading file contents), enabling generic naming-policy enforcement (including the use case discussed in #2484).

Changes:

• Register new builtin hook IDs in the schema, builtin registry, and list_builtins outputs.
• Implement basename-only pattern matching hooks in builtin_hooks::pattern.
• Document both hooks and their arguments/examples in docs/builtin.md.

Reviewed changes

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

Show a summary per file

File	Description
prek.schema.json	Adds the new builtin hook IDs to the schema enum list.
docs/builtin.md	Documents the new hooks, arguments, and examples.
crates/prek/tests/list_builtins.rs	Updates expected builtin listing outputs to include the new hooks.
crates/prek/tests/builtin_hooks.rs	Adds integration tests for basename-only deny/require filename matching behavior.
crates/prek/src/hooks/builtin_hooks/pattern.rs	Implements deny-filename-pattern / require-filename-pattern and shares regex builder logic.
crates/prek/src/hooks/builtin_hooks/mod.rs	Wires new hooks into the builtin registry, flags/help, and execution dispatch.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[prek-ci-bot]

📦 Cargo Bloat Comparison

Binary size change: +0.00% (29.8 MiB → 29.8 MiB)

Expand for cargo-bloat output

Head Branch Results

 File  .text     Size             Crate Name
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_encrypt_avx512
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_decrypt_avx512
 0.3%   0.6%  84.6KiB              prek <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  57.6KiB              prek prek::run::{closure#0}
 0.2%   0.4%  56.1KiB              prek <<prek::config::Config as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.2%   0.3%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.3%  45.9KiB              prek <prek::languages::ruby::installer::RubyInstaller>::install::{closure#0}
 0.1%   0.3%  38.6KiB              prek prek::cli::run::run::run::{closure#0}
 0.1%   0.2%  35.0KiB              prek <prek::languages::node::installer::NodeInstaller>::install::{closure#0}
 0.1%   0.2%  34.3KiB              prek <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  32.8KiB              prek <prek::languages::golang::installer::GoInstaller>::install::{closure#0}
 0.1%   0.2%  31.5KiB              prek <prek::languages::bun::installer::BunInstaller>::install::{closure#0}
 0.1%   0.2%  30.1KiB     granit_parser <granit_parser::scanner::Scanner<granit_parser::input::str::StrInput>>::fetch_more_tokens
 0.1%   0.2%  28.6KiB    cargo_metadata <&mut serde_json::de::Deserializer<serde_json::read::StrRead> as serde_core::de::Deserializer>::deserialize_struct::<<cargo_metadata::Package as serde_core::de::Deserialize>::deserialize::__Visitor>
 0.1%   0.2%  28.4KiB              prek <<prek::config::RemoteHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble
 0.1%   0.2%  27.1KiB              prek <prek::languages::deno::installer::DenoInstaller>::download::{closure#0}
 0.1%   0.2%  25.4KiB              prek prek::cli::try_repo::try_repo::{closure#0}
 0.1%   0.2%  25.2KiB              prek <<prek::config::LocalHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
42.4%  88.0%  12.6MiB                   And 26358 smaller methods. Use -n N to show more.
48.1% 100.0%  14.3MiB                   .text section size, the file size is 29.8MiB

Base Branch Results

 File  .text     Size             Crate Name
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_encrypt_avx512
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_decrypt_avx512
 0.3%   0.6%  84.6KiB              prek <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  57.5KiB              prek prek::run::{closure#0}
 0.2%   0.4%  55.9KiB              prek <<prek::config::Config as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.2%   0.3%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.1%   0.3%  38.6KiB              prek prek::cli::run::run::run::{closure#0}
 0.1%   0.2%  34.3KiB              prek <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  32.8KiB              prek <prek::languages::ruby::installer::RubyInstaller>::install::{closure#0}
 0.1%   0.2%  30.1KiB     granit_parser <granit_parser::scanner::Scanner<granit_parser::input::str::StrInput>>::fetch_more_tokens
 0.1%   0.2%  28.6KiB    cargo_metadata <&mut serde_json::de::Deserializer<serde_json::read::StrRead> as serde_core::de::Deserializer>::deserialize_struct::<<cargo_metadata::Package as serde_core::de::Deserialize>::deserialize::__Visitor>
 0.1%   0.2%  28.4KiB              prek <<prek::config::RemoteHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble
 0.1%   0.2%  26.9KiB              prek <prek::languages::deno::installer::DenoInstaller>::download::{closure#0}
 0.1%   0.2%  25.4KiB              prek prek::cli::try_repo::try_repo::{closure#0}
 0.1%   0.2%  25.0KiB              prek <<prek::config::LocalHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  24.9KiB               xml <xml::reader::parser::PullParser>::dispatch_token
 0.1%   0.2%  24.2KiB              prek <<prek::config::UpdateOptions as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  24.0KiB     granit_parser <granit_parser::scanner::Scanner<serde_saphyr::de::buffered_input::ReaderInput>>::fetch_more_tokens
42.4%  88.2%  12.6MiB                   And 26396 smaller methods. Use -n N to show more.
48.1% 100.0%  14.3MiB                   .text section size, the file size is 29.8MiB

[prek-ci-bot]

⚡️ Hyperfine Benchmarks

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

Environment

• OS: Linux 6.17.0-1020-azure
• CPU: 4 cores
• prek version: prek 0.4.12+8 (eb866e7 2026-08-06)
• Rust version: rustc 1.97.1 (8bab26f4f 2026-07-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.3 ± 0.1	2.2	2.6	1.04 ± 0.08
prek-head --version	2.2 ± 0.1	2.0	3.0	1.00

prek list

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base list	9.8 ± 0.7	9.3	16.1	1.04 ± 0.09
prek-head list	9.4 ± 0.4	9.1	12.1	1.00

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

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base validate-config .pre-commit-config.yaml	3.4 ± 0.0	3.3	3.5	1.07 ± 0.05
prek-head validate-config .pre-commit-config.yaml	3.2 ± 0.1	3.0	3.8	1.00

prek sample-config

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base sample-config	2.8 ± 1.4	2.5	12.6	1.15 ± 0.58
prek-head sample-config	2.5 ± 0.1	2.3	2.6	1.00

✅ Performance improvement for prek sample-config: 13.1800% faster

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	40.4 ± 1.2	39.0	42.9	1.01 ± 0.05
prek-head run --all-files	40.1 ± 1.4	38.5	42.6	1.00

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

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	40.1 ± 0.7	39.1	41.5	1.01 ± 0.04
prek-head run --all-files	39.8 ± 1.3	37.6	41.9	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	40.0 ± 1.1	37.3	42.5	1.02 ± 0.04
prek-head run --all-files	39.2 ± 1.1	36.7	41.9	1.00

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	13.4 ± 0.3	12.9	14.1	1.00
prek-head run trailing-whitespace --all-files	13.5 ± 0.5	12.8	14.9	1.01 ± 0.05

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	11.4 ± 0.3	11.0	12.1	1.01 ± 0.06
prek-head run end-of-file-fixer --all-files	11.3 ± 0.6	10.5	12.6	1.00

prek run check-json --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-json --all-files	8.1 ± 0.2	7.7	8.7	1.03 ± 0.05
prek-head run check-json --all-files	7.9 ± 0.3	7.3	8.8	1.00

prek run check-yaml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-yaml --all-files	7.8 ± 0.1	7.5	8.1	1.02 ± 0.03
prek-head run check-yaml --all-files	7.7 ± 0.1	7.5	8.0	1.00

prek run check-toml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-toml --all-files	8.0 ± 0.3	7.4	8.6	1.05 ± 0.04
prek-head run check-toml --all-files	7.6 ± 0.2	7.3	8.0	1.00

prek run check-xml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-xml --all-files	8.1 ± 0.5	7.4	9.3	1.04 ± 0.10
prek-head run check-xml --all-files	7.8 ± 0.6	7.2	9.5	1.00

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

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run detect-private-key --all-files	11.4 ± 0.5	10.6	12.7	1.02 ± 0.08
prek-head run detect-private-key --all-files	11.2 ± 0.8	10.2	13.8	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	13.6 ± 0.8	12.5	15.2	1.05 ± 0.08
prek-head run fix-byte-order-marker --all-files	12.9 ± 0.6	12.0	14.6	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.6 ± 0.1	4.5	4.7	1.05 ± 0.02
prek-head install-hooks	4.4 ± 0.1	4.3	4.4	1.00

prek install-hooks (warm - with cache)

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

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	24.1 ± 0.3	23.6	24.7	1.00 ± 0.02
prek-head run	24.1 ± 0.4	23.5	25.2	1.00

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

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --files '*.json'	5.5 ± 0.1	5.3	5.7	1.07 ± 0.02
prek-head run --files '*.json'	5.1 ± 0.1	5.0	5.2	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	7.2 ± 0.1	7.0	7.5	1.05 ± 0.03
prek-head run --dry-run --all-files	6.8 ± 0.1	6.7	7.3	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	8.4 ± 0.1	8.3	8.7	1.03 ± 0.02
prek-head run check-hooks-apply --all-files	8.2 ± 0.1	7.9	8.3	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	8.4 ± 0.2	8.2	8.7	1.04 ± 0.02
prek-head run check-useless-excludes --all-files	8.1 ± 0.1	7.9	8.4	1.00

prek run identity --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run identity --all-files	7.2 ± 0.1	7.1	7.4	1.03 ± 0.02
prek-head run identity --all-files	7.0 ± 0.1	6.9	7.3	1.00

[Copilot]

Pull request overview

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

Suppressed comments (1)

docs/builtin.md:119

• The linked issue #2484 requests a Rust-native builtin hook name-tests-test (with specific default files filter and naming-mode args). This PR adds generic deny-filename-pattern / require-filename-pattern hooks, but does not add name-tests-test to the builtin registry/schema/docs, so it doesn’t satisfy the issue’s required behavior as written. Either implement name-tests-test (possibly using these helpers) or adjust the PR/issue scope so the mismatch is explicit.

- [`check-vcs-permalinks`](#check-vcs-permalinks) (Ensures that links to VCS websites are permalinks.)
- [`check-yaml`](#check-yaml) (Checks YAML files for parseable syntax.)
- [`check-xml`](#check-xml) (Checks XML files for parseable syntax.)
- [`deny-filename-pattern`](#deny-filename-pattern) (Fails if any selected filename matches a regular expression.)
- [`deny-pattern`](#deny-pattern) (Fails if any file contains a matching regular expression.)
- [`require-filename-pattern`](#require-filename-pattern) (Fails if any selected filename does not match a regular expression.)
- [`require-pattern`](#require-pattern) (Fails if any file does not contain a matching regular expression.)