Struct ViewStore 

pub struct ViewStore { /* private fields */ }

Checkout-scoped storage for immutable manifests and the SQLite current pointer.

Implementations

impl ViewStore

pub fn derived_path(&self, generation: &str) -> Result<PathBuf>

pub fn trigram_path(&self, generation: &str) -> Result<PathBuf>

pub fn blob_references_by_generation( &self, ) -> Result<BTreeMap<String, BTreeSet<[u8; 32]>>>

pub fn sweep_generations(&self) -> Result<usize>

Remove generation files only after checking both durable publication and liveness. A dead assembler can leave a derived file before any manifest.

impl ViewStore

pub fn open(storage: impl AsRef<Path>, project_scope_key: &str) -> Result<Self>

Opens <storage>/views/<project_scope_key> and initializes its singleton pointer row under BEGIN IMMEDIATE so concurrent first opens agree.

pub fn view_dir(&self) -> &Path

pub fn pointer_path(&self) -> PathBuf

pub fn manifest_path(&self, generation: &str) -> Result<PathBuf>

pub fn current_generation(&self) -> Result<Option<String>>

pub fn pointer_pragmas(&self) -> Result<PointerPragmas>

Reads the settings installed on a new pointer connection. SQLite keeps synchronous, busy_timeout, and foreign_keys per connection, so this check must use the same open path as publication rather than a raw handle.

pub fn load_manifest(&self, generation: &str) -> Result<Manifest>

pub fn publish( &self, request: &PublicationRequest<'_>, closure: &impl PublicationClosure, ) -> Result<PublishOutcome>

Publishes a fully durable generation. The manifest is written exactly once; a lost pointer race leaves that immutable manifest unreferenced so a caller can safely re-derive from the winner without losing either update.

pub fn publish_with_observer( &self, request: &PublicationRequest<'_>, closure: &impl PublicationClosure, observer: Option<&dyn PublicationObserver>, ) -> Result<PublishOutcome>

pub fn prepare_with_observer( &self, request: &PublicationRequest<'_>, closure: &impl PublicationClosure, observer: Option<&dyn PublicationObserver>, ) -> Result<PreparedPublication>

Performs closure validation and all generation-sized durability work without changing the pointer. The returned token is the only input needed by CAS.

Trait Implementations

impl Clone for ViewStore

fn clone(&self) -> ViewStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ViewStore

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

Formats the value using the given formatter.