Struct ResourceGroupRegistry 

pub struct ResourceGroupRegistry { /* private fields */ }

Node-local registry of resource groups (S1E-002), with configured defaults for every workload class (§13.1 queue set).

The control and replication groups are pinned: they cannot be removed and cannot be re-registered without reserved (max_concurrency > 0 and memory_bytes > 0) capacity — spec §13.1 “control and replication have reserved capacity” and §4.9 bounded resources.

Serde form is a JSON/object map of name → group (sorted by name, so the serialized form is deterministic) for later cluster-settings replication (S1F-001). Deserialization re-asserts the pinned defaults: a replicated settings document that omits or starves the control/replication groups is rejected rather than applied.

Implementations

impl ResourceGroupRegistry

pub fn new() -> Self

An empty registry (no defaults). Prefer with_defaults for any serving node.

pub fn with_defaults() -> Self

A registry seeded with the configured default group of every workload class (§13.1), control and replication pinned with reserved capacity.

pub fn register(&self, group: ResourceGroup) -> Result<(), ResourceError>

Registers (or replaces) a group after validation. Replacing a pinned control/replication group is rejected unless the replacement keeps reserved (max_concurrency > 0 and memory_bytes > 0) capacity.

pub fn get(&self, name: &str) -> Option<ResourceGroup>

Looks up a group by name.

pub fn lookup(&self, name: &str) -> Result<ResourceGroup, ResourceError>

Like get, but a typed error for the not-found case.

pub fn remove(&self, name: &str) -> Result<bool, ResourceError>

Removes a group by name. Pinned control/replication groups cannot be removed (§13.1 reserved capacity). Returns true if a group was removed.

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

Sorted names of every registered group.

pub fn len(&self) -> usize

Number of registered groups.

pub fn is_empty(&self) -> bool

Whether no groups are registered.

Trait Implementations

impl Debug for ResourceGroupRegistry

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

Formats the value using the given formatter.

impl Default for ResourceGroupRegistry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResourceGroupRegistry

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Restores a registry from its map form, then re-asserts the pinned control/replication defaults: a document that omits or starves them is rejected (reserved capacity is a safety invariant, not a preference).

impl Serialize for ResourceGroupRegistry

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serializes as a name → group map (BTreeMap order: deterministic).