Struct NativeTreeMaterializationBackend 

pub struct NativeTreeMaterializationBackend { /* private fields */ }

Native same-volume tree publisher used for root checkout application.

Callers first materialize the exact target generation into target. The operation directory may be a sibling of the checkout so no repository marker is required, but it must not be the checkout, an ancestor, or a descendant. Each top-level binding is then exchanged with the live root independently. The displaced live binding remains in backup until the journal is terminal, preserving metadata, sparse allocation, links, and hard-link identity for rollback without re-encoding host state.

Implementations

impl NativeTreeMaterializationBackend

pub fn new( root: impl Into<PathBuf>, operation_directory: impl Into<PathBuf>, ) -> Result<Self, NativeTreeMaterializationError>

Binds an existing checkout root and same-volume operation directory. operation_directory/target must contain the fully materialized target tree; operation_directory/backup is owned by this backend.

Trait Implementations

impl Clone for NativeTreeMaterializationBackend

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl MaterializationBackend for NativeTreeMaterializationBackend

Available on non-WebAssembly only.

type Error = NativeTreeMaterializationError

Backend error.

async fn capture( &self, edit: &MaterializationEdit, ) -> Result<MaterializationPreimage, Self::Error>

Captures a complete preimage without mutating the checkout.

async fn observe( &self, edit: &MaterializationEdit, preimage: &MaterializationPreimage, ) -> Result<MaterializationObservation, Self::Error>

Classifies the current path against both durable endpoints.

async fn apply( &self, edit: &MaterializationEdit, preimage: &MaterializationPreimage, ) -> Result<(), Self::Error>

Applies one declarative edit idempotently.

async fn restore( &self, edit: &MaterializationEdit, preimage: &MaterializationPreimage, ) -> Result<(), Self::Error>

Restores the exact preimage for one edit idempotently.

fn verify_source( &self, _from: GenerationId, ) -> impl Future<Output = Result<bool, Self::Error>> + Send

Verifies that the checkout still represents the plan’s exact source. Backends without an independently observable generation may retain the conservative default and provide equivalent fencing externally.