Struct MemoryScope 

pub struct MemoryScope {
    pub level: ScopeLevel,
    pub path: String,
}

A memory scope with a path-based address.

The path format mirrors a URI path, e.g.: "global", "global/org:acme", "global/org:acme/user:alice".

Fields

level: ScopeLevel

path: String

Implementations

impl MemoryScope

pub fn new(level: ScopeLevel, path: impl Into<String>) -> Result<Self>

Create a new scope, validating that the path depth matches the level.

pub fn global() -> Self

Shorthand constructor for the global scope.

pub fn parse(path: &str) -> Result<Self>

Parse a path string into a MemoryScope.

The level is inferred from the number of /-separated segments: 1 → Global, 2 → Org, 3 → User, 4 → Session, 5 → Agent.

pub fn parent(&self) -> Option<MemoryScope>

Return the immediate parent scope, or None for the Global scope.

pub fn ancestors(&self) -> Vec<MemoryScope>

Return all ancestor scopes from the immediate parent up to (and including) the Global scope. Order: closest ancestor first.

pub fn contains(&self, other: &MemoryScope) -> bool

Returns true if self is an ancestor of (or equal to) other.

Equivalently: self “contains” other if other.path starts with self.path followed by / (or is identical).

Trait Implementations

impl Clone for MemoryScope

fn clone(&self) -> MemoryScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryScope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryScope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for MemoryScope

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

Formats the value using the given formatter.

impl Hash for MemoryScope

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for MemoryScope

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MemoryScope

impl StructuralPartialEq for MemoryScope