Learn R Programming

Citation

If you use rworkflows, please cite:

Schilder, B.M., Murphy, A.E. & Skene, N.G. rworkflows: automating reproducible practices for the R community. Nat Commun 15, 149 (2024). https://doi.org/10.1038/s41467-023-44484-5

Intro

rworkflows is a suite of tools to make it easy for R developers to implement reproducible best practices on GitHub.

It includes three main components:

  1. [**templateR

template**](https://github.com/neurogenomics/templateR): a CRAN/Bioc-compatible R package template that automatically generates essential documentation using package metadata.
2. rworkflows R package: a lightweight CRAN package to automatically set up short, customisable workflows that trigger the rworkflows action.
3. rworkflows action: an open-source action available on the GitHub Actions Marketplace.

rworkflows action steps

GitHub Actions are a powerful way to automatically launch workflows every time you push changes to a GitHub repository. This is a form of Continuous Integration/Deployment (CI/CD), which helps ensure that your code is always working as expected (without having to manually check each time).

Here, we have designed a robust, reusable, and flexible action specifically for the development of R packages. We also provide an R function to automatically generate a workflow file that calls the rworkflows composite action:

Currently, rworkflows action can perform the following tasks (with options to enable/disable/modify each step):

Copy Link

Version

Install

install.packages('rworkflows')

Monthly Downloads

436

Version

1.0.12

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Hiranyamaya (Hiru) Dash

Last Published

May 6th, 2026

Functions in rworkflows (1.0.12)

fill_description

Fill DESCRIPTION
get_authors

Get authors
infer_biocviews

Infer biocViews
use_readme

Use README
use_vignette_docker

Use vignette: Docker
use_issue_template

Use Issue Template
use_dockerfile

Use Dockerfile
is_gha

Is GitHub Action
message_parallel

Message parallel
stopper

Stop messages
infer_docker_org

Infer Docker registry organisation name
use_workflow

Use GitHub Actions workflow
use_vignette_getstarted

Use vignette: Get started
messager

Print messages
infer_deps

Infer dependencies
check_cont

Check containers exist
construct_authors

Construct authors
conda_export

Conda export
bioc_r_versions

Bioconductor / R versions
dt_to_desc

construct_cont

Construct containers list
construct_conda_yml

Construct a conda yaml
construct_runners

Construct runners
get_description

Get DESCRIPTION
biocpkgtools_db

Static Bioc packages list
get_github_url_db

Get GitHub URL: from database
check_registry

Check registry
gha_python_versions

GitHub Actions python versions
get_description_repo

Get DESCRIPTION files for R repos
use_badges

Use badges
get_hex

Get hex
use_codespace

Use Codespace