Creates a package template in a new folder.
Use this function when you want to start a new package.
Please DO READ vignette("getting_started")
before running this function.
create_package(package, path = ".", title, description, maintainer, language)
Name of the new package.
Where to create the package directory.
A single sentence with the title of the package.
A single paragraph describing the package.
The output of utils::person()
or orcid2person()
.
If you use utils::person()
, then you must provide given
, family
,
role
, email
and comment
with valid ORCID
.
When missing, the functions looks for usethis.description
in the options.
See usethis::use_description()
for more information.
Language of the package package in ISO 639-3 format.
What you get with a checklist setup:
minimal folder structure and files required for an R package using INBO guidelines with GPL-3 license.
an RStudio project file
a local git repository
an initial NEWS.md
file
a template for an README.Rmd
set-up for automated checks and releases of the package using GitHub Actions.
a code of conduct and contributing guidelines.
the set-up for a pkgdown
website using the INBO corporate identity.
Other setup:
prepare_ghpages()
,
setup_package()
,
setup_source()
# maintainer in `utils::person()` format
maintainer <- person(
given = "Thierry",
family = "Onkelinx",
role = c("aut", "cre"),
email = "thierry.onkelinx@inbo.be",
comment = c(ORCID = "0000-0001-8804-4216")
)
# maintainer with `orcid2person()`
if (FALSE) {
maintainer <- orcid2person("0000-0001-8804-4216")
}
# creating the package
path <- tempfile()
dir.create(path)
create_package(
path = path, package = "packagename", title = "package title",
description = "A short description.", maintainer = maintainer,
language = "eng"
)
#> No `checklist.yml` found. Assuming this is a package.
#> See `?write_checklist` to generate a `checklist.yml`.
#> package created at `/tmp/Rtmp2W6Pqa/file1310741d0258/packagename`