Struct REngineBuilder 

pub struct REngineBuilder {
    pub(crate) args: Vec<String>,
    pub(crate) interactive: bool,
    pub(crate) signal_handlers: bool,
    pub(crate) r_home: Option<PathBuf>,
}

Builder for configuring and initializing the R runtime.

Example

let engine = REngine::new()
    .with_args(&["R", "--quiet", "--no-save"])
    .interactive(false)
    .signal_handlers(false)
    .init()?;

Fields

args: Vec<String>

interactive: bool

signal_handlers: bool

r_home: Option<PathBuf>

Implementations

impl REngineBuilder

pub fn new() -> Self

Create a new R engine builder with default settings.

pub fn with_args(self, args: &[&str]) -> Self

Set the command-line arguments for R initialization.

Default is ["R", "--quiet", "--vanilla"].

pub fn interactive(self, interactive: bool) -> Self

Set whether R should run in interactive mode.

Default is false.

pub fn signal_handlers(self, enable: bool) -> Self

Set whether R should install signal handlers.

Default is false. Set to true if you want R to handle Ctrl+C etc.

pub fn r_home(self, path: impl Into<PathBuf>) -> Self

Set the R_HOME directory explicitly.

By default, R_HOME is auto-detected by running R RHOME or reading the R_HOME environment variable. Use this method to override that behavior with an explicit path.

Example

let engine = REngine::build()
    .r_home("/opt/R/4.4.0/lib/R")
    .init()
    .expect("Failed to initialize R");

pub unsafe fn init(self) -> Result<REngine, REngineError>

Initialize the R runtime with the configured settings.

Safety

• Must only be called once per process
• Must be called from the main thread
• R cannot be safely shutdown and reinitialized

Errors

Returns an error if R initialization fails.

Trait Implementations

impl Default for REngineBuilder

fn default() -> Self

Returns the “default value” for a type.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 56 bytes