use std::fmt::Formatter; use git_hash::ObjectId; use git_object::bstr::BString; use crate::{ store_impl::{file, file::Transaction}, transaction::RefEdit, }; /// A function receiving an object id to resolve, returning its decompressed bytes, /// used to obtain the peeled object ids for storage in packed-refs files. /// /// Resolution means to follow tag objects until the end of the chain. pub type FindObjectFn<'a> = dyn FnMut( git_hash::ObjectId, &mut Vec, ) -> Result, Box> + 'a; /// How to handle packed refs during a transaction pub enum PackedRefs<'a> { /// Only propagate deletions of references. This is the default DeletionsOnly, /// Propagate deletions as well as updates to references which are peeled, that is contain an object id DeletionsAndNonSymbolicUpdates(Box>), /// Propagate deletions as well as updates to references which are peeled, that is contain an object id. Furthermore delete the /// reference which is originally updated if it exists. If it doesn't, the new value will be written into the packed ref right away. /// Note that this doesn't affect symbolic references at all, which can't be placed into packed refs. DeletionsAndNonSymbolicUpdatesRemoveLooseSourceReference(Box>), } impl Default for PackedRefs<'_> { fn default() -> Self { PackedRefs::DeletionsOnly } } #[derive(Debug)] pub(in crate::store_impl::file) struct Edit { update: RefEdit, lock: Option, /// Set if this update is coming from a symbolic reference and used to make it appear like it is the one that is handled, /// instead of the referent reference. parent_index: Option, /// For symbolic refs, this is the previous OID to put into the reflog instead of our own previous value. It's the /// peeled value of the leaf referent. leaf_referent_previous_oid: Option, } impl Edit { fn name(&self) -> BString { self.update.name.0.clone() } } impl std::borrow::Borrow for Edit { fn borrow(&self) -> &RefEdit { &self.update } } impl std::borrow::BorrowMut for Edit { fn borrow_mut(&mut self) -> &mut RefEdit { &mut self.update } } /// Edits impl file::Store { /// Open a transaction with the given `edits`, and determine how to fail if a `lock` cannot be obtained. /// A snapshot of packed references will be obtained automatically if needed to fulfill this transaction /// and will be provided as result of a successful transaction. Note that upon transaction failure, packed-refs /// will never have been altered. /// /// The transaction inherits the parent namespace. pub fn transaction(&self) -> Transaction<'_, '_> { Transaction { store: self, packed_transaction: None, updates: None, packed_refs: PackedRefs::default(), } } } impl<'s, 'p> Transaction<'s, 'p> { /// Configure the way packed refs are handled during the transaction pub fn packed_refs(mut self, packed_refs: PackedRefs<'p>) -> Self { self.packed_refs = packed_refs; self } } impl std::fmt::Debug for Transaction<'_, '_> { fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result { f.debug_struct("Transaction") .field("store", self.store) .field("edits", &self.updates.as_ref().map(|u| u.len())) .finish_non_exhaustive() } } /// pub mod prepare; /// pub mod commit;