Struct InstallationClient 

pub struct InstallationClient { /* private fields */ }

Installation-scoped GitHub API client.

Holds a reference to the parent GitHubClient for shared HTTP client, auth provider, and rate limiter. All operations use installation tokens.

Implementations

impl InstallationClient

pub fn new(client: Arc<GitHubClient>, installation_id: InstallationId) -> Self

Create a new installation client.

Arguments

• client - Parent GitHubClient
• installation_id - Installation ID to bind to

pub fn installation_id(&self) -> InstallationId

Get the installation ID this client is bound to.

pub async fn get(&self, path: &str) -> Result<Response, ApiError>

Make an authenticated GET request to the GitHub API.

Uses installation token for authentication and includes automatic retry logic for transient errors (5xx, 429, network failures).

Arguments

• path - API path (e.g., “/repos/owner/repo” or “repos/owner/repo”)

Returns

Returns the raw reqwest::Response for flexible handling.

Errors

Returns ApiError for HTTP errors, authentication failures, or network issues.

pub async fn post<T: Serialize>( &self, path: &str, body: &T, ) -> Result<Response, ApiError>

Make an authenticated POST request to the GitHub API.

Includes automatic retry logic for transient errors.

Arguments

• path - API path
• body - Request body (will be serialized to JSON)

Errors

Returns ApiError for HTTP errors, serialization failures, or network issues.

pub async fn put<T: Serialize>( &self, path: &str, body: &T, ) -> Result<Response, ApiError>

Make an authenticated PUT request to the GitHub API.

Includes automatic retry logic for transient errors.

pub async fn delete(&self, path: &str) -> Result<Response, ApiError>

Make an authenticated DELETE request to the GitHub API.

Includes automatic retry logic for transient errors.

pub async fn post_graphql<V: Serialize>( &self, query: &str, variables: V, ) -> Result<Value, ApiError>

Make an authenticated POST request to the GitHub GraphQL API.

GitHub’s GraphQL endpoint always returns HTTP 200 even for errors. Application-level errors are detected by checking the .errors array in the response body; the first error message is surfaced as ApiError::GraphQlError. On success, the .data value is returned.

Retry logic (backoff, 5xx, rate-limit handling) is identical to the REST helpers because the transport layer is the same.

Arguments

• query - GraphQL query or mutation string
• variables - Variables object (serialised to JSON)

Returns

Returns the data field from the GraphQL response as a serde_json::Value.

Errors

• ApiError::GraphQlError — GitHub returned .errors in the body
• ApiError::GraphQlError — response body contains neither .errors nor a non-null .data field (malformed or unexpected response shape)
• ApiError::AuthenticationFailed — HTTP 401
• ApiError::JsonError — response body could not be parsed
• Any other ApiError variant for HTTP-level failures

pub async fn patch<T: Serialize>( &self, path: &str, body: &T, ) -> Result<Response, ApiError>

Make an authenticated PATCH request to the GitHub API.

Includes automatic retry logic for transient errors.

pub async fn delete_with_body<T: Serialize>( &self, path: &str, body: &T, ) -> Result<Response, ApiError>

Make an authenticated DELETE request with a JSON body to the GitHub API.

Used for endpoints that require a body on DELETE (e.g. remove assignees).

impl InstallationClient

pub fn issues(&self) -> IssuesClient

Access issue-domain operations.

See docs/specs/interfaces/issue-operations.md; ADR-003.

pub fn pull_requests(&self) -> PullRequestsClient

Access pull request operations, reviews, and inline comments.

See docs/specs/interfaces/pull-request-operations.md; ADR-003.

pub fn labels(&self) -> LabelsClient

Access repository-level label catalogue operations.

See docs/specs/interfaces/labels-client.md; ADR-003.

pub fn milestones(&self) -> MilestonesClient

Access milestone CRUD operations.

See docs/specs/interfaces/milestones-client.md; ADR-003.

pub fn repositories(&self) -> RepositoriesClient

Access repository, branch, tag, git-ref, and commit operations.

See docs/specs/interfaces/repository-operations.md; ADR-003.

pub fn workflows(&self) -> WorkflowsClient

Access GitHub Actions workflow and run operations.

See docs/specs/interfaces/additional-operations.md; ADR-003.

pub fn releases(&self) -> ReleasesClient

Access release CRUD operations.

See docs/specs/interfaces/additional-operations.md; ADR-003.

pub fn projects(&self) -> ProjectsClient

Access GitHub Projects V2 operations.

See docs/specs/interfaces/project-operations.md; ADR-003.

Trait Implementations

impl Clone for InstallationClient

fn clone(&self) -> InstallationClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstallationClient

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

Formats the value using the given formatter.