This package is designed to take away some grunt work around setting up new projects.
All projects get setup with Git, GitHub and Travis by default.
Use create_package_project()
to setup a project with code
coverage, vignettes, unit testing etc. out of the box
Use create_analysis_project()
to get a project ready for a typical
analysis project. It includes
renv to help
with reproducibility.
Use create_training_project()
to get a project ready for
delivering training that often involves handouts and presentation
materials. It includes
renv to help
with reproducibility.
All functions implement name validation based on the guidance in “Writing R Extensions”, “[The name] should contain only (ASCII) letters, numbers and dot, have at least two characters and start with a letter and not end in a dot”.
starters
remotes::install_github("lockedata/starters")
start_here()
functionRun
starters::start_here()
This function checks different aspects of your setup (git installation,
gitconfig, GITHUB_PAT
, DESCRIPTION
default values, GitHub username
guessing), that will help automatic steps later on. Most of these
aspects are inspired from usethis
setup
article.
For each aspect, if your setup needs improvements an informative error
message will be thrown so you might be able to know how to proceed.
If you want to set up a project without using the R functions, @jonmcalder made a nifty RStudio addin. Install the package to get it added to your RStudio instance.
Other R tools (not necessarily active, vet them first) useful for starting new projects.
usethis
in general,
create_project()
and create_package()
in
particular.
starters actually depends on usethis.
skeletor
, An R
Package Skeleton Generator.
mkrpkg
, Template for making
R packages.
mason
, A friendly craftsman
that builds you great R packages.
Wanna report a bug or suggest a feature? Great stuff! For more information on how to contribute check out our contributing guide.
Please note that this R package is released with a Contributor Code of Conduct. By participating in this package project you agree to abide by its terms.
Make sure to check out the Issues tab in GitHub! We’re making this project a great place to start contributing to R packages. We will help you through the process.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.