NEWS.md
Thanks to all who contributed to this release: @boxydog, @hadley, @IndrajeetPatil, @jcken95, @jeancochrane, @jrdnbradford, @lorenzwalthert, @owenjonesuob, and @TymekDev.
Release relax the dependency on third-party error messages in our unit tests (#555).
This release ensures unit tests can handle the error messages from {styler} correctly that were modified slightly. Apart from hook dependency updates, this release adds no user-facing changes.
Thanks @joshpersi for contributing to this release.
Apart from two new hooks, many bug fixes and a few minor features, this release focused on improving the user experience when installing the hooks, which caused users the most troubles. We enabled fast hook installation without the need for build time or system dependencies on all platforms thanks to the Posit Package Manager and removal of dependencies {git2r} and {digest}.
Features
no-print-statement discovers and check for rogue print statements (#505).pkgdown runs pkgdown::check_pkgdown() to ensure the {pkgdown} config is valid (#393).codemeta-description-updated, roxygenize, and use-tidy-description now all support a root argument that specifies the directory in the git repo that contains the R package. Defaults to . since for most R package git repos, the git and R package root coincide (#432, #438).style-files now supports styling of R code in Quarto docs (#449).style-files now supports file names with spaces (#516).Bug Fixes
spelling::update_wordlist (#514).Documentation
use_ci() is now documented to take NA, not NULL for argument ci (#431).Dependencies
Infrastructure
ubuntu-latest instead of pinned version for tests (#481).read-only flag for testing (#529).Other
Changelog from dev releases is collapsed into this patch release at the time this release is created. If you need releases by dev release, i.e. 0.3.2.x, checkout this file at git tag v0.3.2.9020.
A big thanks goes to all people who made this release reality:
@AliSajid, @averissimo, @clarkliming, @danielinteractive, @denn173, @dependabot[bot], @EzicJ, @fabianegli, @hadley, @IndrajeetPatil, @jashapiro, @joelnitta, @jonathanckt, @jsnel, @kcphila, @KoderKow, @KyleDCox, @lorenzwalthert, @m-muecke, @mythichamster, @ns-rse, @pre-commit-ci[bot], @russHyde, @sempwn, @stefanoborini, @thefabnab, @TNonet, @TymekDev, and @yogat3ch.
parsable-R hook now gives more context on where and how parsing fails (#423).Thanks to @danielinteractive, @jonocarroll for their contributions.
User visible changes
.pre-commit-config.yaml templates now contain hook to validate the pre-commit.ci configuration (#407).Bug fixes
spell-check hook is case-insensitive on all operating systems. This may re-order your whole inst/WORDLIST (#405).forbid-to-commit in template .pre-commit-config.yaml has now the correct exclude-files regular expression to ignore .csv, .RData, .Rds, .rds and .Rhistory (#410).Internals
options(install.packages.compile.from.source = "never") is used in the CI to avoid failing builds due to missing build-time deps (#412).Thanks to @danielinteractive and @mpadge for their contributions.
API changes
style-files hook now takes ignore-start and ignore-stop arguments, passed to options("styler.ignore_start") and options("styler.ignore_stop"). By default, {styler} defaults are used.use_precommit() now exposes the argument autoupdate, defaulting to TRUE (which was the previous behavior). This tells {precommit} whether or not to run autoupdate() as part of the former function invocation (#386).New features
no-debug-statement checks for leftover debug() and debugonce() statements in the committed code (#385, @lukasfeick-sw)..pre-commit-config.yaml does now include the hook file-contents-sorter to sort .Rbuildignore (#366)..pre-commit-config.yaml default to monthly hook updates (instead of weekly) to avoid notification triggers and git version convolution (#370).language: r (#350).Documentation
Bug fixes
R as a dependency with snippet_generate("additional-deps-roxygenize") (#358).roxygenize hook now fails if it generates an .Rd file that is not tracked with version control (#363).deps-in-desc and parsable-R can now handle code chunk headers with where purl or eval are not literals like TRUE, but variables defined elsewhere in code (#361, #382).deps-in-desc now prints the original file (not a tempfile) also for .Rmd and .Rnw files.Thanks to all people who contributed to this release: @assignUser, @danhalligan, @gravesti, @hadley, @KyleDCox, @lorenzwalthert, @lukasfeick-sw, @MarkMc1089, @pat-s, @RoyalTS, and @smingerson.
This is a maintenance release on the request of CRAN (#337) and to improve experience with the language: r switch conducted in v0.2.0. In particular, note that projects using {renv} and RStudio are not very compatible with hook versions > 0.1.3.9014 and autoupdate() results in downgrading the hook versions (#346).
API Changes
--no-warn-cache in the style-files and the roxygenize hook is deprecated and will be removed in a future release. Please remove it from your .pre-commit-config.yaml (#340. #341).Other changes
style-files hook fails more informatively if required package is not listed in additional_dependencies: (#333).deps-in-desc always excludes README.md (#336).roxygenize problem handling (#338).snippet_generate("additional-deps-roxygenize") (#344)Thanks to all people who contributed to this release:
@lorenzwalthert, @pat-s, and @smingerson.
This version marks the switch to language: r of all existing hooks. This means two things:
pre-commit >= 2.11.1 (ideally even >= 2.13.0). See *Installation/Update** below (#233, #250, #260, #264, #273, #315, #313, #308, #301, #300, #295, #285, #328).style-files). See vignette("ci") for a comparison of the two services (#318).API changes
use_precommit() gains a new argument ci defaulting to "native" (for pre-commit) to set up continuous integration. Other allowed values are "gha" (forNULL (for no CI).use_ci(ci = "native") can be used to set up continuous integration for existing repos. The default behavior for ci for both functions is governed by the R option precommit.ci.version_precommit() and update_precommit() are new functions to check the version of the installed pre-commit executable and to update it (#197).style-files hook gains an argument --cache-root that is passed to options(styler.cache_root = ...) (#305).style-files hook now supports the full style_file() API, e.g. you can supply --scope=spaces and similar via args: in your .pre-commit-config.yaml. See the docs for details.style-files and roxygenize hooks now warn if there is no permanent R.cache cache set up. You can silence the warning with the hook argument --no-warn-cache (#225).Installation/Update
Please follow the update instructions or installation instructions depending on whether or not you previously used pre-commit.
Major changes
roxygenize hook runs pkgload::load_all(), you need to list all dependencies of your package in additional_dependencies field in .pre-commit-config.yaml. You will be prompted to add them if they are missing, precommit::snippet_generate("additional-deps-roxygenize") generates the code you can copy/paste (#247, #248, #249).parsable-R hook can now also parse .Rmd files (#325).use_precommit(..., install_hooks = TRUE) is no longer blocking by default. New option precommit.block_install_hooks (defaults to FALSE) governs the behavior (#312).inst/WORDLIST (#303)..lintr and .gitlab-ci.yml are not ignored in the spell check hook (#317).Unknown or uninitialised column: text (#268).deps-in-desc now checks .Rprofile, .Rmd and .Rnw files in addition to .R files (#216)..Rmd, .Rnw and .Rprofile files (#287)..png, .jpeg, .pdf and files in .github/workflows are no longer spell-checked in the template config file (#276).Minor changes
fs >= 1.5.1 (#330).exclude: pattern of the spell check hook are now ordered alphabetically (#276).deps-in-desc hook now points to the hook argument --allow_private_imports when the hook fails due to private imports (#254).lorenzwalthert/precommit. This does not affect users directly (#430).A big hand to all the contributors of this release:
@adamblake, @arbues6, @b4D8, @bart1, @dhersz, @joelnitta, @jucor, @lorenzwalthert, @lukasfeick-sw, @MarkMc1089, @njtierney, @pat-s, @pwildenhain, and @rossdrucker
For previous versions of NEWS.md with news bullet per patch release, see the latest NEWS.md before gathering.
This is mainly a CRAN maintenance release because of #201 and includes some bug fixes and no API changes.
A big hand to all the contributors of this release: @fschoner, @krzyslom, @lorenzwalthert, @maurolepore, @pat-s, and @zkamvar.
Minor Changes
use_precommit() should now work as expected (#185).use_precommit() now writes to the right .Rbuildignore when root is not the current working directory (#188, @krzyslom).precommit::uninstall_precommit() now correctly removes ^\\.pre-commit-config.yaml$from .Rbuildignore and does not show a prompt (#199).Initial CRAN release. See https://lorenzwalthert.github.io/precommit/.
Major Changes
use_precommit() gains new install_hooks = TRUE parameter. Now all hook environments defined in yaml config are by default installed in advance. (#163)Breaking Changes
uninstall_precommit()’s scope argument value "global" was renamed to "user".Major Changes
.pre-commit-config-config.yaml for the spell check hook for easy manipulation. Also, additional patterns were excluded such as .sh (#157).Minor Changes
DESCRIPTION now links the pkgdown website in addition to the GitHub repo (#155)..Renviron, .Rrofile, .RData, .feather and .Rds is now also excluded from the spell checking hook.Breaking Changes
A major API review was conducted to make the package ready for a CRAN submission in #152:
path_root renamed to root.root now always defaults to here::here() for consistency.config_source was renamed to config_source in use_precommit_config() and use_precommit().use_precommit_config’s argument force gains a default value for consistency with use_config().use_precommit_config’s argument verbose now is in the same position as in use_config().Additional breaking changes are:
r-precommit instead of r-reticulate to avoid conflicts with other packages commonly installed in r-reticulate (#147).spell-check does no longer take the hook argument ignore-files since this was inconsistent with the pre-commit framework. To exclude additional files, specify the exclude: key in your .pre-commit-config.yaml file. If you like to keep excluding the default files, make sure you include the default regex (#153).use_precommit() gains new argument config_source to copy an existing config file into the repo at initialization. The argument defaults to options('precommit.config_source') to make it easy for users to use their preferred hooks in every repo they initialize (#111).r-precommit env if not existent before installing into it (#114)..pre-commit-config.yaml includes hook to check files have a EOF blank line (#126).path_pre_commit_exec() in favor of path_precommit_exec() and adapt internals to replace pre_commit with precommit (#130).BREAKING: If you used precommit < 0.0.0.9017 (and if you choose a different installation strategy than precommit::install_precommit()), you can link your existing executable by setting the R optionprecommit.executable` to the path where you stored the pre-commit executable.
Adding tools to work with hooks: install_precommit(), use_precommit(), uninstall_precommit(), open_config() and open_wordlist() using conda environments on all platforms.
Make repo a fully R CMD CHECK compliant R package (includes moving hooks to inst/bin from bin.)
renamed repo from pre-commit-hooks to precommit.
added pkgdown website, restructured README.