Struct GitResolver 

pub struct GitResolver(/* private fields */);

A resolver for Git repositories.

Implementations

impl GitResolver

pub fn insert(&self, reference: RepositoryReference, sha: GitOid)

Inserts a new GitOid for the given RepositoryReference.

pub fn get_precise(&self, url: &GitUrl) -> Option<GitOid>

Return the GitOid for the given GitUrl, if it is already known.

pub async fn github_fast_path( &self, url: &GitUrl, client: &ClientWithMiddleware, ) -> Result<Option<GitOid>, GitResolverError>

Resolve a Git URL to a specific commit without performing any Git operations.

Returns a GitOid if the URL has already been resolved (i.e., is available in the cache), or if it can be fetched via the GitHub API. Otherwise, returns None.

pub async fn fetch( &self, url: &GitUrl, disable_ssl: bool, offline: bool, cache: PathBuf, reporter: Option<Arc<dyn Reporter>>, ) -> Result<Fetch, GitResolverError>

Fetch a remote Git repository.

pub fn precise(&self, url: GitUrl) -> Option<GitUrl>

Given a remote source distribution, return a precise variant, if possible.

For example, given a Git dependency with a reference to a branch or tag, return a URL with a precise reference to the current commit of that branch or tag.

This method takes into account various normalizations that are independent of the Git layer. For example: removing #subdirectory=pkg_dir-like fragments, and removing git+ prefix kinds.

This method will only return precise URLs for URLs that have already been resolved via [resolve_precise], and will return None for URLs that have not been resolved or already have a precise reference.

pub fn same_ref(&self, a: &GitUrl, b: &GitUrl) -> bool

Returns true if the two Git URLs refer to the same precise commit.

Trait Implementations

impl Clone for GitResolver

fn clone(&self) -> GitResolver

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for GitResolver

fn default() -> GitResolver

Returns the “default value” for a type.