Struct GitHubClient 

pub struct GitHubClient { /* private fields */ }

GitHub API client

Implementations

impl GitHubClient

pub fn new( token: impl Into<String>, owner: impl Into<String>, repo: impl Into<String>, ) -> Result<Self>

Create a new GitHub client with personal access token

Arguments

• token - GitHub personal access token (ghp_xxx)
• owner - Repository owner (user or organization)
• repo - Repository name

Example

use miyabi_github::GitHubClient;

let client = GitHubClient::new("ghp_xxx", "user", "repo")?;

pub fn octocrab(&self) -> &Octocrab

Get the underlying Octocrab client for advanced usage

pub fn owner(&self) -> &str

Get repository owner

pub fn repo(&self) -> &str

Get repository name

pub fn full_name(&self) -> String

Get full repository name (owner/repo)

pub async fn verify_auth(&self) -> Result<String>

Verify authentication by fetching current user

pub async fn get_repository(&self) -> Result<Repository>

Get repository information

impl GitHubClient

pub async fn get_issue(&self, number: u64) -> Result<Issue>

Get a single issue by number

Arguments

• number - Issue number

Returns

Issue struct with all metadata

pub async fn list_issues( &self, state: Option<State>, labels: Vec<String>, ) -> Result<Vec<Issue>>

List issues with optional filtering

Arguments

• state - Filter by state (Open/Closed/All)
• labels - Filter by labels (empty = all)

Returns

Vector of Issue structs

pub async fn create_issue( &self, title: &str, body: Option<&str>, ) -> Result<Issue>

Create a new issue

Arguments

• title - Issue title
• body - Issue body (optional)

Returns

Created Issue struct

pub async fn update_issue( &self, number: u64, title: Option<&str>, body: Option<&str>, state: Option<State>, ) -> Result<Issue>

Update an existing issue

Arguments

• number - Issue number to update
• title - New title (optional)
• body - New body (optional)
• state - New state (optional)

Returns

Updated Issue struct

pub async fn close_issue(&self, number: u64) -> Result<Issue>

Close an issue

pub async fn reopen_issue(&self, number: u64) -> Result<Issue>

Reopen an issue

pub async fn add_labels( &self, number: u64, labels: &[String], ) -> Result<Vec<String>>

Add labels to an issue

Arguments

• number - Issue number
• labels - Labels to add

pub async fn remove_label(&self, number: u64, label: &str) -> Result<()>

Remove a label from an issue

Arguments

• number - Issue number
• label - Label to remove

pub async fn replace_labels( &self, number: u64, labels: &[String], ) -> Result<Vec<String>>

Replace all labels on an issue

Arguments

• number - Issue number
• labels - New set of labels

pub async fn get_issues_by_state(&self, state: IssueState) -> Result<Vec<Issue>>

Get issues by state label (e.g., “state:pending”)

Arguments

• state - IssueState enum value

Returns

Vector of issues with that state label

impl GitHubClient

pub async fn list_labels(&self) -> Result<Vec<Label>>

List all labels in the repository

pub async fn get_label(&self, name: &str) -> Result<Label>

Get a single label by name

pub async fn create_label( &self, name: &str, color: &str, description: Option<&str>, ) -> Result<Label>

Create a new label

Arguments

• name - Label name
• color - Label color (hex without #, e.g., “ff0000”)
• description - Label description (optional)

pub async fn update_label( &self, name: &str, new_name: Option<&str>, color: Option<&str>, description: Option<&str>, ) -> Result<Label>

Update an existing label

Arguments

• name - Current label name
• new_name - New label name (optional)
• color - New color (optional)
• description - New description (optional)

pub async fn delete_label(&self, name: &str) -> Result<()>

Delete a label

pub async fn bulk_create_labels(&self, labels: Vec<Label>) -> Result<Vec<Label>>

Bulk create labels from a list

Arguments

• labels - Vector of labels to create

Returns

Vector of created labels (some may fail, errors are logged)

pub async fn label_exists(&self, name: &str) -> Result<bool>

Check if a label exists

pub async fn sync_labels(&self, labels: Vec<Label>) -> Result<usize>

Sync labels from a YAML/JSON definition file (Useful for setting up the 53-label system)

Arguments

• labels - Labels to sync

Returns

Number of labels created/updated

impl GitHubClient

GitHub Projects V2 client

pub async fn get_project_items( &self, project_number: u32, ) -> Result<Vec<ProjectItem>>

Get all items from a GitHub Project V2

Arguments

• project_number - Project number (e.g., 1 for /projects/1)

Example

use miyabi_github::GitHubClient;

let client = GitHubClient::new("ghp_xxx", "owner", "repo")?;
let items = client.get_project_items(1).await?;
println!("Found {} items", items.len());

pub async fn update_project_field( &self, project_id: &str, item_id: &str, field_name: &str, value: &str, ) -> Result<()>

Update a custom field value for a project item

Arguments

• project_id - Project node ID (e.g., “PVT_kwDOAB…”)
• item_id - Project item node ID
• field_name - Custom field name (e.g., “Status”, “Agent”)
• value - New value

Example

use miyabi_github::GitHubClient;

let client = GitHubClient::new("ghp_xxx", "owner", "repo")?;
client.update_project_field(
    "PVT_kwDOAB...",
    "PVTI_lADO...",
    "Status",
    "Done"
).await?;

pub async fn calculate_project_kpis( &self, project_number: u32, ) -> Result<KPIReport>

Calculate KPIs from project data

Arguments

• project_number - Project number

Returns

KPIReport with aggregated metrics

impl GitHubClient

pub async fn get_pull_request(&self, number: u64) -> Result<PRResult>

Get a single pull request by number

Arguments

• number - Pull request number

pub async fn list_pull_requests( &self, state: Option<State>, ) -> Result<Vec<PRResult>>

List pull requests with optional filtering

Arguments

• state - Filter by state (Open/Closed/All)

pub async fn create_pull_request( &self, title: &str, head: &str, base: &str, body: Option<&str>, draft: bool, ) -> Result<PRResult>

Create a pull request

Arguments

• title - PR title
• head - Branch containing changes
• base - Base branch (e.g., “main”)
• body - PR body (optional)
• draft - Create as draft PR

pub async fn update_pull_request( &self, number: u64, title: Option<&str>, body: Option<&str>, state: Option<PullState>, ) -> Result<PRResult>

Update a pull request

Arguments

• number - PR number to update
• title - New title (optional)
• body - New body (optional)
• state - New state (optional)

pub async fn close_pull_request(&self, number: u64) -> Result<PRResult>

Close a pull request (without merging)

pub async fn merge_pull_request( &self, number: u64, commit_title: Option<&str>, commit_message: Option<&str>, ) -> Result<()>

Merge a pull request

Arguments

• number - PR number to merge
• commit_title - Merge commit title (optional)
• commit_message - Merge commit message (optional)

pub async fn is_mergeable(&self, number: u64) -> Result<bool>

Check if a pull request is mergeable

Trait Implementations

impl Clone for GitHubClient

fn clone(&self) -> GitHubClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.