An R Package Skeleton Generator

A tool for bootstrapping new packages with useful defaults, including a test suite outline that passes checks and helpers for running tests, checking test coverage, building vignettes, and more. Package skeletons it creates are set up for pushing your package to 'GitHub' and using other hosted services for building and test automation.


Build Status Build status codecov

Skeletor is a tool for bootstrapping new packages with useful defaults and scaffolding. Package skeletons it creates contain a test suite outline and hooks for adding documentation. They also are created with a Makefile to facilitate running tests, checking test coverage, building vignettes, and more. Skeletor also sets up packages to use git/GitHub for version control and Travis-CI to build and test your packages whenever you push to GitHub. Integrations with Codecov.io and Appveyor are also made effortless.

While other R package skeletons exist, I found that I never used them. The defaults of the base R's package.skeleton, copying functions from the current R session, never are what I want, and what devtools::create makes is too bare. I found that I was starting every package by copying the last package I made, deleting its code and tests, and renaming everything. skeletor automates that.

Installing

The pre-CRAN-release version of the package can be pulled from GitHub using the devtools package:

# install.packages("devtools")
devtools::install_github("nealrichardson/skeletor")

Using

Skeletor provides two functions: (1) skeletor, which makes package skeletons, and (2) configure, which sets a few parameters in your .Rprofile so that you don't need to provide them each time. These parameters, which are inserted into the package skeleton template, are:

  • name: your name
  • email: your email address
  • github: your GitHub username

After installing, run configure once to set these, like: > configure(name="Neal Richardson", email="[email protected]", github="nealrichardson")

Thereafter, simply running

$ R -e 'skeletor::skeletor("wittynamehere")'

from the shell will create a package called "wittynamehere" in a same-named subdirectory of your current working directory, and it will insert your name, email, and GitHub account into the appropriate parts of the package. Then you can open that directory's contents in your favorite IDE or text editor. You also can immediately run tests on your new package with make test or by running R CMD check on it. See the new package's README.md file for further instructions on how to finish setting it up with GitHub and other hosted services.

For developers

The repository---and the repositories it creates---include a Makefile to facilitate some common tasks.

Running tests

$ make test. Requires the testthat package. You can also specify a specific test file or files to run by adding a "file=" argument, like $ make test file=configure. test_package will do a regular-expression pattern match within the file names. See its documentation in the testthat package.

Updating documentation

$ make doc. Requires the roxygen2 package.

News

skeletor 1.0.4

  • Fix skeleton README's reference to Appveyor
  • Move 'covr' to Suggests rather than a .travis.yml extra installation
  • Enable markdown in roxygen tags

skeletor 1.0.2

  • Patch tests to work with "oldrel" R, which doesn't have tools::Rcmd.
  • Run Travis builds on "oldrel", "release", and "devel" versions of R.

skeletor 1.0.0

  • CRAN release. Provides two functions: skeletor to make a package skeleton, and configure to set your name, email, and github account in your .Rprofile so that you don't have to enter them when you call skeletor.

skeletor 0.1.0

  • Initial addition of functions and tests

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("skeletor")

1.0.4 by Neal Richardson, 3 years ago


https://github.com/nealrichardson/skeletor


Report a bug at https://github.com/nealrichardson/skeletor/issues


Browse source code at https://github.com/cran/skeletor


Authors: Neal Richardson [aut, cre]


Documentation:   PDF Manual  


MIT + file LICENSE license


Suggests covr, testthat


See at CRAN