Struct TabletLayout 

pub struct TabletLayout { /* private fields */ }

On-node directory layout of one tablet replica and its Raft group (spec section 12.3):

node-data/
  tablets/<tablet-id>/{state,runs,indexes,temp}   + tablet.json
  groups/<raft-group-id>/{raft,snapshots}

The applied MVCC state, sorted runs, local index generations, and compaction state live under the tablet directory; the Raft log and snapshots live under the group directory, so a group can outlive any single applied-state rebuild (spec section 4.4: runs and indexes are applied state and may be rebuilt).

Implementations

impl TabletLayout

pub fn new( node_data: impl Into<PathBuf>, tablet_id: TabletId, raft_group_id: RaftGroupId, ) -> Self

The layout of tablet_id/raft_group_id under node_data.

pub fn tablet_id(&self) -> TabletId

The tablet this layout belongs to.

pub fn raft_group_id(&self) -> RaftGroupId

The Raft group this layout belongs to.

pub fn node_data(&self) -> &Path

The node data root the layout lives under.

pub fn tablet_dir(&self) -> PathBuf

node-data/tablets/<tablet-id>.

pub fn state_dir(&self) -> PathBuf

tablets/<tablet-id>/state (applied MVCC + compaction state).

pub fn runs_dir(&self) -> PathBuf

tablets/<tablet-id>/runs (sorted runs).

pub fn indexes_dir(&self) -> PathBuf

tablets/<tablet-id>/indexes (local index generations).

pub fn temp_dir(&self) -> PathBuf

tablets/<tablet-id>/temp (spill scratch space).

pub fn group_dir(&self) -> PathBuf

node-data/groups/<raft-group-id>.

pub fn raft_dir(&self) -> PathBuf

groups/<raft-group-id>/raft (Raft log).

pub fn snapshots_dir(&self) -> PathBuf

Legacy layout path groups/<raft-group-id>/snapshots (unused by the consensus SM). Prefer Self::raft_snapshot_dir (review N3).

pub fn raft_snapshot_dir(&self) -> PathBuf

groups/<raft-group-id>/raft/snapshot — the path the consensus state machine actually writes (review N3 reconciliation).

pub fn metadata_path(&self) -> PathBuf

tablets/<tablet-id>/tablet.json.

pub fn create(&self, descriptor: &TabletDescriptor) -> Result<(), TabletError>

Creates the directory tree and persists the initial tablet metadata.

The metadata file is created atomically and only if absent (the same hard-link publish idiom as the node identity); a concurrent or repeated create that finds identical metadata succeeds, while different existing metadata fails closed with TabletError::MetadataConflict — a tablet directory is never silently repurposed.

pub fn store_metadata( &self, descriptor: &TabletDescriptor, ) -> Result<(), TabletError>

Atomically replaces the persisted metadata (used by the meta-driven apply path when the descriptor’s generation advances). The descriptor is validated and must name this layout’s tablet and group.

pub fn load_metadata(&self) -> Result<TabletDescriptor, TabletError>

Loads and verifies the persisted tablet metadata. Missing, corrupt, unknown-version, wrong-checksum, or wrong-tablet files all fail closed (spec sections 4.10, 12.3).

pub fn validate(&self) -> Result<TabletDescriptor, TabletError>

Opens the layout for use: verifies the persisted metadata and the presence of every required directory, failing closed on any missing or corrupt piece (spec section 12.3).

pub fn teardown(&self) -> Result<(), TabletError>

Removes the local replica: the tablet directory and the Raft-group directory (spec section 12.5 step 11; the consensus membership removal is the runtime’s half). Idempotent — a partially torn-down or absent directory is fine — but never destructive across identity: a tablet.json that names a different tablet or group fails closed with TabletError::TabletMismatch instead of deleting foreign state.

Trait Implementations

impl Clone for TabletLayout

fn clone(&self) -> TabletLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TabletLayout

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

Formats the value using the given formatter.

impl Eq for TabletLayout

impl PartialEq for TabletLayout

fn eq(&self, other: &TabletLayout) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TabletLayout