Creating an RPackage - UseMethod can't find function

Question

I'm trying on my first attempt on creating an R package. I have some functions that follows below.

#' @export overview <- function(x, ...) { UseMethod("overview") } overview.query <- function(return.query, ...) {

Now when I use the devtools::load_all() (which loads all functions) everything works, and overview.query is executed when I pass an object of class query.

But rebuilding, and the UseMethod can't find the overview.query function anymore (all functions are thus not loaded), what have I done wrong?

Error message: no applicable method for 'overview' applied to an object of class "c('query', 'data.frame')"

I thought that only functions that are to be exposed to the user are to be @export'ed, and all other functions would still be visible internally to the other package functions.

possible duplicate: stackoverflow.com/questions/32277063/… — C8H10N4O2
– C8H10N4O2, Commented Jun 2, 2016 at 16:45
Just for the record, I encountered a version of this while deliberately using unexported S3 generics and methods. When I passed an S3 method to lapply(), it worked with devtools::load_all("drake") but not library(drake). Solution: nest in another function. github.com/ropensci/drake/commit/…. — landau
– landau, Commented Feb 13, 2019 at 2:36

Community · Accepted Answer · 2017-05-23 12:02:39Z

When you create a generic function to apply to an S3 object, you need to export both the UseMethod statement and the function itself, as in:

#' @export overview <- function(x, ...) { UseMethod("overview") } #' @export overview.query <- function(return.query, ...) {

which ought to eliminate the error as that method is now available to the user.

This is applicable to roxygen2 versions 3+ (currently on 5). See this answer for more info:

How to properly document S3 methods

Collectives™ on Stack Overflow

Creating an RPackage - UseMethod can't find function

1 Answer 1

Comments

Linked

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Linked

Related