Struct NautilusKernelBuilder 

pub struct NautilusKernelBuilder { /* private fields */ }

Builder for constructing a NautilusKernel with a fluent API.

Provides a convenient way to configure and build a kernel instance with optional components and settings.

Implementations

impl NautilusKernelBuilder

pub const fn new( name: String, trader_id: TraderId, environment: Environment, ) -> Self

Creates a new NautilusKernelBuilder with required parameters.

pub const fn with_instance_id(self, instance_id: UUID4) -> Self

Set the instance ID for the kernel.

pub const fn with_load_state(self, load_state: bool) -> Self

Configure whether to load state on startup.

pub const fn with_save_state(self, save_state: bool) -> Self

Configure whether to save state on shutdown.

pub const fn with_shutdown_on_error(self, shutdown_on_error: bool) -> Self

Configure whether an error log shuts down the system.

Filtered or bypassed error logs still request shutdown.

pub fn with_logging_config(self, config: LoggerConfig) -> Self

Set the logging configuration.

pub const fn with_timeout_connection(self, timeout_secs: u64) -> Self

Set the connection timeout in seconds.

pub const fn with_timeout_reconciliation(self, timeout_secs: u64) -> Self

Set the reconciliation timeout in seconds.

pub const fn with_timeout_portfolio(self, timeout_secs: u64) -> Self

Set the portfolio initialization timeout in seconds.

pub const fn with_timeout_disconnection(self, timeout_secs: u64) -> Self

Set the disconnection timeout in seconds.

pub const fn with_delay_post_stop(self, delay_secs: u64) -> Self

Set the post-stop delay in seconds.

pub const fn with_timeout_shutdown(self, timeout_secs: u64) -> Self

Set the shutdown timeout in seconds.

pub fn with_clock_factory<F>(self, factory: F) -> Self

where F: Fn() -> Rc<RefCell<dyn Clock>> + 'static,

Inject a caller-supplied clock factory for the kernel and component clocks.

The factory is invoked for the kernel clock and once per registered component. Each invocation should return a fresh instance. Without a factory, live/sandbox systems use LiveClock::default().

pub fn with_cache_config(self, config: CacheConfig) -> Self

Set the cache configuration.

pub fn with_cache_database(self, adapter: Box<dyn CacheDatabaseAdapter>) -> Self

Inject a durable cache database adapter.

The adapter is passed straight to [nautilus_common::cache::Cache::new] so generic cache state (including event-store snapshot blobs) is restored on startup without an external caller pre-seeding the in-memory cache. Adapter construction lives outside this crate to keep nautilus-system decoupled from concrete backing stores such as Redis or Postgres.

pub fn with_data_engine_config(self, config: DataEngineConfig) -> Self

Set the data engine configuration.

pub fn with_risk_engine_config(self, config: RiskEngineConfig) -> Self

Set the risk engine configuration.

pub fn with_exec_engine_config(self, config: ExecutionEngineConfig) -> Self

Set the execution engine configuration.

pub const fn with_portfolio_config(self, config: PortfolioConfig) -> Self

Set the portfolio configuration.

pub fn with_msgbus_config(self, config: MessageBusConfig) -> Self

Set the message bus configuration.

pub fn with_event_store<F>(self, factory: F) -> Self

where F: FnOnce(UUID4, Rc<RefCell<dyn Clock>>) -> Result<Box<dyn KernelEventStore>> + 'static,

Inject an event-store implementation to drive run-lifecycle capture.

The factory is invoked with the kernel’s instance id and clock during construction, so the returned KernelEventStore scans the same run directory and shares the same time source the kernel uses for RunStarted/RunEnded and any drop-seal fallback. The concrete implementation lives outside this crate (typically in nautilus-event-store); callers build it inside the closure.

pub fn with_external_msgbus_egress( self, external_egress: Box<dyn MessageBusExternalEgress>, ) -> Self

Inject external message bus egress for serialized message bus publications.

pub fn with_external_msgbus_factory( self, factory: Box<dyn MessageBusBackingFactory>, ) -> Self

Build and inject external message bus egress from a factory.

pub fn build(self) -> Result<NautilusKernel>

Build the NautilusKernel with the configured settings.

Errors

Returns an error if kernel initialization fails.

Trait Implementations

impl Debug for NautilusKernelBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NautilusKernelBuilder

fn default() -> Self

Create a default builder with minimal configuration for testing/development.