extendr-bindings
extendr conventions for exposing a Rust core to R: extendr macros and module registration, Robj type mapping, NA handling, rextendr builds, R package scaffolding, and CRAN compliance. Load when genera
SKILL.mdinternal/builtins/bindings/extendr/skills/extendr-bindings/SKILL.md
GitHub- Use
extendrcrate for Rust-R interop.#[extendr]macro on functions,extendr_module!for registration. - Type mapping:
Robjfor generic R objects,Doubles,Integers,Strings,Listfor typed access. - Return
Result<T, extendr_api::Error>for R error propagation. Use.into()for Rust-to-R conversion. - NA handling: use
Rfloat::na(),Rint::na()for missing values. Check with.is_na()before operations. - Build with
rextendr::document()in R for development,cargo build --releasefor production. - Package integration: use
usethis::use_extendr()for scaffolding. Maintainsrc/rust/in R package. - Test R-side with
testthat, Rust-side with standard#[test]. Userextendr::test()for integration. - CRAN compliance:
R CMD check --as-cranmust pass. No compiler warnings. Vendor Rust dependencies. - Keep R wrapper functions thin — heavy computation in Rust, R provides user-facing API with roxygen2 docs.
- Anti-patterns: ignoring NA values, allocating R objects in Rust threads, panics in
#[extendr]functions.