Struct NativePluginRegistry 

pub struct NativePluginRegistry { /* private fields */ }

Registry of built-in native plugins, split by pass.

Holding synth and regular plugins in separately-typed Vecs lets the loader’s pass-dispatch site ask for the right kind directly: the returned trait reference’s type matches the pass, so a regular-pass plugin can’t be returned from find_synth even on a name collision.

The loader still gates two implicit synth-pass invocations on LoadOptions / Options flags (options.auto_accounts and the option "documents" directive that drives document_discovery), but those flow through the same unified dispatch loop as file-declared and CLI plugins — there’s no per-plugin special case at the dispatch site.

Implementations

impl NativePluginRegistry

pub fn global() -> &'static Self

Access the process-wide registry singleton.

The registry is immutable and stateless; reuse this reference instead of constructing a fresh registry per call. The underlying LazyLock initializes on first access.

pub fn find_synth(&self, name: &str) -> Option<&dyn SynthPlugin>

Find a synth-pass plugin by name.

Returns None if the plugin doesn’t exist OR if it exists but is a regular-pass plugin — the type system guarantees the returned reference is dyn SynthPlugin.

Accepts both short names ("auto_accounts") and fully qualified module paths ("beancount.plugins.auto_accounts").

pub fn find_regular(&self, name: &str) -> Option<&dyn RegularPlugin>

Find a regular-pass plugin by name.

Returns None if the plugin doesn’t exist OR if it exists but is a synth-pass plugin — the type system guarantees the returned reference is dyn RegularPlugin.

Accepts both short names ("implicit_prices") and fully qualified module paths ("beancount.plugins.implicit_prices").

pub fn iter(&self) -> impl Iterator<Item = &dyn NativePlugin>

Iterate every plugin in the registry, synth then regular. Returns trait references upcast to the base NativePlugin — callers that need pass information should use Self::find_synth / Self::find_regular instead.

pub fn has(&self, name: &str) -> bool

Check if a name refers to any plugin in this registry, in either pass. Use this for existence queries; for invocation use Self::find_synth / Self::find_regular so the returned reference’s type carries the pass.