use crate::{ Repository, bstr::{BString, ByteSlice}, clone::PrepareFetch, }; /// Builder impl 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, Box> + '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) -> Result { 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>) -> 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. /// /// Setting `name` to `Some(_)` clears a revision previously set with [`with_revision()`](Self::with_revision). /// Passing `None` leaves the revision unchanged. pub fn with_ref_name<'a, Name, E>(mut self, name: Option) -> Result where Name: TryInto<&'a gix_ref::PartialNameRef, Error = E>, { self.ref_name = name.map(TryInto::try_into).transpose()?.map(ToOwned::to_owned); if self.ref_name.is_some() { self.revision = None; } Ok(self) } /// Fetch only `revision` and check it out with a detached `HEAD`. /// /// A revision is either `HEAD`, a full reference name like `refs/heads/main`, or a full object ID. /// No local or remote-tracking references are created and no fetch refspec is persisted. /// It replaces any extra refspecs supplied with [`with_fetch_options()`](Self::with_fetch_options) /// before fetching. /// Setting `revision` to `Some(_)` clears a ref name previously set with [`with_ref_name()`](Self::with_ref_name). /// Passing `None` leaves the ref name unchanged. pub fn with_revision( mut self, revision: Option>, ) -> Result { self.revision = revision .map(|revision| { let revision = revision.into(); let spec = gix_refspec::parse(revision.as_ref(), gix_refspec::parse::Operation::Fetch)?; let source = spec.source().expect("one-sided non-empty fetch refspec"); let is_full_ref = source.starts_with(b"refs/") && source.find_byteset(b"*?[]\\").is_none(); let is_valid = revision.as_bstr() == source && spec.destination().is_none() && (source == "HEAD" || is_full_ref || gix_hash::ObjectId::from_hex(source).is_ok()); is_valid .then(|| spec.to_owned()) .ok_or(crate::clone::with_revision::Error::Invalid { revision }) }) .transpose()?; if self.revision.is_some() { self.ref_name = None; } Ok(self) } } /// Consumption impl 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 for Repository { fn from(prep: PrepareFetch) -> Self { prep.persist() } }