//! The command registry, keyed by command id. use std::collections::BTreeMap; use crate::{Command, EngineError}; /// All registered commands, in id order. #[derive(Default)] pub struct Registry { /// Commands by id. commands: BTreeMap<&'static str, Box>, } impl Registry { /// Adds a command. /// /// # Errors /// Returns [`EngineError::Internal`] if the id is already taken; two /// commands with one id is a programming error. pub fn register(&mut self, command: Box) -> Result<(), EngineError> { let id = command.spec().id; if self.commands.contains_key(id) { return Err(EngineError::Internal(format!( "command registered twice: {id}" ))); } self.commands.insert(id, command); Ok(()) } /// Looks a command up by id. pub fn get(&self, id: &str) -> Option<&dyn Command> { self.commands.get(id).map(Box::as_ref) } /// The ids of every command. pub fn ids(&self) -> impl Iterator + '_ { self.commands.keys().copied() } /// Iterates over the commands in id order. pub fn iter(&self) -> impl Iterator { self.commands.values().map(Box::as_ref) } /// Number of registered commands. pub fn len(&self) -> usize { self.commands.len() } /// Whether no command is registered. pub fn is_empty(&self) -> bool { self.commands.is_empty() } }