use_bioc_pkg_templates: Create a biocthis package template R scripts

View source: R/use_bioc_pkg_templates.R

use_bioc_pkg_templatesR Documentation

Create a biocthis package template R scripts

Description

This function creates the dev directory and in it, it creates R script files that you can follow to create your own Bioconductor-friendly R package. These R scripts include all the commands you need to get started =) The commands are designed to be run on the order given, though we also encourage you to check the latest utility functions in the usethis package.

Usage

use_bioc_pkg_templates(open = rlang::is_interactive())

Arguments

open

Open the newly created file for editing? Happens in RStudio, if applicable, or via utils::file.edit() otherwise. This argument has the same behavior as the open argument used in usethis functions.

Details

For more details on how this function came to be, check: https://github.com/r-lib/actions/issues/84 https://github.com/r-lib/styler/issues/636 https://github.com/Bioconductor/BiocCheck/issues/57 https://github.com/Bioconductor/bioconductor.org/issues/54 https://github.com/r-lib/usethis/issues/1108 as well as the "biocthis developer notes" vignette https://lcolladotor.github.io/biocthis/articles/biocthis_dev_notes.html.

Value

This function adds and/or replaces the dev files in your R package. That is:

  • ⁠dev/01_create_pkg.R⁠

  • ⁠dev/02_git_github_setup.R⁠

  • ⁠dev/03_core_files.R⁠

  • ⁠dev/04_update.R⁠

Examples

## Not run: 
## Run this function in your package
use_bioc_pkg_templates()

## End(Not run)

## Create an example package for illustrative purposes.
## Note: you do not need to run this for your own package!
pkgdir <- biocthis_example_pkg()

## Create the biocthis templates
biocthis::use_bioc_pkg_templates()

lcolladotor/biocthis documentation built on Jan. 17, 2024, 8:07 p.m.