Struct SubscriptionEntry 

pub struct SubscriptionEntry {
    pub category: EventCategory,
    pub operations: Option<HashSet<String>>,
}

A subscription entry with optional operation-level filtering.

Wraps an EventCategory with an optional set of accepted operations. This enables fine-grained subscription control: components can subscribe to a category and only receive events for specific operations.

Examples

use orcs_event::{EventCategory, SubscriptionEntry};

// Accept all operations for Echo category
let entry = SubscriptionEntry::all(EventCategory::Echo);
assert!(entry.matches(&EventCategory::Echo, "any_op"));

// Accept only specific operations for Extension category
let ext = EventCategory::extension("lua", "Extension");
let entry = SubscriptionEntry::with_operations(
    ext.clone(),
    ["route_response".to_string()],
);
assert!(entry.matches(&ext, "route_response"));
assert!(!entry.matches(&ext, "llm_response"));

Fields

category: EventCategory

The event category to subscribe to.

operations: Option<HashSet<String>>

Optional set of accepted operations within this category. None means all operations are accepted (wildcard).

Implementations

impl SubscriptionEntry

pub fn all(category: EventCategory) -> SubscriptionEntry

Create a subscription accepting all operations for a category.

pub fn with_operations( category: EventCategory, operations: impl IntoIterator<Item = String>, ) -> SubscriptionEntry

Create a subscription accepting specific operations only.

pub fn matches(&self, category: &EventCategory, operation: &str) -> bool

Check if an event matches this subscription entry.

Returns true if:

• The category matches, AND
• Either operations is None (wildcard), or the operation is in the set.

pub fn category(&self) -> &EventCategory

Returns the category of this entry.

Trait Implementations

impl Clone for SubscriptionEntry

fn clone(&self) -> SubscriptionEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubscriptionEntry

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

Formats the value using the given formatter.

impl PartialEq for SubscriptionEntry

fn eq(&self, other: &SubscriptionEntry) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SubscriptionEntry

impl StructuralPartialEq for SubscriptionEntry