Struct Namespace 

pub struct Namespace { /* private fields */ }

Durable finite namespace records for one expression tree.

Implementations

impl Namespace

pub fn new(tree_id: TreeId, root_dir: DirId) -> Self

Create a namespace with one root directory record.

pub fn tree_id(&self) -> &TreeId

The namespace tree id.

pub fn root_dir(&self) -> &DirId

Root directory identity.

pub fn acquire_writer(&mut self) -> Result<WriterLane, NamespaceError>

Acquire the single serialized writer lane.

pub fn release_writer(&mut self, lane: WriterLane) -> Result<(), NamespaceError>

Release a previously acquired writer lane.

pub fn reservation_count(&self) -> usize

Number of durable name reservations.

pub fn counter_count(&self) -> usize

Number of generated-name counters.

pub fn dir(&self, id: &DirId) -> Option<&DirRecord>

Read a directory by id without allocating namespace state.

pub fn cell(&self, id: &CellId) -> Option<&CellRecord>

Read a cell by id without allocating namespace state.

pub fn child( &self, parent: &DirId, name: &NamespaceName, ) -> Option<NamespaceEntry>

Read a named child without allocating namespace state.

pub fn children( &self, parent: &DirId, ) -> Result<Vec<(NamespaceName, NamespaceEntry)>, NamespaceError>

Lists a directory’s named children in deterministic name order.

pub fn reserve_name( &mut self, lane: WriterLane, parent: &DirId, name: NamespaceName, ) -> Result<NamespaceName, NamespaceError>

Reserve an explicit child name before creating the durable node.

pub fn reserve_generated_name( &mut self, lane: WriterLane, parent: &DirId, kind: GeneratedNameKind, ) -> Result<NamespaceName, NamespaceError>

Reserve a generated child name before creating the durable node.

pub fn create_cell( &mut self, lane: WriterLane, request: CellCreate, ) -> Result<(), NamespaceError>

Create a durable cell from a prior reservation.

pub fn create_dir( &mut self, lane: WriterLane, id: DirId, parent: &DirId, name: NamespaceName, policy_patch: CodecPolicyPatch, ) -> Result<(), NamespaceError>

Create a durable child directory from a prior reservation.

pub fn move_cell( &mut self, lane: WriterLane, id: &CellId, new_parent: &DirId, new_name: NamespaceName, ) -> Result<(), NamespaceError>

Rename or move a cell while preserving immutable cell identity.

pub fn move_dir( &mut self, lane: WriterLane, id: &DirId, new_parent: &DirId, new_name: NamespaceName, ) -> Result<(), NamespaceError>

Rename or move a directory while preserving immutable directory identity.

pub fn set_cell_policy( &mut self, lane: WriterLane, id: &CellId, policy_patch: CodecPolicyPatch, ) -> Result<(), NamespaceError>

Replaces a cell’s local codec-policy patch.

pub fn set_dir_policy( &mut self, lane: WriterLane, id: &DirId, policy_patch: CodecPolicyPatch, ) -> Result<(), NamespaceError>

Replaces a directory’s local codec-policy patch.

pub fn delete_cell( &mut self, lane: WriterLane, id: &CellId, ) -> Result<CellRecord, NamespaceError>

Deletes one cell while preserving its generated-name reservation history.

pub fn delete_dir( &mut self, lane: WriterLane, id: &DirId, ) -> Result<DirRecord, NamespaceError>

Deletes one empty non-root directory.

pub fn effective_dir_policy( &self, id: &DirId, ) -> Result<EffectiveCodecPolicy, NamespaceError>

Resolve the inherited policy for a directory.

pub fn effective_cell_policy( &self, id: &CellId, ) -> Result<EffectiveCodecPolicy, NamespaceError>

Resolve the inherited policy for a cell, applying the cell patch last.

impl Namespace

pub fn codec_patch(codec: impl Into<String>) -> CodecPolicyPatch

Convenience policy patch for tests and callers that need only a codec.

Trait Implementations

impl Debug for Namespace

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

Formats the value using the given formatter.