Struct Loader 

pub struct Loader { /* private fields */ }

Cheap cloneable loader handle.

Implementations

impl Loader

pub fn open(root: &Context, config: LoaderConfig) -> Result<Loader>

Open (creating if needed) the entry file, load the tree, and start every enabled entry.

Entries that fail to resolve or start do not abort the open; the error is recorded and retrievable via Loader::last_error, and the offending entry simply has no (or a failed) fiber.

pub fn context(&self) -> &Context

The root context the loader operates on.

pub fn tree(&self) -> &EntryTree

The entry tree.

pub fn file(&self) -> &LoaderFile

The entry config file.

pub fn registry(&self) -> PluginRegistry

The plugin registry (a clone of the current state); populate it via LoaderConfig::with_registry before open, or Loader::register_plugin later.

pub fn register_plugin<P: Plugin>(&self, plugin: P)

Register one plugin instance by its own name; picked up by the next reload (or immediately for not-yet-started entries).

pub fn register<F>(&self, name: impl Into<String>, factory: F)

where F: Fn() -> PluginHandle + Send + Sync + 'static,

Register a handle factory under a name.

pub fn last_error(&self) -> Option<String>

The last background error recorded by the loader, if any.

pub fn locate(&self, fiber: &Fiber) -> Option<Entry>

The entry whose fiber is fiber, if the loader started it.

pub fn reload(&self) -> Result<TreeDiff>

Re-read the entry file and apply the difference to the fibers.

Created entries start (parents first), removed subtrees stop, moved entries restart under their new parent, updated entries are patched in place when only config changed and restarted otherwise. While the reload runs, the file is suspended, so the patches it causes are not written back; generated ids are persisted afterwards.

pub fn update_config(&self, id: &str, config: Node) -> Result<()>

Change one entry’s config at runtime: the fiber is updated (and restarted when active) and the new config is persisted to the file.

pub fn dispose(&self) -> Result<()>

Stop every entry and clear the fiber map. The root context itself stays usable.

Trait Implementations

impl Clone for Loader

fn clone(&self) -> Loader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.