cordis-group

English | 简体中文

Nested plugin groups with cascading disable for the cordis-rs plugin framework.

A group is an entry with a group array in the config file. At runtime the loader starts each group as a Group fiber and starts the child entries beneath that fiber's context: disposing the group cascades to the whole subtree, and a disabled slot anywhere on the ancestor chain — a plain flag or a !!js expression — keeps the subtree from starting at all.

entries:
  - id: staging
    name: group
    disabled: true      # cascades to every child
    group:
      - name: adapter-http

Example

use cordis::{plugin_sync, Inject, PluginOutput, FiberState};
use cordis_group::Group;
# fn main() -> cordis::Result<()> {
let root = cordis::Context::new();
let group = root.plugin_default(Group::handle());
group.try_wait()?;

// Children started under the group's context die with it.
let group_ctx = group.context().unwrap();
let child = group_ctx.plugin_default(plugin_sync::<(), _>(
    "child", Inject::default(), |_, _| Ok(PluginOutput::none()),
));
child.try_wait()?;

group.dispose()?;
assert_eq!(child.state(), FiberState::Disposed);
# Ok(())
# }

The plugin itself is a no-op nesting marker — all orchestration (walking the entry tree, starting children under the right context, patching config) lives in cordis-loader, which pre-registers the group name in its plugin registry.