Struct AgentGroups 

pub struct AgentGroups {
    pub groups: Vec<String>,
}

Value stored in the agent_groups KV bucket, keyed by pc_id. The wrapper struct (instead of a bare Vec<String>) leaves room for future per-PC metadata (membership timestamps, who-set-it audit, …) without breaking the wire format.

Fields

groups: Vec<String>

Sorted, de-duplicated group names. Producers should call AgentGroups::new / AgentGroups::insert / AgentGroups::remove to maintain those invariants; consumers can rely on them when diffing two snapshots for “what changed since last KV update”.

Implementations

impl AgentGroups

pub fn new<I, S>(groups: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Construct from any iterator. Sorts + dedups so two callers that produce the same logical set get bit-identical JSON.

pub fn insert(&mut self, group: impl Into<String>) -> bool

Insert a group. Returns true if the membership actually changed (i.e. the group wasn’t already present). Keeps the inner Vec sorted.

pub fn remove(&mut self, group: &str) -> bool

Remove a group. Returns true if the membership actually changed (i.e. the group was present).

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

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> Iter<'_, String>

Trait Implementations

impl Clone for AgentGroups

fn clone(&self) -> AgentGroups

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentGroups

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

Formats the value using the given formatter.

impl Default for AgentGroups

fn default() -> AgentGroups

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentGroups

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AgentGroups

impl PartialEq for AgentGroups

fn eq(&self, other: &AgentGroups) -> 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 Serialize for AgentGroups

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AgentGroups