Struct GitHubClient 

pub struct GitHubClient { /* private fields */ }

GitHub API client wrapper.

• Provides a simplified interface for common GitHub operations used in wtg over direct octocrab usage.
• Handles authentication via GITHUB_TOKEN env var or gh CLI config.
• Supports fallback to anonymous requests on SAML errors via backup client.
• Converts known octocrab errors into WtgError variants.
• Returns None from new() if no client can be created.

Implementations

impl GitHubClient

pub fn new() -> Option<Self>

Create a new GitHub client.

Returns None if no client (neither authenticated nor anonymous) can be created. If authentication succeeds, an anonymous backup client is created for SAML fallback. If authentication fails, the anonymous client becomes the main client with no backup.

pub fn new_with_token(token: String) -> Option<Self>

Create a GitHub client with a specific token.

Builds an authenticated client using the given token, with an anonymous backup for fallback on SAML or bad credentials errors. Returns None if the client cannot be built.

pub fn set_notice_callback(&self, callback: NoticeCallback)

Set the notice callback for this client. Can be called even when client is behind an Arc. First call wins - subsequent calls are ignored.

pub async fn fetch_commit_full_info( &self, repo_info: &GhRepoInfo, commit_hash: &str, ) -> Option<CommitInfo>

Fetch full commit information from a specific repository Returns None if the commit doesn’t exist on GitHub or client errors

pub async fn fetch_pr( &self, repo_info: &GhRepoInfo, number: u64, ) -> Option<PullRequestInfo>

Try to fetch a PR

pub async fn fetch_issue( &self, repo_info: &GhRepoInfo, number: u64, ) -> Option<ExtendedIssueInfo>

Try to fetch an issue

pub async fn fetch_releases_since( &self, repo_info: &GhRepoInfo, since_date: DateTime<Utc>, ) -> Vec<ReleaseInfo>

Fetch releases from GitHub, optionally filtered by date If since_date is provided, stop fetching releases older than this date This significantly speeds up lookups for recent PRs/issues

pub async fn fetch_release_by_tag( &self, repo_info: &GhRepoInfo, tag: &str, ) -> Option<ReleaseInfo>

Fetch a GitHub release by tag.

pub async fn fetch_tag_info_for_release( &self, release: &ReleaseInfo, repo_info: &GhRepoInfo, target_commit: &str, ) -> Option<TagInfo>

Fetch tag info for a release by checking if target commit is contained in the tag. Uses GitHub compare API to verify ancestry and get tag’s commit hash. Returns None if the tag doesn’t contain the target commit.

pub async fn tag_contains_commit( &self, repo_info: &GhRepoInfo, tag: &str, commit: &str, ) -> bool

Check if a tag contains a specific commit using the GitHub compare API.

Returns true if the commit is in the tag’s history (status is “behind” or “identical”).

pub async fn fetch_tag( &self, repo_info: &GhRepoInfo, tag_name: &str, ) -> Option<TagInfo>

Fetch tag info by name. Uses the commits API (which accepts refs) to resolve the tag to a commit, then optionally enriches with release info if available.

pub async fn fetch_file_content( &self, repo_info: &GhRepoInfo, path: &str, ) -> Option<String>

Fetch file content from the default branch.

Returns the decoded file content as a String, or None if the file doesn’t exist or can’t be decoded (e.g., binary files).

pub fn commit_url(repo_info: &GhRepoInfo, hash: &str) -> String

Build GitHub URLs for various things Build a commit URL (fallback when API data unavailable) Uses URL encoding to prevent injection

pub fn tag_url(repo_info: &GhRepoInfo, tag: &str) -> String

Build a tag URL pointing to the tree view (for plain git tags). Uses URL encoding to prevent injection.

pub fn release_tag_url(repo_info: &GhRepoInfo, tag: &str) -> String

Build a release URL pointing to the releases page (for tags with releases). Uses URL encoding to prevent injection.

pub fn profile_url(username: &str) -> String

Build a profile URL (fallback when API data unavailable) Uses URL encoding to prevent injection

pub fn author_url_from_email(email: &str) -> Option<String>

Build a profile URL from a GitHub noreply email address.

Extracts username from patterns:

• username@users.noreply.github.com
• id+username@users.noreply.github.com