Struct InstanceBuilder 

pub struct InstanceBuilder<L = ()> { /* private fields */ }

Builder that compiles Navi source and produces an executable Instance.

Obtain a builder via Instance::builder.

The generic parameter L tracks the chain of library loaders registered via with_library_loader. Start with InstanceBuilder<()> (the default returned by Instance::builder) and each call to with_library_loader prepends a new loader while preserving the fallback chain in the type.

Implementations

impl<L> InstanceBuilder<L>

pub fn with_locale(self, locale: impl Into<String>) -> Self

Sets the locale used for i18n diagnostic messages.

pub fn with_dialect(self, dialect: Dialect) -> Self

Sets the source dialect used to parse the script (Pine or Navi).

pub fn with_input_value(self, id: usize, value: impl Serialize) -> Self

Set the value of an input by its index.

pub fn with_input_sessions(self, sessions: InputSessions) -> Self

Configures which trading sessions are accepted as input.

pub fn with_background_color(self, color: impl Into<Option<Color>>) -> Self

Overrides the chart background color used by visual outputs.

pub fn with_last_info(self, last_info: impl Into<Option<LastInfo>>) -> Self

Provides the last-bar metadata used by some runtime features.

pub fn with_execution_limits(self, limits: ExecutionLimits) -> Self

Configures runtime execution limits for the VM.

pub fn with_output_mode(self, mode: OutputMode) -> Self

Sets the output mode for series graph data.

pub fn with_mtf_wait(self, duration: Duration) -> Self

Sets the fixed delay applied before executing each realtime bar.

pub fn with_strategy_config_override(self, ov: StrategyConfigOverride) -> Self

Overrides strategy execution parameters declared in the script source.

Fields set to Some(…) take precedence over the strategy() call arguments. Fields left as None fall back to the script defaults. Has no effect on non-strategy scripts.

impl<L: LibraryLoader> InstanceBuilder<L>

pub fn with_library_loader<Q: LibraryLoader>( self, loader: Q, ) -> InstanceBuilder<CombinedLoader<Q, L>>

Prepends a library loader to the resolution chain.

The new loader is tried first; on failure it falls back to whichever loader was registered previously. The built-in prelude/stdlib loader is always appended as the final fallback regardless of how many custom loaders are registered.

Call this method multiple times to build a priority stack:

// Resolution order: loader_b → loader_a → builtins
let instance = Instance::builder(provider, source, timeframe, symbol)
    .with_library_loader(loader_a)
    .with_library_loader(loader_b)
    .build()
    .await?;

pub async fn build(self) -> Result<Instance, Error>

Compiles the source and builds a runnable Instance.