GPT 5.5review8606b7a6 months agoHistory
85 lines · 3.7 KB · Rust
RawDownload
use crate::{Repository, bstr::BString, clone::PrepareFetch}; /// Builderimpl PrepareFetch {    /// Use `f` to apply arbitrary changes to the remote that is about to be used to fetch a pack.    ///    /// The passed in `remote` will be un-named and pre-configured to be a default remote as we know it from git-clone.    /// It is not yet present in the configuration of the repository,    /// but each change it will eventually be written to the configuration prior to performing a the fetch operation,    /// _all changes done in `f()` will be persisted_.    ///    /// It can also be used to configure additional options, like those for fetching tags. Note that    /// [`with_fetch_tags()`](crate::Remote::with_fetch_tags()) should be called here to configure the clone as desired.    /// Otherwise, a clone is configured to be complete and fetches all tags, not only those reachable from all branches.    pub fn configure_remote(        mut self,        f: impl FnMut(crate::Remote<'_>) -> Result<crate::Remote<'_>, Box<dyn std::error::Error + Send + Sync>> + 'static,    ) -> Self {        self.configure_remote = Some(Box::new(f));        self    }     /// Set the remote's name to the given value after it was configured using the function provided via    /// [`configure_remote()`](Self::configure_remote()).    ///    /// If not set here, it defaults to `origin` or the value of `clone.defaultRemoteName`.    pub fn with_remote_name(mut self, name: impl Into<BString>) -> Result<Self, crate::remote::name::Error> {        self.remote_name = Some(crate::remote::name::validated(name)?);        Ok(self)    }     /// Make this clone a shallow one with the respective choice of shallow-ness.    pub fn with_shallow(mut self, shallow: crate::remote::fetch::Shallow) -> Self {        self.shallow = shallow;        self    }     /// Apply the given configuration `values` right before readying the actual fetch from the remote.    /// The configuration is marked with [source API](gix_config::Source::Api), and will not be written back, it's    /// retained only in memory.    pub fn with_in_memory_config_overrides(mut self, values: impl IntoIterator<Item = impl Into<BString>>) -> Self {        self.config_overrides = values.into_iter().map(Into::into).collect();        self    }     /// Set the `name` of the reference to check out, instead of the remote `HEAD`.    /// If `None`, the `HEAD` will be used, which is the default.    ///    /// Note that `name` should be a partial name like `main` or `feat/one`, but can be a full ref name.    /// If a branch on the remote matches, it will automatically be retrieved even without a refspec.    ///    /// # Panics    ///    /// Calling this method with a valid refspec that is not a branch name, like an object-id as hex-hash,    /// currently causes subsequent calls to [`PrepareFetch::fetch_only`] or [`PrepareFetch::fetch_then_checkout`] to panic.    pub fn with_ref_name<'a, Name, E>(mut self, name: Option<Name>) -> Result<Self, E>    where        Name: TryInto<&'a gix_ref::PartialNameRef, Error = E>,    {        self.ref_name = name.map(TryInto::try_into).transpose()?.map(ToOwned::to_owned);        Ok(self)    }} /// Consumptionimpl PrepareFetch {    /// Persist the contained repository as is even if an error may have occurred when fetching from the remote.    pub fn persist(mut self) -> Repository {        self.repo.take().expect("present and consumed once")    }} impl Drop for PrepareFetch {    fn drop(&mut self) {        if let Some(repo) = self.repo.take() {            super::cleanup_clone_destination_on_drop(&repo, self.remove_worktree_on_drop);        }    }} impl From<PrepareFetch> for Repository {    fn from(prep: PrepareFetch) -> Self {        prep.persist()    }}