cff_git_hook: Use a Git pre-commit hook *[Experimental]*

In cffr: Generate Citation File Format ('CFF') Metadata

Use a Git pre-commit hook

Description

Install a pre-commit hook that reminds you to update your CITATION.cff file. This is a wrapper around usethis::use_git_hook().

Usage

cff_git_hook_install()

cff_git_hook_remove()

Details

This function installs a pre-commit hook using usethis::use_git_hook().

A pre-commit hook is a script that identifies simple issues before submission to code review. This pre-commit hook warns you if any of the following conditions are met:

• You included your DESCRIPTION or inst/CITATION file in a commit but did not include your CITATION.cff and the CITATION.cff file is "older" than your DESCRIPTION or inst/CITATION file.

• You updated your CITATION.cff but did not include it in your commit.

Value

Invisible. This function is called for its side effects.

A word of caution

The pre-commit hook may prevent you from committing if you are not updating your CITATION.cff. However, the detection mechanism is not perfect and may be triggered even if you have attempted to update your CITATION.cff file.

This typically occurs when you have updated your DESCRIPTION or inst/CITATION files, but those changes do not affect your CITATION.cff file, for example, when you add new dependencies.

In those cases, you can override the check by running ⁠git commit --no-verify⁠ in the terminal.

If you are using RStudio, you can also run this command from an R script by selecting that line and sending it to the terminal with:

• Windows & Linux: Ctrl+Alt+Enter.

• Mac: Cmd+Option+Return.

Removing the Git pre-commit hook

You can remove the pre-commit hook using cff_git_hook_remove().

See Also

• usethis::use_git_hook(), which is the underlying function used by cff_git_hook_install().

• usethis::use_git() and related functions of usethis for using Git with R packages.

Keep ‘CITATION.cff’ up to date: cff_gha_update()

Examples

## Not run: 
cff_git_hook_install()

## End(Not run)

cffr documentation built on Aug. 24, 2026, 5:11 p.m.