Skip to contents

Create the scaffolding needed to add Rust extendr code to an R package. use_extendr() adds a small Rust library with a single Rust function that returns the string "Hello world!". It also adds wrapper code so this Rust function can be called from R with hello_world().

Usage

use_extendr(
  path = ".",
  crate_name = NULL,
  lib_name = NULL,
  quiet = getOption("usethis.quiet", FALSE),
  edition = c("2021", "2018")
)

Arguments

path

File path to the package for which to generate wrapper code.

crate_name

String that is used as the name of the Rust crate. If NULL, sanitized R package name is used instead.

lib_name

String that is used as the name of the Rust library. If NULL, sanitized R package name is used instead.

quiet

Logical indicating whether any progress messages should be generated or not. Also checks the usethis.quiet option.

edition

String indicating which Rust edition is used; Default "2021".

Value

A logical value (invisible) indicating whether any package files were generated or not.

Details

To avoid possibly messing up your R package, use_extendr() will not do anything if either a directory src or a file R/extendr-wrappers.R is already present in your package source.