Struct UpdateBuilder 

pub struct UpdateBuilder { /* private fields */ }

Build an update mutation. The filter selects records; the chained set/unset/add_tag/remove_tag calls accumulate operations applied to each matching record’s frontmatter.

Implementations

impl UpdateBuilder

pub fn new(folder: impl Into<String>, filter: Expr) -> Self

pub fn set(self, field: impl Into<String>, value: Value) -> Self

pub fn unset(self, field: impl Into<String>) -> Self

pub fn add_tag(self, tag: impl Into<String>) -> Self

pub fn remove_tag(self, tag: impl Into<String>) -> Self

pub fn with_vault_schema(self, schema: VaultSchema) -> Self

Attach the vault-wide schema. When set, every matched record’s post-update field map is validated against all applicable collections (folder ancestor + filter match) before the writer runs. A record whose projected state would violate any applicable collection is reported as a MutationError and skipped — the rest of the batch still proceeds. Strict mode: the whole projected record must validate, so pre-existing violations surface on the first update touching the record.

pub fn write_options(self, opts: WriteOptions) -> Self

Replace the writer::WriteOptions used by execute. See its docs for what each field controls. Defaults to fast (no fsync).

pub fn fsync(self, yes: bool) -> Self

Convenience: enable durable writes (fsync data + parent dir). Equivalent to .write_options(WriteOptions::durable()).

pub fn plan(&self, vault: &Vault) -> Result<MutationReport>

Compute the report without writing.

pub fn execute(self, vault: &Vault) -> Result<MutationReport>

Plan, then apply each computed WriteResult to disk.

Holds the vault-scoped exclusive lock (see crate::lock) for the entire duration of compute + writes, so concurrent mutations from other vaultdb-core consumers serialize cleanly. Each individual file write is atomic via tempfile+rename — readers never see a partial write.

Trait Implementations

impl Clone for UpdateBuilder

fn clone(&self) -> UpdateBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateBuilder

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

Formats the value using the given formatter.