Skip to content

goodpractice

1.2.0Package record

Advice on R Package Building

1packages dependsuggested by 3
16.6Kdownloads / year
98.4%test coverage
13/13flavors OK

Overview

About

Give advice about good practices when building R packages. Advice includes functions and syntax to avoid, package structure, code complexity, code formatting, etc.

Changes in 1.2.0

Major changes

  • Require R version >= 4.3, because of treesitter dependency (#302; thanks to @christian-million)
  • New use_skill_gp() and learn_skill_gp() functions, plus a bundled goodpractice4agents.md skill in inst/skills/, giving AI agents instructions to fix issues flagged by goodpractice (#308, #312, #313; thanks to @mpadge, @drmowinckels, and @jonthegeek).
  • New vignette, "'goodpractice' for developers" describing Makefile (#305), and overall check structure.

Minor changes

  • New GitHub issue templates for bug reports and feature requests
  • complexity_unused_internal check no longer flags standard R package hook functions (.onLoad, .onAttach, .onUnload, .onDetach, .Last.lib) as unused (#319; thanks @TanguyBarthelemy).
  • Fix urlchecker prep step to pass fail = FALSE to urlchecker::url_check(), restoring previous default behaviour after an upstream change (r-lib/urlchecker#42).
  • .Rprofile now sources the system-level ~/.Rprofile if it exists, rather than entirely replacing it.
  • Fix test-integrity.R to only read .R source files (avoiding installed .rdb binaries) and skip informatively when none are found.
  • tidyverse_r_file_names: allow file names containing hyphens (-) but require file extension .R (#307; thanks to @JesseAlderliesten).
  • Fix bug in check group exclusions through env vars, and update vignette.
Show all changes in 1.2.0Hide the rest of the changes in 1.2.0
  • Fix prep assignment to check groups for two checks (revdep + 1 tidyverse), including attaching "namespace" prep only internally to one of those so full tidyverse prep stage is only run for that group.
  • Fix bug in printing some check results that would produce an error caused by invalid marker types (#304; thanks to @JesseAlderliesten).
  • Convert the remaining base warning() in ts_parse() to cli::cli_warn(), completing the package-wide move to cli messaging.

---

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 8.2 min · r-devel-windows-x86_64
Status changes
  • OK13 OK2026-09-05
  • ERROR12 OK, 1 ERROR2026-08-21
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-10
Show 3 earlier changesHide 3 earlier changes
  • NOTE12 OK, 1 NOTE2026-06-09
  • ERROR11 OK, 1 NOTE, 1 ERROR2026-06-08
  • NOTE12 OK, 2 NOTE2026-03-10
Advisories

none known

Documentation

In release 1.2.0
READMEYes · 1,108 wordsVignettesYes · 3 · dynamicNEWSYes · 67% structured · mentions 1.2.0Citation fileNoWebsiteYes · pkgdown
Help pages
18includes a package overview page
Examples that run
94%15 run in a plain check · 1 never run
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
0%

Downloads

16.6K
CRAN downloads in the past year
Rank #3,084 · ~45/day · ~1.4K/mo
Daily download trend is not available in this view yet.
1.6K30 days
4.2K90 days
16.6K1 year
Compare downloads with other packages →
Also on260 r2u5 autocran1.3K conda_forge

Repository

482Stars
35Forks
6Open issues
0Open PRs
6Releases
672Commits
24Commit identities
672 commits · Last activity 2026-10-14 · +0.2% stars, 30d · Default branch at 1.2.0.001, ahead of CRAN 1.2.0 (checked 2026-10-11)
Responsiveness
How these are sampled
PRs merged (all time)
90%
Median days to close, 50 most recently updated closed issues
23
Median days to close, 50 most recently updated closed PRs
1

Stars over time

2025-08-08 · 4702026-10-17 · 482
PracticesBeta

13 development-tooling and community-health practices detected across 8 families in the upstream repository

Checks run against github.com/ropensci-review-tools/goodpractice on 2026-10-11.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (3)
Code of conduct (inherited from ropensci-review-tools)Contributing guideIssue templates
Docs source (3)
README.Rmdpkgdown

GitHub Pages site last deployed 2022-07-13

Coverage (1)
Coverage reporting
Show all practicesHide 4 practices
Reproducibility and dev environment (1)
Makefile
CRAN release process (1)
cran-comments.md
Research and citation (1)
codemeta.json
For agents and models (1)
Agent skills
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-02-13
    Named in .Rbuildignore: .claude
    Pull request it wrote: opened by a project member
    Commits: at least 132 crediting it in the message
Shared conventions any agent may read, so they name no particular tool.
Seen in the repository: AGENT.md
From outside contributors
  • Claude Code
    Pull requests: 32 from outside contributors, first on 2026-02-13, 32 from forks
Models named in its commits
  • Claude Opus 4.6100 commits · Feb to Mar 2026

Some of these counts are a minimum, because the search stopped before the oldest commits.

Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
23 external dependencies (excludes base and recommended)

Installing goodpractice adds 56 packages (25 with compiled code, 18 MB of source tarballs). Heaviest: hunspell 3.1 MB, Rcpp 1.8 MB, fs 1.4 MB.

Depends (1)
R >= 4.3.0
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
1direct
0indirect
Imports 1
Suggested by 3
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

People & History

People (11)
Author, Maintainer since 1.0.5 (2024) · added in 1.0.5
Author · added in 1.0.3
Author · added in 1.0.3
owenjonesuob
Author · added in 1.0.3
KarinaMarks
Author · added in 1.1.0
drmowinckels
Author · added in 1.0.3
ddbortoli
Contributor · added in 1.0.3
fabian-s
Contributor · added in 1.0.3
anasimmons
Copyright holder · added in 1.0.3
MangoTheCat

Previously maintained by Karina Marks (1.0.3 to 1.0.4) and Hannah Frick (1.0.2).

Releases (6)

Pick two releases to compare their code metrics.

  • 1.2.0Latest
    record
    2026-08-31 · current release · diff ↗ ·
    added 2 exports
    learn_skill_gp, use_skill_gp
  • 1.1.0
    record
    2026-06-05 · diff ↗ ·
    added 6 exports
    all_check_groups, checks_by_group, default_checks, describe_check, describe_check_groups, tidyverse_checks
  • R
    R 4.6.0 released · 2026-04-24
  • R
    R 4.5.0 released · 2025-04-11
  • unarchivedReturned to CRAN
    2024-06-04
  • 1.0.5
    record
    2024-06-04 · diff ↗
  • R
    R 4.4.0 released · 2024-04-24
  • archivedRemoved from CRAN
    2024-04-20
    issues were not corrected despite reminders
  • R
    R 4.3.0 released · 2023-04-21
  • 1.0.4
    record
    2022-08-30 · diff ↗
  • unarchivedReturned to CRAN
    2022-07-13
  • 1.0.3
    record
    2022-07-13 · diff ↗
  • archivedRemoved from CRAN
    2022-04-27
    check issues were not corrected in time length > 1 in && or ||
  • R
    R 4.2.0 released · 2022-04-22
  • R
    R 4.1.0 released · 2021-05-18
  • R
    R 4.0.0 released · 2020-04-24
Show 3 earlier eventsHide 3 earlier events
  • R
    R 3.6.0 released · 2019-04-26
  • 1.0.2
    record
    2018-05-02
  • R
    R 3.5.0 released · 2018-04-23

Package metadata

First published
2018-05-02
Total releases
6 / 8 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.3.0
Download size
175 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("goodpractice")
Padgham, M., Ascent Digital Services UK Limited, Alexander, H., Csardi, G., Frick, H., Jones, O., Marks, K., Mowinckel, A. M., Scheipl, F., Simmons, A., & de Bortoli, D. (2026). goodpractice: Advice on R Package Building (Version 1.2.0) [Computer software]. https://doi.org/10.32614/CRAN.package.goodpractice

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for goodpractice version 1.2.0 [Data set]. HJJB, LLC. Data release v2026-10-19. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy