Skip to content

sumExtras

1.0.0Package record

Extra Functions for 'gtsummary' Table Styling

0packages depend
2.2Kdownloads / year
91.8%test coverage
13/13flavors OK

Overview

About

Provides additional convenience functions for 'gtsummary' (Sjoberg et al. (2021) doi:10.32614/RJ-2021-053) & 'gt' tables, including automatic variable labeling from dictionaries, standardized missing value display, and consistent formatting helpers for streamlined table styling workflows.

Changes in 1.0.0

Breaking Changes

  • Removed apply_labels_from_dictionary(). Use attr(data$var, "label") <- "Label" directly, or the {labelled} package for bulk attribute labeling.

New Features

  • extras() auto-labeling via options(sumExtras.auto_labels = TRUE) and (recommended) options(sumExtras.prefer_dictionary = TRUE). See vignette("options").
  • extras() now bolds significant p-values (bold_p()) automatically when p-values are added.
  • New header parameter in extras() controls the label column header text (default "").
  • New symbol parameter in clean_table() and extras() controls the missing value replacement string (default "---").
  • add_group_colors() now accepts a vector of colors (one per group) in addition to a single color for all groups.

Improvements

  • Data dictionaries now use lowercase column names (variable, description) by convention. Title-case names (Variable, Description) still work — column matching is case-insensitive.
  • extras() now handles tbl_regression gracefully: overall and pval are silently ignored (regression tables already have model p-values), and bold_p() is applied automatically. No more warnings when using extras() with default arguments on regression tables.
  • Removed startup message. The package now loads silently.
Show all changes in 1.0.0Hide the rest of the changes in 1.0.0
  • Dropped {purrr} from Imports (4 dependencies instead of 5).
  • New vignettes: vignette("options") and vignette("themes").

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 8.6 min · r-release-macos-x86_64
Status changes
  • OK13 OK2026-08-04
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-07
  • OK13 OK2026-06-04
Show 4 earlier changesHide 4 earlier changes
  • ERROR10 OK, 3 ERROR2026-05-29
  • OK13 OK2026-05-02
  • ERROR11 OK, 1 ERROR2026-04-25
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.0.0
READMEYes · 359 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 1.0.0Citation fileYes · computed when R runs itWebsiteYes · pkgdown
Description cites an R Journal article
Help pages
9 (1 internal)includes a package overview page
Examples that run
11%1 run in a plain check · 8 only when donttest examples are enabled (R CMD check --as-cran)
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
0%

Downloads

2.2K
CRAN downloads in the past year
Rank #20,169 · ~6/day · ~186/mo
Daily download trend is not available in this view yet.
26630 days
66190 days
2.2K1 year
Compare downloads with other packages →
Also on60 r2u3 autocran

Repository

8Stars
0Forks
0Open issues
0Open PRs
1Releases
142Commits
1Commit identities
142 commits · Last activity 2026-07-01 · 0% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
100%
Median days to close, 50 most recently updated closed issues
10
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-11-13 · 12026-07-07 · 8
PracticesBeta

7 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/kylegrealis/sumextras on 2026-10-22.

Continuous integration (2)
GitHub ActionsR CMD check workflow

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

Docs source (3)
pkgdown

GitHub Pages site last deployed 2026-07-01 · The repository has a site deploy workflow

pkgdown site last built 2026-07-01

Automation and maintenance (1)
pre-commit
Lint, format, editor (1)
lintr
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2025-11-12
    Named in .Rbuildignore: .claude, CLAUDE.md
    Named in .gitignore: .claude, CLAUDE.md
    Commits: at least 5 crediting it in the message
  • Gemini CLIfirst seen 2025-12-23
    Named in .Rbuildignore: .gemini, GEMINI.md
    Named in .gitignore: .gemini, GEMINI.md
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
11 external dependencies (excludes base and recommended)

Installing sumExtras adds 63 packages (31 with compiled code, 50 MB of source tarballs). Heaviest: stringi 11 MB, bslib 5.6 MB, gt 3.3 MB.

Depends (1)
R >= 4.1.0
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (3)
Author, Maintainer since 0.2.0 (2026)
Contributor
Contributor · added in 0.3.0
Releases (3)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 1.0.0Latest
    record
    2026-02-11 · current release · diff ↗ ·
    removed 1 export
    apply_labels_from_dictionary
  • 0.3.0
    record
    2026-01-22 · diff ↗
  • 0.2.0
    record
    2026-01-19
  • R
    R 4.5.0 released · 2025-04-11

Package metadata

First published
2026-01-19
Total releases
3 / 1 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1.0
Download size
2.4 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("sumExtras")

The package provides a citation file that builds its entry when R runs it. Run citation() to see it.

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 sumExtras version 1.0.0 [Data set]. HJJB, LLC. Data release v2026-10-24. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-24, 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