faq-adverbs-export: Best practices for exporting adverb-wrapped functions

faq-adverbs-exportR Documentation

Best practices for exporting adverb-wrapped functions

Description

Exporting functions created with purrr adverbs in your package requires some precautions because the functions will contain internal purrr code. This means that creating them once and for all when the package is built may cause problems when purrr is updated, because a function that the adverb uses might no longer exist.

Instead, either create the modified function once per session on package load or wrap the call within another function every time you use it:

  • Using the .onLoad() hook:

    #' My function
    #' @export
    insist_my_function <- function(...) "dummy"
    
    my_function <- function(...) {
      # Implementation
    }
    
    .onLoad <- function(lib, pkg) {
      insist_my_function <<- purrr::insistently(my_function)
    }
    
  • Using a wrapper function:

    my_function <- function(...) {
      # Implementation
    }
    
    #' My function
    #' @export
    insist_my_function <- function(...) {
      purrr::insistently(my_function)(...)
    }
    

purrr documentation built on Aug. 10, 2023, 9:08 a.m.