Skip to content

Add R language support#2206

Open
j178 wants to merge 2 commits into
masterfrom
r
Open

Add R language support#2206
j178 wants to merge 2 commits into
masterfrom
r

Conversation

@j178

@j178 j178 commented Jun 12, 2026

Copy link
Copy Markdown
Owner

Closes #42

Copilot AI review requested due to automatic review settings June 12, 2026 08:22
@j178 j178 added the enhancement New feature or request label Jun 12, 2026
@codecov

codecov Bot commented Jun 12, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 91.12903% with 22 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.62%. Comparing base (6166275) to head (1d28ebf).

Files with missing lines Patch % Lines
crates/prek/src/languages/r.rs 92.46% 18 Missing ⚠️
crates/prek/src/languages/mod.rs 20.00% 4 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##           master    #2206      +/-   ##
==========================================
+ Coverage   92.59%   92.62%   +0.03%     
==========================================
  Files         125      126       +1     
  Lines       26587    26784     +197     
==========================================
+ Hits        24617    24808     +191     
- Misses       1970     1976       +6     

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

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f8f313707a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/prek/src/languages/r.rs
Comment thread crates/prek/src/languages/r.rs

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds first-class support for running R hooks in prek, integrating R into the existing language framework (install/health-check/run), CI matrix, and documentation so R hooks can be installed and executed similarly to other supported languages.

Changes:

  • Implement R language backend (Rscript execution, env activation, remote renv restore, local additional deps install).
  • Add R integration tests and update CI/nextest configuration to provision R and schedule R tests.
  • Update docs to reflect R support and adjust language support messaging.

Reviewed changes

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

Show a summary per file
File Description
scripts/generate-ci-matrix.py Adds r to the CI language test matrix.
README.md Removes outdated note about some languages being unsupported.
docs/workspace.md Updates example output to show Markdownlint passing.
docs/reference/configuration.md Updates r language entry semantics to reflect the new backend.
docs/proposals/hook-shell.md Updates proposal docs for r entry semantics.
docs/languages.md Documents R support (Rscript + renv) and removes repetitive “Status” lines across languages.
docs/index.md Removes outdated note about unsupported languages.
crates/prek/tests/languages/unimplemented.rs Removes R “unimplemented language” test now that R is implemented.
crates/prek/tests/languages/r.rs Adds R integration tests (local hook, local deps, remote renv repo, language_version rejection).
crates/prek/tests/languages/main.rs Registers the new R test module.
crates/prek/src/languages/r.rs New R language implementation (install/check/run + entry validation).
crates/prek/src/languages/mod.rs Wires R into the language dispatcher and updates shell support messaging.
crates/prek/src/cli/run/run.rs Removes the “unimplemented language” skip path/status now that R is implemented.
crates/prek-consts/src/env_vars.rs Adds R-related env var constants (R_HOME, R_PROFILE_USER, RENV_PROJECT).
.github/workflows/ci.yml Installs R in CI when the r language group is selected.
.config/nextest.toml Adds CI override to serialize R tests due to shared cache/lock state.

Comment on lines +282 to +290
if entry[1] == "-e" {
if entry.len() > 3 {
anyhow::bail!("You can supply at most one expression");
}
} else if entry.len() > 2 {
anyhow::bail!(
"The only valid syntax is `Rscript -e {{expr}}` or `Rscript path/to/hook/script`"
);
}
Comment thread crates/prek/src/languages/r.rs
@prek-ci-bot

prek-ci-bot Bot commented Jun 12, 2026

Copy link
Copy Markdown

📦 Cargo Bloat Comparison

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

Expand for cargo-bloat output

Head Branch Results

 File  .text     Size             Crate Name
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_encrypt_avx512
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_decrypt_avx512
 0.4%   0.7%  95.8KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.7%  91.9KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.7%  89.9KiB              prek prek::languages::<impl prek::config::Language>::install::{{closure}}
 0.2%   0.5%  65.0KiB             prek? <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  49.6KiB              prek prek::run::{{closure}}
 0.2%   0.4%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.3%  43.6KiB              prek prek::cli::run::run::run::{{closure}}
 0.2%   0.3%  43.1KiB             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%  32.6KiB               std core::ptr::drop_in_place<prek::languages::<impl prek::config::Language>::install::{{closure}}>
 0.1%   0.2%  31.9KiB             prek? <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  29.4KiB     granit_parser granit_parser::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.8KiB             prek? <prek::config::_::<impl serde_core::de::Deserialize for prek::config::RemoteHook>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble
 0.1%   0.2%  26.1KiB              prek prek::cli::try_repo::try_repo::{{closure}}
 0.1%   0.2%  23.8KiB             prek? <prek::config::_::<impl serde_core::de::Deserialize for prek::config::LocalHook>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2%  22.9KiB     granit_parser granit_parser::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  22.3KiB         [Unknown] Lp384_montjscalarmul_alt_p384_montjadd
41.9%  86.2%  11.2MiB                   And 24372 smaller methods. Use -n N to show more.
48.6% 100.0%  13.0MiB                   .text section size, the file size is 26.6MiB

Base Branch Results

 File  .text     Size             Crate Name
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_encrypt_avx512
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_decrypt_avx512
 0.4%   0.7%  95.4KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.7%  90.7KiB              prek prek::languages::<impl prek::config::Language>::run::{{closure}}::{{closure}}
 0.3%   0.6%  85.1KiB              prek prek::languages::<impl prek::config::Language>::install::{{closure}}
 0.3%   0.6%  79.4KiB             prek? <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  49.7KiB              prek prek::run::{{closure}}
 0.2%   0.4%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.3%  44.6KiB              prek prek::cli::run::run::run::{{closure}}
 0.2%   0.3%  43.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%  32.0KiB               std core::ptr::drop_in_place<prek::languages::<impl prek::config::Language>::install::{{closure}}>
 0.1%   0.2%  31.8KiB             prek? <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  29.4KiB     granit_parser granit_parser::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  28.3KiB             prek? <prek::config::_::<impl serde_core::de::Deserialize for prek::config::RemoteHook>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble
 0.1%   0.2%  26.2KiB              prek prek::cli::try_repo::try_repo::{{closure}}
 0.1%   0.2%  24.8KiB             prek? <prek::config::_::<impl serde_core::de::Deserialize for prek::config::LocalHook>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map
 0.1%   0.2%  22.9KiB     granit_parser granit_parser::scanner::Scanner<T>::fetch_more_tokens
 0.1%   0.2%  22.3KiB         [Unknown] Lp384_montjscalarmul_alt_p384_montjadd
41.8%  86.0%  11.1MiB                   And 24265 smaller methods. Use -n N to show more.
48.6% 100.0%  12.9MiB                   .text section size, the file size is 26.6MiB

@prek-ci-bot

prek-ci-bot Bot commented Jun 12, 2026

Copy link
Copy Markdown

⚡️ Hyperfine Benchmarks

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

Environment
  • OS: Linux 6.17.0-1018-azure
  • CPU: 4 cores
  • prek version: prek 0.4.4+46 (2e6f1d1 2026-06-12)
  • Rust version: rustc 1.96.0 (ac68faa20 2026-05-25)
  • 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.1 2.8 1.05 ± 0.07
prek-head --version 2.1 ± 0.1 2.0 2.5 1.00

prek list

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base list 9.6 ± 0.3 9.2 10.3 1.04 ± 0.04
prek-head list 9.2 ± 0.2 8.8 10.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.2 ± 0.1 3.1 3.3 1.08 ± 0.12
prek-head validate-config .pre-commit-config.yaml 3.0 ± 0.3 2.8 5.1 1.00

prek sample-config

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base sample-config 2.5 ± 0.0 2.4 2.7 1.05 ± 0.03
prek-head sample-config 2.4 ± 0.0 2.3 2.5 1.00
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 75.5 ± 2.0 73.1 78.7 1.01 ± 0.05
prek-head run --all-files 74.8 ± 3.3 71.7 80.6 1.00

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

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run --all-files 75.7 ± 3.3 72.3 84.1 1.02 ± 0.06
prek-head run --all-files 74.4 ± 2.9 71.3 81.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 74.6 ± 3.0 70.6 81.8 1.00
prek-head run --all-files 75.0 ± 3.2 70.5 81.7 1.01 ± 0.06
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.4 ± 0.4 19.6 21.1 1.02 ± 0.04
prek-head run trailing-whitespace --all-files 20.0 ± 0.6 19.2 22.0 1.00

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 25.3 ± 1.5 23.4 29.2 1.00
prek-head run end-of-file-fixer --all-files 26.0 ± 2.0 23.3 30.6 1.03 ± 0.10

prek run check-json --all-files

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run check-json --all-files 7.7 ± 0.2 7.4 8.0 1.02 ± 0.04
prek-head run check-json --all-files 7.5 ± 0.2 7.2 7.9 1.00

prek run check-yaml --all-files

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run check-yaml --all-files 7.6 ± 0.1 7.4 7.8 1.03 ± 0.03
prek-head run check-yaml --all-files 7.4 ± 0.2 7.2 7.9 1.00

prek run check-toml --all-files

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run check-toml --all-files 7.8 ± 0.3 7.2 8.3 1.03 ± 0.05
prek-head run check-toml --all-files 7.5 ± 0.3 7.2 8.3 1.00

prek run check-xml --all-files

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run check-xml --all-files 7.8 ± 0.2 7.3 8.1 1.01 ± 0.06
prek-head run check-xml --all-files 7.7 ± 0.4 7.1 9.2 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 14.1 ± 1.3 12.4 16.9 1.03 ± 0.13
prek-head run detect-private-key --all-files 13.7 ± 1.2 11.7 16.0 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 18.9 ± 0.9 17.3 20.3 1.00
prek-head run fix-byte-order-marker --all-files 19.0 ± 0.9 17.5 20.2 1.00 ± 0.07
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.0 4.5 4.6 1.03 ± 0.02
prek-head install-hooks 4.4 ± 0.1 4.4 4.5 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.01 ± 0.03
prek-head install-hooks 4.6 ± 0.1 4.4 4.8 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 37.2 ± 0.8 36.3 39.5 1.00
prek-head run 37.6 ± 1.4 36.0 40.1 1.01 ± 0.04

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

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run --files '*.json' 8.0 ± 0.1 7.8 8.3 1.02 ± 0.03
prek-head run --files '*.json' 7.8 ± 0.2 7.6 8.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 6.9 ± 0.1 6.8 7.1 1.04 ± 0.02
prek-head run --dry-run --all-files 6.6 ± 0.1 6.5 6.7 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 12.0 ± 0.1 11.8 12.2 1.02 ± 0.03
prek-head run check-hooks-apply --all-files 11.8 ± 0.3 11.6 12.5 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 19.2 ± 22.2 10.7 93.4 1.84 ± 2.13
prek-head run check-useless-excludes --all-files 10.4 ± 0.1 10.2 10.7 1.00

✅ Performance improvement for prek run check-useless-excludes --all-files: 45.6300% faster

prek run identity --all-files

Command Mean [ms] Min [ms] Max [ms] Relative
prek-base run identity --all-files 9.8 ± 0.1 9.7 9.9 1.00 ± 0.03
prek-head run identity --all-files 9.8 ± 0.2 9.5 10.2 1.00

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a596e4c79f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +108 to +112
Cmd::new(rscript_executable(), "check Rscript version")
.arg("--version")
.check(true)
.output()
.await

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Record the R version before accepting cached envs

When an R hook environment has already been installed and the system R selected by PATH/R_HOME is later upgraded, this health check still reports the cache as healthy as long as some Rscript exists. The environment was restored into renv's R-versioned library for the old interpreter, so compiled packages can be reused with an incompatible R instead of triggering a reinstall; install should persist getRversion() and compare it here before reusing the env.

Useful? React with 👍 / 👎.

Copilot AI review requested due to automatic review settings June 12, 2026 10:02

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1d28ebfb45

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +136 to +139
let activate = env_path.join("activate.R");
if activate.exists() {
cmd.env(EnvVars::R_PROFILE_USER, activate);
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Set R_PROFILE_USER for local hooks without dependencies

For local R hooks that do not declare additional_dependencies, no activate.R is written during install, so this branch leaves R_PROFILE_USER unset while still omitting --no-init-file from the Rscript command. In that case Rscript can source the repository's .Rprofile (or the user's home profile), even though the R backend is meant to emulate a clean startup; a project profile that changes .libPaths(), options, or exits can make a bare language: r hook behave differently from the same hook under pre-commit. Set R_PROFILE_USER to a controlled empty/activation file or pass --no-init-file when there is no activation profile.

Useful? React with 👍 / 👎.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 16 out of 16 changed files in this pull request and generated 3 comments.

Comment on lines +126 to +131
let entry = r_hook_entry(hook)?;
let env_path = hook.env_path().expect("R must have env path");

let run = async |batch: &[&Path]| {
let mut cmd = Cmd::new(&entry[0], "run R hook");
cmd.current_dir(hook.work_dir())
Comment on lines +289 to +293
if entry[1] == "-e" {
if entry.len() > 3 {
anyhow::bail!("You can supply at most one expression");
}
} else if entry.len() > 2 {
Comment on lines +350 to +354
#[test]
fn validate_r_entry_allows_supported_forms() {
validate_r_entry(&["Rscript".into(), "-e".into(), "1+1".into()]).unwrap();
validate_r_entry(&["Rscript".into(), "hook.R".into()]).unwrap();
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support r language

2 participants