Struct CodecovClient 

pub struct CodecovClient { /* private fields */ }

Codecov API client (Bearer token + base URL).

Implementations

impl CodecovClient

pub fn new(token: impl Into<String>, api_base: impl Into<String>) -> Self

Builds a client with an explicit token and API base URL.

Panics

Panics only if the default reqwest::Client cannot be constructed (should not happen in normal environments).

pub fn from_env() -> Result<Self, ClientError>

Builds a client from CODECOV_TOKEN and optional CODECOV_API_URL.

Loads an optional .env file first (does not override existing process env).

Errors

Returns ClientError::MissingToken when the token env var is unset or empty.

pub fn api_base(&self) -> &str

API base URL without trailing slash.

pub fn totals_url( api_base: &str, owner: &str, repo: &str, branch: Option<&str>, sha: Option<&str>, ) -> String

Builds the totals URL for a GitHub repo.

pub fn file_report_url( api_base: &str, owner: &str, repo: &str, path: &str, branch: Option<&str>, sha: Option<&str>, ) -> String

Builds the file report URL for a path inside a GitHub repo.

pub async fn totals( &self, owner: &str, repo: &str, branch: Option<&str>, sha: Option<&str>, ) -> Result<CoverageReport, ClientError>

Fetches commit coverage totals (including per-file breakdown).

Errors

Returns ClientError::Http, ClientError::Api, or ClientError::Json.

pub async fn miss_files( &self, owner: &str, repo: &str, branch: Option<&str>, sha: Option<&str>, limit: usize, ) -> Result<MissFilesResult, ClientError>

Files with misses, sorted descending, capped by limit (0 = uncapped).

Errors

Same as Self::totals.

pub async fn file_report( &self, owner: &str, repo: &str, path: &str, branch: Option<&str>, sha: Option<&str>, ) -> Result<ReportFile, ClientError>

Fetches line coverage for a single file path.

Errors

Same as Self::totals.

Trait Implementations

impl Clone for CodecovClient

fn clone(&self) -> CodecovClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CodecovClient

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

Formats the value using the given formatter.