Utility Functions and Development Tools for the Admiral Package Family
Overview
Utility functions to check data, variables and conditions for functions used in 'admiral' and 'admiral' extension packages. Additional utility helper functions to assist developers with maintaining documentation, testing and general upkeep of 'admiral' and 'admiral' extension packages.
New Features
- Moved over roxygen helper functions from
{admiral}to{admiraldev}. (#517)
Updates of Existing Functions
is_valid_dtc()was enhanced with the argumentcheck_dtcto allow users
to check whether the input date/datetime is a real date/datetime. (#505)
capture_message()was updated to strip off all control sequences from the message. (#543)assert_list_of()andassert_vars()were updated with a clearer message to users on how to fix a string versus symbol issue, e.g "If a variable was provided as a string, please provide it as a symbol, e.g. useexprs(AVISIT)instead ofexprs("AVISIT")". (#538)
Breaking Changes
Show all changes in 1.5.0Hide the rest of the changes in 1.5.0
Documentation
- Update to
{roxygen2}8.0.0. (#557) - Update links in documentation for AI coding
AGENTS.mdfiles. (#552) - Update vignettes for AI coding
AGENTS.mdfiles. (#545) - The website navigation bar has been updated to: (#539)
- Add a night mode option. This can be be toggled using the sun/moon icon in the top right corner of the navigation bar.
- Add a link to the "Get Started" vignette for developers.
- Add icon links to report a bug and join the pharmaverse Slack.
- Add tooltips for each of the icons.
- Increase the maximum height of the drop-down menus to ensure all items are visible without scrolling.
- Added a brief section on using AI in the programming strategy. (#547)
- Updated the function name prefixes in the programming strategy. (#472)
- Aligned the definition of "Experimental functions" in the programming strategy with the definition
in the admiral reference page. (#561)
Various
- Updated existing assertion unit tests. (#550)
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-08
- ERROR12 OK, 1 ERROR2026-09-07
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK12 OK2026-04-25
Show 1 earlier changeHide 1 earlier change
- ERROR13 OK, 1 ERROR2026-03-10
Documentation
- Help pages
- 75 (7 internal)includes a package overview page
- Examples that run
- 100%43 run in a plain check
- Exported functions with examples
- 63%
- Documented parameters
- 98%
- Return-value docs
- 98%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 88%
- Median days to close, 50 most recently updated closed issues
- 38
- Median days to close, 50 most recently updated closed PRs
- 1
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
6 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/pharmaverse/admiraldev on 2026-10-21.
This repository shows signs of AI coding tools.
- GitHub Copilotfirst seen 2025-12-19Pull request: opened by its own accountCommits: 3 by its own account · at least 4 crediting it in the message
- Claude Codefirst seen on or before 2026-09-22Commits: at least 2 crediting it in the message
- Copilot code reviewCommits: at least 1 accepting its review suggestions
- Claude CodePull requests: 2 from outside contributors, first on 2026-09-21
- Claude Opus 52 commits · Sep 2026
Dependencies
Installing admiraldev adds 41 packages (23 with compiled code, 22 MB of source tarballs). Heaviest: stringi 11 MB, fs 1.4 MB, vctrs 1.0 MB.
Code & Tests
People & History
Previously maintained by Ben Straub (0.1.0 to 1.4.0).
Show 8 of 11 peopleHide 8 people
Pick two releases to compare their code metrics.
- 1.5.0Latest2026-06-10 · current release · diff ↗ ·
added 4 exports
roxygen_order_na_handling, roxygen_param_by_vars, roxygen_param_dataset, roxygen_save_memory - 1.4.12026-05-27 · diff ↗
- RR 4.6.0 released · 2026-04-24
- 1.4.0
- 1.3.12025-06-25 · diff ↗
- 1.3.0
- RR 4.5.0 released · 2025-04-11
- 1.2.02025-01-15 · diff ↗ ·
removed 3 exports
assert_function_param, assert_has_variables, assert_named_exprsadded 1 export
deprecate_inform - 1.1.0
- RR 4.4.0 released · 2024-04-24
- 1.0.0
- 0.5.02023-09-11 · diff ↗ ·
removed 3 exports
quo_c, quo_not_missing, replace_symbol_in_quoadded 1 export
friendly_type_of - 0.4.0
- RR 4.3.0 released · 2023-04-21
- 0.3.02023-03-07 · diff ↗ ·
removed 1 export
as_nameadded 3 exports
expr_c, process_set_values_to, replace_symbol_in_expr - 0.2.02022-12-01 · diff ↗ ·
removed 12 exports
desc, is_date, is_timeunit, is_valid_date_entry, is_valid_day, is_valid_hour, is_valid_month, is_valid_sec_min, is_valid_time_entry, negate_vars, set_dataset, varsadded 6 exports
add_suffix_to_vars, assert_atomic_vector, assert_date_vector, assert_same_type, contains_vars, replace_symbol_in_quo
Show 2 earlier eventsHide 2 earlier events
- 0.1.02022-08-26
- RR 4.2.0 released · 2022-04-22
Package metadata
- First published
- 2022-08-26
- Total releases
- 13 / 4 yrs
- License
- Apache License (>= 2)
- Minimum R
- ≥ 4.1
- Download size
- 1.0 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("admiraldev")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.
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.