Struct NodeRegistry 

pub struct NodeRegistry { /* private fields */ }

Registry for behavior node types.

The NodeRegistry provides a factory pattern for creating behavior nodes from string identifiers and JSON configuration. This enables loading behavior trees from JSON files without hardcoding node types.

Thread Safety

The registry is thread-safe and can be shared across multiple threads using Arc. Internally it uses RwLock to allow concurrent reads while serializing writes.

Example

use mecha10_behavior_runtime::prelude::*;
use mecha10_behavior_runtime::NodeRegistry;
use serde_json::json;


// Create a registry
let mut registry = NodeRegistry::new();

// Register a node type
registry.register("my_behavior", |config| {
    Ok(Box::new(MyBehavior))
});

// Create an instance from the registry
let node = registry.create("my_behavior", json!({})).unwrap();

Implementations

impl NodeRegistry

pub fn new() -> Self

Create a new empty node registry.

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

where F: Fn(Value) -> Result<BoxedBehavior> + Send + Sync + 'static,

Register a node type with a factory function.

The factory function will be called each time a node of this type is created. It receives the JSON configuration and should return a boxed behavior node.

Arguments

• node_type - String identifier for this node type (e.g., “move_to_goal”)
• factory - Function that creates instances of this node type

Example

use mecha10_behavior_runtime::NodeRegistry;
use serde_json::json;


let mut registry = NodeRegistry::new();

registry.register("move", |config| {
    let speed = config.get("speed")
        .and_then(|v| v.as_f64())
        .unwrap_or(1.0);
    Ok(Box::new(MoveBehavior { speed }))
});

pub fn create(&self, node_type: &str, config: Value) -> Result<BoxedBehavior>

Create a node instance from a registered type.

This looks up the factory function for the given node type and calls it with the provided configuration to create a new instance.

Arguments

• node_type - The type identifier that was used during registration
• config - JSON configuration to pass to the factory function

Returns

A boxed behavior node instance, or an error if:

• The node type is not registered
• The factory function returns an error

Example

use mecha10_behavior_runtime::NodeRegistry;
use serde_json::json;


let config = json!({ "speed": 2.0 });
let node = registry.create("move", config).unwrap();

pub fn has_node(&self, node_type: &str) -> bool

Check if a node type is registered.

Arguments

• node_type - The type identifier to check

Returns

true if the node type is registered, false otherwise

Example

use mecha10_behavior_runtime::NodeRegistry;

let mut registry = NodeRegistry::new();
registry.register("move", |_| Ok(Box::new(mecha10_behavior_runtime::SequenceNode::new(vec![]))));

assert!(registry.has_node("move"));
assert!(!registry.has_node("unknown"));

pub fn contains(&self, node_type: &str) -> bool

Check if a node type is registered.

Example

use mecha10_behavior_runtime::NodeRegistry;

let mut registry = NodeRegistry::new();
registry.register("move", |_| Ok(Box::new(mecha10_behavior_runtime::SequenceNode::new(vec![]))));

assert!(registry.contains("move"));
assert!(!registry.contains("unknown"));

pub fn registered_types(&self) -> Vec<String>

Get a list of all registered node types.

Example

use mecha10_behavior_runtime::NodeRegistry;

let mut registry = NodeRegistry::new();
registry.register("move", |_| Ok(Box::new(mecha10_behavior_runtime::SequenceNode::new(vec![]))));
registry.register("rotate", |_| Ok(Box::new(mecha10_behavior_runtime::SequenceNode::new(vec![]))));

let types = registry.registered_types();
assert!(types.contains(&"move".to_string()));
assert!(types.contains(&"rotate".to_string()));

pub fn len(&self) -> usize

Get the number of registered node types.

Example

use mecha10_behavior_runtime::NodeRegistry;

let mut registry = NodeRegistry::new();
assert_eq!(registry.len(), 0);

registry.register("move", |_| Ok(Box::new(mecha10_behavior_runtime::SequenceNode::new(vec![]))));
assert_eq!(registry.len(), 1);

pub fn is_empty(&self) -> bool

Check if the registry is empty.

Example

use mecha10_behavior_runtime::NodeRegistry;

let registry = NodeRegistry::new();
assert!(registry.is_empty());

Trait Implementations

impl Clone for NodeRegistry

fn clone(&self) -> NodeRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeRegistry

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

Formats the value using the given formatter.

impl Default for NodeRegistry

fn default() -> Self

Returns the “default value” for a type.