Struct MemoryRefStore 

pub struct MemoryRefStore { /* private fields */ }

Fully in-memory ref database with transactional updates.

Built only on the public super::backend helpers, so it doubles as a reference for custom backends. One prepared transaction at a time holds the whole store; another prepare meanwhile fails with RefStoreError::LockHeld, which grit-lib’s ref writes retry (see crate::refs::prepare_with_lock_wait).

Implementations

impl MemoryRefStore

pub fn new() -> Self

Create an empty store.

pub fn set_ref( &self, name: impl Into<String>, value: RawRef, ) -> Result<(), RefStoreError>

Seed a ref without going through a transaction (tests and setup).

Errors

Returns RefStoreError::LockHeld naming name when a transaction is prepared.

Trait Implementations

impl Debug for MemoryRefStore

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

Formats the value using the given formatter.

impl Default for MemoryRefStore

fn default() -> Self

Returns the “default value” for a type.

impl RefStore for MemoryRefStore

fn format(&self) -> RefStorageFormat

Which on-disk or logical format this store uses.

fn read_raw(&self, name: &str) -> Result<Option<RawRef>>

Read the stored value for name without resolving symbolic targets.

fn for_each_ref( &self, prefix: &str, f: &mut dyn FnMut(&RefEntry) -> ControlFlow<()>, ) -> Result<()>

Invoke f for each ref whose name starts with prefix, in sorted name order.

fn prepare( &self, txn: RefTransaction, ) -> Result<Box<dyn PreparedRefTransaction + Send + '_>, RefStoreError>

Validate txn, take locks, and return a committable batch.

fn reflog_exists(&self, name: &str) -> Result<bool>

Whether a reflog is present for name.

fn for_each_reflog_entry( &self, name: &str, reverse: bool, f: &mut dyn FnMut(&ReflogEntry) -> ControlFlow<()>, ) -> Result<()>

Iterate reflog entries for name (oldest first unless reverse).

fn create_reflog(&self, name: &str) -> Result<()>

Create an empty reflog file/record for name.

fn delete_reflog(&self, name: &str) -> Result<()>

Remove the reflog for name.

fn replace_reflog(&self, name: &str, entries: Vec<ReflogEntry>) -> Result<()>

Replace the entire reflog (used by expire/delete-entries).

fn rewrite_reflog( &self, name: &str, transform: &mut dyn FnMut(Vec<ReflogEntry>) -> Result<Vec<ReflogEntry>>, ) -> Result<()>

Read a reflog under the backend writer lock, transform it, and write it back atomically.

fn for_each_reflog_ref( &self, f: &mut dyn FnMut(&str) -> ControlFlow<()>, ) -> Result<()>

Invoke f for each ref name that has a reflog, in sorted order.

fn resolve(&self, name: &str) -> Result<ObjectId>

Resolve name to an object id, following symbolic refs.

fn for_each_physical_stack_ref( &self, prefix: &str, f: &mut dyn FnMut(&RefEntry) -> ControlFlow<()>, ) -> Result<()>

Walk refs stored in this handle’s physical reftable stack (reftable/ under the store git directory). On the files backend this matches Self::for_each_ref.

fn verify_update_targets( &self, updates: &[RefUpdate], ) -> Result<(), RefStoreError>

Check the objects updates would point refs at, without taking any lock or writing.

fn as_files(&self) -> Option<&FilesRefStore>

The files backend behind this store, when it is one.

fn ref_lock_wait(&self) -> LockWait

How long grit-lib retries RefStoreError::LockHeld from Self::prepare.