R/use_bioc_description.R
use_bioc_description.Rd
This function is very similar to usethis::use_description()
except
that it uses a template from biocthis
. This template includes some of the
information expected in the DESCRIPTION file of a Bioconductor package. You
can compare the output of this function to the one from
usethis::use_description()
to select the parts you want from each.
use_bioc_description(biocViews = "Software", report_bioc = TRUE)
A character()
with the Bioconductor biocViews terms you
want to use for your package. See
https://bioconductor.org/packages/release/BiocViews.html for details. Note
that the terms you choose have to be part of one of the main four trees:
software, annotation, experiment or workflow.
A logical(1)
indicating whether to set the BugReports
to the Bioconductor Support website https://support.bioconductor.org/
or to the GitHub package issues page.
This function adds and/or replaces the DESCRIPTION
file in your
R package.
For details about the DESCRIPTION file guidelines for Bioconductor packages check http://bioconductor.org/developers/package-guidelines/#description.
if (FALSE) {
## Run this function in your package
use_bioc_description()
}
## Create an example package for illustrative purposes.
## Note: you do not need to run this for your own package!
pkgdir <- biocthis_example_pkg(use_git = TRUE)
#> ✔ Setting active project to '/tmp/RtmpTHfQjN/biocthisexample'
#> Package: biocthisexample
#> Title: What the Package Does (One Line, Title Case)
#> Version: 0.0.0.9000
#> Authors@R (parsed):
#> * First Last <first.last@example.com> [aut, cre] (YOUR-ORCID-ID)
#> Description: What the package does (one paragraph).
#> License: `use_mit_license()`, `use_gpl3_license()` or friends to
#> pick a license
#> Encoding: UTF-8
#> Roxygen: list(markdown = TRUE)
#> RoxygenNote: 7.2.3
#> ✔ Setting active project to '/tmp/RtmpTHfQjN/biocthisexample'
#> ✔ Initialising Git repo
#> ✔ Adding '.Rproj.user', '.Rhistory', '.Rdata', '.httr-oauth', '.DS_Store', '.quarto' to '.gitignore'
## Create a template DESCRIPTION file that is Bioconductor-friendly
biocthis::use_bioc_description()
#> ✔ Leaving 'DESCRIPTION' unchanged
#> Package: biocthisexample
#> Title: What the Package Does (One Line, Title Case)
#> Version: 0.99.0
#> Date: 2023-08-29
#> Authors@R (parsed):
#> * First Last <first.last@example.com> [aut, cre] (YOUR-ORCID-ID)
#> Description: What the package does (one paragraph).
#> License: Artistic-2.0
#> URL:
#> BugReports: https://support.bioconductor.org/tag/biocthisexample
#> Encoding: UTF-8
#> Roxygen: list(markdown = TRUE)
#> RoxygenNote: 7.2.3
#> biocViews: Software