119 lines · 4.7 KB · Rust
RawDownload
#![allow(clippy::result_large_err)]use std::convert::TryInto; use crate::bstr::BString;use crate::config::tree::gitoxide; type ConfigureRemoteFn =    Box<dyn FnMut(crate::Remote<'_>) -> Result<crate::Remote<'_>, Box<dyn std::error::Error + Send + Sync>>>; /// A utility to collect configuration on how to fetch from a remote and initiate a fetch operation. It will delete the newly/// created repository on when dropped without successfully finishing a fetch.#[must_use]pub struct PrepareFetch {    /// A freshly initialized repository which is owned by us, or `None` if it was handed to the user    repo: Option<crate::Repository>,    /// The name of the remote, which defaults to `origin` if not overridden.    remote_name: Option<BString>,    /// A function to configure a remote prior to fetching a pack.    configure_remote: Option<ConfigureRemoteFn>,    /// Options for preparing a fetch operation.    #[cfg(any(feature = "async-network-client", feature = "blocking-network-client"))]    fetch_options: crate::remote::ref_map::Options,    /// The url to clone from    #[cfg_attr(not(feature = "blocking-network-client"), allow(dead_code))]    url: git_url::Url,} /// The error returned by [`PrepareFetch::new()`].#[derive(Debug, thiserror::Error)]#[allow(missing_docs)]pub enum Error {    #[error(transparent)]    Init(#[from] crate::init::Error),    #[error(transparent)]    UrlParse(#[from] git_url::parse::Error),    #[error("Failed to turn a the relative file url \"{}\" into an absolute one", url.to_bstring())]    CanonicalizeUrl {        url: git_url::Url,        source: git_path::realpath::Error,    },} /// Instantiationimpl PrepareFetch {    /// Create a new repository at `path` with `crate_opts` which is ready to clone from `url`, possibly after making additional adjustments to    /// configuration and settings.    ///    /// Note that this is merely a handle to perform the actual connection to the remote, and if any of it fails the freshly initialized repository    /// will be removed automatically as soon as this instance drops.    ///    /// # Deviation    ///    /// Similar to `git`, a missing user name and email configuration is not terminal and we will fill it in with dummy values. However,    /// instead of deriving values from the system, ours are hardcoded to indicate what happened.    #[allow(clippy::result_large_err)]    pub fn new<Url, E>(        url: Url,        path: impl AsRef<std::path::Path>,        kind: crate::create::Kind,        mut create_opts: crate::create::Options,        open_opts: crate::open::Options,    ) -> Result<Self, Error>    where        Url: TryInto<git_url::Url, Error = E>,        git_url::parse::Error: From<E>,    {        let mut url = url.try_into().map_err(git_url::parse::Error::from)?;        url.canonicalize().map_err(|err| Error::CanonicalizeUrl {            url: url.clone(),            source: err,        })?;        create_opts.destination_must_be_empty = true;        let mut repo = crate::ThreadSafeRepository::init_opts(path, kind, create_opts, open_opts)?.to_thread_local();        if repo.committer().is_none() {            let mut config = git_config::File::new(git_config::file::Metadata::api());            config                .set_raw_value(                    "gitoxide",                    Some("committer".into()),                    gitoxide::Committer::NAME_FALLBACK.name,                    "no name configured during clone",                )                .expect("works - statically known");            config                .set_raw_value(                    "gitoxide",                    Some("committer".into()),                    gitoxide::Committer::EMAIL_FALLBACK.name,                    "noEmailAvailable@example.com",                )                .expect("works - statically known");            let mut repo_config = repo.config_snapshot_mut();            repo_config.append(config);            repo_config.commit().expect("configuration is still valid");        }        Ok(PrepareFetch {            url,            #[cfg(any(feature = "async-network-client", feature = "blocking-network-client"))]            fetch_options: Default::default(),            repo: Some(repo),            remote_name: None,            configure_remote: None,        })    }} /// A utility to collect configuration on how to perform a checkout into a working tree, and when dropped without checking out successfully/// the fetched repository will be dropped.#[must_use]pub struct PrepareCheckout {    /// A freshly initialized repository which is owned by us, or `None` if it was handed to the user    pub(self) repo: Option<crate::Repository>,} ///pub mod fetch; ///pub mod checkout;