Struct GitHubSource 

pub struct GitHubSource { /* private fields */ }

Imports issues from a single GitHub repository.

Implementations

impl GitHubSource

pub fn new(owner_repo: impl Into<String>) -> Result<Self>

Import from owner/name anonymously (subject to GitHub’s low unauth rate limit).

pub fn with_token( owner_repo: impl Into<String>, token: impl Into<String>, ) -> Result<Self>

Import from owner/name, authenticating with a personal-access / app token on every request.

pub fn with_base( api_root: &str, owner_repo: impl Into<String>, token: Option<String>, ) -> Result<Self>

Import against a custom API base — GitHub Enterprise (e.g. https://ghe.example.com/api/v3) or a test server.

Trait Implementations

impl TicketSource for GitHubSource

fn capabilities(&self) -> Capabilities

What this source supports. Callers consult this before attempting writes.

fn fetch_changed<'life0, 'life1, 'async_trait>( &'life0 self, cursor: &'life1 Cursor, ) -> Pin<Box<dyn Future<Output = Result<Page>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Tickets changed since cursor (or all tickets, if the cursor is empty), plus the cursor to resume incremental sync from.

fn get<'life0, 'life1, 'async_trait>( &'life0 self, uid: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Ticket>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch a single ticket by its stable provider uid.

fn set_state<'life0, 'life1, 'async_trait>( &'life0 self, uid: &'life1 str, target: StateCategory, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Move a ticket to a normalized [StateCategory]. The source resolves this to its native mechanism (a Jira transition, a GitLab label swap, an Asana section move). Capability-gated: defaults to Unsupported.

fn comment<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, uid: &'life1 str, body: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Append a comment to a ticket. Capability-gated: defaults to Unsupported.