Struct HatRegistry 

pub struct HatRegistry { /* private fields */ }

Registry for managing and creating hats from configuration.

Implementations

impl HatRegistry

pub fn new() -> Self

Creates a new empty registry.

pub fn from_config(config: &RalphConfig) -> Self

Creates a registry from configuration.

Empty config → empty registry (HatlessRalph is the fallback, not default hats).

pub fn register(&mut self, hat: Hat)

Registers a hat with the registry.

pub fn register_with_config(&mut self, hat: Hat, config: HatConfig)

Registers a hat with its configuration.

pub fn get(&self, id: &HatId) -> Option<&Hat>

Gets a hat by ID.

pub fn get_config(&self, id: &HatId) -> Option<&HatConfig>

Gets a hat’s configuration by ID.

pub fn all(&self) -> impl Iterator<Item = &Hat>

Returns all hats in the registry.

pub fn ids(&self) -> impl Iterator<Item = &HatId>

Returns all hat IDs.

pub fn len(&self) -> usize

Returns the number of registered hats.

pub fn is_empty(&self) -> bool

Returns true if no hats are registered.

pub fn subscribers(&self, topic: &Topic) -> Vec<&Hat>

Finds all hats subscribed to a topic. BTreeMap iteration is already sorted by key.

pub fn find_by_trigger(&self, topic: &str) -> Option<&HatId>

Finds the first hat that would be triggered by a topic. Returns the hat ID if found, used for event logging. BTreeMap iteration is already sorted by key.

pub fn has_subscriber(&self, topic: &str) -> bool

Returns true if any hat is subscribed to the given topic.

pub fn can_publish(&self, hat_id: &HatId, topic: &str) -> bool

Check if a hat is allowed to publish the given topic.

Returns true for unregistered hats (Ralph can publish anything). Uses the same pattern matching as subscription routing.

pub fn get_for_topic(&self, topic: &str) -> Option<&Hat>

Returns the first hat subscribed to the given topic.

Uses prefix index for O(1) early-exit when the topic prefix doesn’t match any subscription pattern.

Trait Implementations

impl Debug for HatRegistry

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

Formats the value using the given formatter.

impl Default for HatRegistry

fn default() -> HatRegistry

Returns the “default value” for a type.