Struct ForgeClient 

pub struct ForgeClient { /* private fields */ }

Unified entry point for talking to forges (GitHub, Gitea/Forgejo).

One shared HTTP agent and per-run result caches for tags, branches, and branch-exists probes. Locking is fine-grained per cache: two threads racing on the same missing key may both fetch, at the cost of one duplicated round trip.

Implementations

impl ForgeClient

pub fn new() -> Self

Build a client backed by the XDG-located persistent ETag cache.

pub fn list_tags( &self, owner: &str, repo: &str, domain: Option<&str>, ) -> Result<Tags, ApiError>

Latest-known tags for (owner, repo) at domain. Cached on success.

pub fn list_branches( &self, owner: &str, repo: &str, domain: Option<&str>, ) -> Result<Branches, ApiError>

All branch names for (owner, repo) at domain. Cached on success.

pub fn branch_exists( &self, owner: &str, repo: &str, branch: &str, domain: Option<&str>, ) -> Result<bool, ApiError>

Single-branch existence probe.

Ok(true) for an existing branch, Ok(false) for a forge that returned 404, Err(_) for any transient failure (timeout, DNS, 5xx, …). Both Ok(true) and Ok(false) are cached; errors are not.

Trait Implementations

impl Debug for ForgeClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ForgeClient

fn default() -> Self

Returns the “default value” for a type.