In k-hench/blankpkg: Blank Package Template

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)

blankpkg

This is a bare bones dummy R package to serve as a template for package creation with the {usethis} R package.

The whole package creation covers

• package initialization with {usethis}
• integration of github actions
• basic package build
• code coverage using codecov.io
• automatic web page generation using {pkgdown}
• generating shiny badges for the repository.
• code testing powered by {testthat}
• documentation of the code status with {lifecycle}

Installation

You can install the development version of {blankpkg} from github with the following R code — there is no good reason to do this though:

install.packages("remotes")
remotes::install_github("k-hench/blankpkg")

Example

This is a basic example which shows you how to solve a common problem:

library(blankpkg)
## basic example code
blank_x()

What is special about using README.Rmd instead of just README.md? You can include R chunks like so:

summary(cars)

You'll still need to render README.Rmd regularly, to keep README.md up-to-date. devtools::build_readme() is handy for this. You could also use GitHub Actions to re-render README.Rmd every time you push. An example workflow can be found here: https://github.com/r-lib/actions/tree/master/examples.

You can also embed plots, for example:

plot(pressure)

In that case, don't forget to commit and push the resulting figure files, so they display on GitHub and CRAN.

---

k-hench/blankpkg documentation built on Dec. 21, 2021, 5:15 a.m.