Struct CheckpointNamespace 

pub struct CheckpointNamespace {
    pub segments: Vec<NamespaceSegment>,
}

Namespace for checkpoint isolation in subgraph execution

Provides hierarchical namespace isolation to prevent checkpoint collisions when executing nested subgraphs.

The wire format uses a leading | per segment with node_name:invocation_id pairs, e.g. "|review:uuid1|detail:uuid2". The root namespace is "".

Examples

use juncture_core::checkpoint::CheckpointNamespace;

let root_ns = CheckpointNamespace::root();
let child_ns = root_ns.child("review", "550e8400-e29b-41d4-a716-446655440000");
let grandchild_ns = child_ns.child("detail", "6ba7b810-9dad-11d1-80b4-00c04fd430c8");

assert_eq!(root_ns.as_str(), "");
assert_eq!(child_ns.as_str(), "|review:550e8400-e29b-41d4-a716-446655440000");
assert_eq!(grandchild_ns.as_str(), "|review:550e8400-e29b-41d4-a716-446655440000|detail:6ba7b810-9dad-11d1-80b4-00c04fd430c8");

Fields

segments: Vec<NamespaceSegment>

Namespace segments forming a hierarchical path

Implementations

impl CheckpointNamespace

pub const fn root() -> Self

Create a new root namespace (empty path)

pub const fn new(segments: Vec<NamespaceSegment>) -> Self

Create a namespace from segments

pub fn child(&self, node_name: &str, invocation_id: &str) -> Self

Create a child namespace by appending a new segment

Arguments

• node_name - The node name for this nesting level
• invocation_id - The unique invocation identifier (typically UUID v4)

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

Get the parent namespace by removing the last segment

Returns None if this is already the root namespace.

pub const fn is_root(&self) -> bool

Check if this is a root namespace

pub fn as_str(&self) -> String

Convert to string representation using the design-spec wire format

Each segment is prefixed with | and formatted as |node_name:invocation_id. Root produces "".

pub fn to_string(&self) -> String

Convert to string representation (alias for as_str)

pub fn parse(s: &str) -> Self

Parse from the design-spec wire format |name:id|name:id

Empty string produces root. Each segment is split on the first : to extract node_name and invocation_id.

Trait Implementations

impl Clone for CheckpointNamespace

fn clone(&self) -> CheckpointNamespace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheckpointNamespace

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

Formats the value using the given formatter.

impl Default for CheckpointNamespace

fn default() -> CheckpointNamespace

Returns the “default value” for a type.

impl Display for CheckpointNamespace

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

Formats the value using the given formatter.

impl From<&str> for CheckpointNamespace

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<Vec<NamespaceSegment>> for CheckpointNamespace

fn from(segments: Vec<NamespaceSegment>) -> Self

Converts to this type from the input type.

impl Hash for CheckpointNamespace

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 CheckpointNamespace

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

impl StructuralPartialEq for CheckpointNamespace