50 releases (7 breaking)

0.8.1 Nov 17, 2024
0.7.2 Oct 27, 2024
0.6.5 Jul 2, 2024
0.4.1 Mar 30, 2024
0.1.16 Oct 16, 2023

#160 in Text processing

Download history 200/week @ 2024-08-20 322/week @ 2024-08-27 650/week @ 2024-09-03 460/week @ 2024-09-10 848/week @ 2024-09-17 287/week @ 2024-09-24 234/week @ 2024-10-01 325/week @ 2024-10-08 1000/week @ 2024-10-15 696/week @ 2024-10-22 474/week @ 2024-10-29 87/week @ 2024-11-05 353/week @ 2024-11-12 224/week @ 2024-11-19 152/week @ 2024-11-26 135/week @ 2024-12-03

899 downloads per month

MIT license

255KB
5K SLoC

Savvy - A simple R extension interface using Rust

savvy is a simple R extension interface using Rust, like the extendr framework. The name “savvy” comes from the Japanese word “錆” (pronounced as sàbí), which means “Rust”.

With savvy, you can automatically generate R functions from Rust code. This is an example of what a savvy-powered function would look like:

Rust

use savvy::savvy;

/// Convert to Upper-case
/// 
/// @param x A character vector.
/// @export
#[savvy]
fn to_upper(x: StringSexp) -> savvy::Result<savvy::Sexp> {
    // Use `Owned{type}Sexp` to allocate an R vector for output.
    let mut out = OwnedStringSexp::new(x.len())?;

    for (i, e) in x.iter().enumerate() {
        // To Rust, missing value is an ordinary value. In `&str`'s case, it's just "NA".
        // You have to use `.is_na()` method to distinguish the missing value.
        if e.is_na() {
            // Set the i-th element to NA
            out.set_na(i)?;
            continue;
        }

        let e_upper = e.to_uppercase();
        out.set_elt(i, e_upper.as_str())?;
    }

    out.into()
}

R

to_upper(c("a", "b", "c"))
#> [1] "A" "B" "C"

Documents

Contributing

CONTRIBUTING.md

Examples

A toy example R package can be found in R-package/ directory.

Savvy is used in the following R packages:

Thanks

Savvy is not quite unique. This project is made possible by heavily taking inspiration from other great projects:

  • The basic idea is of course based on extendr. Savvy would not exist without extendr.
  • cpp11’s “writable” concept influenced the design a lot. Also, I learned a lot from the great implementation such as the protection mechanism.
  • PyO3 made me realize that the FFI crate doesn’t need to be a “sys” crate.

Dependencies

~0.3–1.2MB
~27K SLoC