Struct RuntimeBuilder 

pub struct RuntimeBuilder { /* private fields */ }

Configuration for Runtime::builder.

Implementations

impl RuntimeBuilder

pub fn new() -> Self

pub fn execution_mode(self, mode: ExecutionMode) -> Self

Select how the runtime executes function calls. Defaults to ExecutionMode::Tiered.

pub fn source_paths(self, paths: Vec<PathBuf>) -> Self

Directories searched when require resolves a namespace to a file.

pub fn gc_config(self, config: Arc<GcConfig>) -> Self

Explicit GC limits. Without this the heap is configured from the environment (CLJRS_GC_*), unless Self::gc_config_from_env is off.

pub fn gc_config_from_env(self, enabled: bool) -> Self

Whether to apply CLJRS_GC_* environment settings to the heap. On by default; an explicit Self::gc_config is applied after it.

pub fn register_gc_roots(self, enabled: bool) -> Self

Whether to register this runtime’s namespace table as a GC root set. On by default. The tracer holds a weak handle, so the runtime is still collected when the last Runtime handle drops.

pub fn builtin_source(self, ns: impl Into<String>, src: &'static str) -> Self

Embed a namespace’s source in the runtime, so require resolves it without a file on the source path.

pub fn eager_clojure_test(self, enabled: bool) -> Self

Evaluate clojure.test during construction instead of leaving it to the first require.

Only useful without an extension that embeds clojure.test lazily (cljrs-stdlib does); tests inside this package rely on it.

pub fn build(self) -> Result<Runtime, BuildError>

Bootstrap the runtime.

Registers native clojure.core, evaluates the bootstrap Clojure source, applies GC and source-path configuration, and finally raises the tier state to what the execution mode targets — the bootstrap itself always tree-walks, because nothing can be lowered before clojure.core exists.

Trait Implementations

impl Default for RuntimeBuilder

fn default() -> Self

Returns the “default value” for a type.