Struct GitFetcher 

pub struct GitFetcher { /* private fields */ }

Fetcher implementation backed by libgit2.

Implementations

impl GitFetcher

pub fn new(cache_root: PathBuf) -> Self

Create a new GitFetcher that stores clones under cache_root.

pub fn list_tags(&self, url: &str) -> Result<Vec<String>, PkgError>

List remote tag names by ls-remote (no clone).

Connects to url in fetch direction, enumerates refs/tags/*, strips the refs/tags/ prefix and the ^{} peeled-tag suffix when present, and returns a de-duplicated Vec<String> in arbitrary order.

pub fn ls_remote_refs( &self, url: &str, ) -> Result<Vec<(String, String)>, PkgError>

ls-remote: every advertised ref as (name, oid hex), e.g. ("refs/tags/v1.0.0^{}", "abc…") / ("refs/heads/main", "…") / ("HEAD", "…"). Transfers ref names only, no objects.

pub fn resolve_sha( &self, dep: &Dep, ) -> Result<Option<(String, Option<String>)>, PkgError>

Resolve dep to its commit without cloning, when the pin allows it: a full 40-hex rev needs no network, tag / branch / no pin cost one ls-remote. Returns None for a short / symbolic rev or a ref the remote does not advertise (a real fetch then produces the error). Used by install to decide whether a patch_dir is still based on the pinned commit before touching the cache.

Errors

PkgError::Validation for a malformed URL, PkgError::GitFetch when the remote cannot be listed.

Trait Implementations

impl Fetcher for GitFetcher

fn fetch(&self, dep: &Dep) -> Result<FetchedPkg, PkgError>

Fetch the package described by dep and return a FetchedPkg.