Type: Package
Title: Create Simple Packages Which Do not Upset R Package Checks
Version: 0.2.4
Date: 2024-08-30
Description: Provides a function kitten() which creates cute little packages which pass R package checks. This sets it apart from package.skeleton() which it calls, and which leaves imperfect files behind. As this is not exactly helpful for beginners, kitten() offers an alternative. Unit test support can be added via the 'tinytest' package (if present), and documentation-creation support can be added via 'roxygen2' (if present).
License: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
Suggests: whoami (≥ 1.1.0), tinytest, roxygen2
URL: https://github.com/eddelbuettel/pkgkitten, https://eddelbuettel.github.io/pkgkitten/
BugReports: https://github.com/eddelbuettel/pkgkitten/issues
RoxygenNote: 6.0.1
NeedsCompilation: no
Packaged: 2024-08-30 16:32:36 UTC; edd
Author: Dirk Eddelbuettel ORCID iD [aut, cre]
Maintainer: Dirk Eddelbuettel <edd@debian.org>
Repository: CRAN
Date/Publication: 2024-08-30 17:00:02 UTC

Create simple packages using the kitten function.

Description

The base R function package.skeleton() is very helpful, but insist on creating packages which do not pass R CMD check.

That is silly,

This package helps with this issue. No more, no less.

Author(s)

Dirk Eddelbuettel wrote the package and maintains it.

See Also

package.skeleton, the ‘Writing R Extensions’ manual.

Create a very simple package

Description

The kitten function creates an (almost) empty example package.

Usage

kitten(name = "anRpackage", path = ".", author, maintainer, email,
  license = "GPL (>= 2)", puppy = TRUE, bunny = TRUE)

Arguments

name

The name of the package to be created, defaults to “anPackage”

path

The path to the location where the package is to be created, defaults to the current directory.

author

The name of the author, defaults to the result of fullname (or “Your Name” as fallback).

maintainer

The name of the maintainer, also defaults to fullname or author if the latter is given.

email

The maintainer email address, defaults to email_address (or “your@email.com” as fallback).

license

The license of the new package, defaults to “GPL-2”.

puppy

Toggle whether tinytest::puppy add unit testing, default to true (but conditional on tinytest being installed).

bunny

Toggle whether roxygen2 should be used for the the creation of Rd files from R, default is true (but also conditional on roxygen2 being install).

Details

The kitten function can be used to initialize a simple package. It is created with the minimal number of files. What distinguished it from the function package.skeleton() in base R (which it actually calls) is that the resulting package passes R CMD check cleanly.

Because every time you create a new package which does not pass R CMD check, a kitten experiences an existential trauma. Just think about the kittens.

Value

Nothing is returned as the function is invoked for its side effect of creating a new package.

Author(s)

Dirk Eddelbuettel

Create a very simple package help page

Description

The playWithPerPackageHelpPage function creates an basic package help page.

Usage

playWithPerPackageHelpPage(name = "anRpackage", path = ".",
  maintainer = "Your Name", email = "your@mail.com")

Arguments

name

The name of the package to be created, defaults to “anRpackage”

path

The path to the location where the package is to be created, defaults to the current directory.

maintainer

The name of the maintainer, defaults to “Your Name” or author if the latter is given.

email

The maintainer email address.

Details

The playWithPerPackageHelpPage function can be used to create a simple help page for a package.

It has been split off from the kitten function so that it can be called from other packages. As such, it is also exported from pkgKitten.

Value

Nothing is returned as the function is invoked for its side effect of creating a new package.

Author(s)

Dirk Eddelbuettel