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

413

Version

1.0.10

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Hiranyamaya (Hiru) Dash

Last Published

March 23rd, 2026

Functions in rworkflows (1.0.10)

messager

Print messages
use_dockerfile

Use Dockerfile
use_issue_template

Use Issue Template
is_gha

Is GitHub Action
stopper

Stop messages
use_codespace

Use Codespace
use_vignette_getstarted

Use vignette: Get started
use_workflow

Use GitHub Actions workflow
use_vignette_docker

Use vignette: Docker
use_badges

Use badges
use_readme

Use README
message_parallel

Message parallel
construct_runners

Construct runners
biocpkgtools_db

Static Bioc packages list
conda_export

Conda export
bioc_r_versions

Bioconductor / R versions
construct_cont

Construct containers list
construct_authors

Construct authors
dt_to_desc

check_registry

Check registry
construct_conda_yml

Construct a conda yaml
fill_description

Fill DESCRIPTION
get_description

Get DESCRIPTION
infer_biocviews

Infer biocViews
get_hex

Get hex
get_authors

Get authors
gha_python_versions

GitHub Actions python versions
get_github_url_db

Get GitHub URL: from database
check_cont

Check containers exist
get_description_repo

Get DESCRIPTION files for R repos
infer_docker_org

Infer Docker registry organisation name
infer_deps

Infer dependencies