Learn R Programming

⚠️There's a newer version (1.0.6) of this package.Take me there.

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

333

Version

1.0.1

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Brian Schilder

Last Published

January 23rd, 2025

Functions in rworkflows (1.0.1)

get_description

Get DESCRIPTION
use_dockerfile

Use Dockerfile
is_gha

Is GitHub Action
use_vignette_getstarted

Use vignette: Get started
use_workflow

Use GitHub Actions workflow
message_parallel

Message parallel
use_badges

Use badges
use_codespace

Use Codespace
get_description_repo

Get DESCRIPTION files for R repos
use_issue_template

Use Issue Template
use_readme

Use README
use_vignette_docker

Use vignette: Docker
messager

Print messages
stopper

Stop messages
check_registry

Check registry
construct_authors

Construct authors
bioc_r_versions

Bioconductor / R versions
construct_cont

Construct containers list
construct_runners

Construct runners
construct_conda_yml

Construct a conda yaml
dt_to_desc

conda_export

Conda export
fill_description

Fill DESCRIPTION
infer_docker_org

Infer Docker registry organisation name
infer_biocviews

Infer biocViews
infer_deps

Infer dependencies
get_github_url_db

Get GitHub URL: from database
check_cont

Check containers exist
gha_python_versions

GitHub Actions python versions
biocpkgtools_db

Static Bioc packages list
get_authors

Get authors
get_hex

Get hex