Struct Service 

pub struct Service { /* private fields */ }

The machine’s GitHub, read through the mirror and written through GitHub.

Implementations

impl Service

pub fn new(mirror: Mirror) -> Self

pub fn mirror(&self) -> &Mirror

pub fn issues(&self, repos: &[String], wanted: IssueState) -> Outcome<IssueList>

Every mirrored issue of these repositories.

pub fn list(&self, scope: &Scope) -> Outcome<Listed>

A list scope as it stands.

pub fn single(&self, scope: &Scope) -> Outcome<Single>

A single-document scope as it stands.

pub fn overview( &self, repositories: &[Repository], ) -> Outcome<BTreeMap<String, RepoFacts>>

What the mirror knows about each repository of a checkout, in one read.

pub fn gists(&self) -> Outcome<Listed>

The person’s gists. Summaries until one is opened.

pub async fn gist( &self, client: Option<&GitHubClient>, id: &str, ) -> Outcome<GistAnswer>

One gist with its file contents.

The mirror answers when it holds the whole gist. Often it does not — the list endpoint omits file contents — and opening one is the moment where reaching GitHub is right: a person is waiting for exactly this, and what comes back is stored, so the next open is instant.

pub async fn comments( &self, client: Option<&GitHubClient>, repo: &str, number: i64, ) -> Outcome<Listed>

Comments on an issue or pull request.

Opening a thread is what puts it in the sweep: a thread nobody opened is not worth a request per sweep. The first open reads it now, when a token is there to read with; after that the mirror answers.

pub async fn create_issue( &self, client: &GitHubClient, owner: &str, repo: &str, request: &CreateIssueRequest, ) -> Outcome<GitHubIssue>

pub async fn update_issue( &self, client: &GitHubClient, owner: &str, repo: &str, number: i64, request: &UpdateIssueRequest, ) -> Outcome<GitHubIssue>

pub async fn add_comment( &self, client: &GitHubClient, owner: &str, repo: &str, number: i64, body: &str, ) -> Outcome<GitHubComment>

pub async fn create_gist( &self, client: &GitHubClient, request: &CreateGistRequest, ) -> Outcome<Value>

pub async fn update_gist( &self, client: &GitHubClient, id: &str, request: &UpdateGistRequest, ) -> Outcome<Value>

pub fn boards(&self, references: &[BoardRef]) -> Outcome<BoardList>

The boards a project references, as the mirror knows them.

pub fn all_boards(&self, references: &[BoardRef]) -> Outcome<AllBoards>

Every board of the token’s account, of each of its organisations, and of the owner of every board references names — with which of them those references are.

Boards belong to owners, not to projects, so this is the same list from whichever project it is asked; the references only mark the boards that project works with. An owner whose list has never been read is reported beside the boards that could be listed, never dropped silently.

pub fn cards(&self, board: &str) -> Outcome<Cards>

One board’s cards, in TODAY’S shape.

Every card is parsed into the type this version defines: a row an older version wrote takes the defaults of the fields it did not have, and a payload that does not parse AT ALL is raised — half a board is the silent wrong answer.

pub async fn refresh_boards( &self, client: &GitHubClient, references: &[BoardRef], ) -> SyncReport

Bring every board current now — who the token is, each owner’s list, the cards being kept — without the rest of the machine’s mirror.

pub async fn refresh_board( &self, client: &GitHubClient, board: &GitHubProject, force: bool, ) -> SyncReport

Bring one board’s cards current before it is shown, if due — or whether due or not, with force — and nothing else.

The board is one the mirror already lists, so its owner’s list has nothing to add. Reading more inside the request that opens a board made that request slow enough for its caller to give up, and a cancelled read left the board “not read yet” until the next scheduled pass (20 Oct 2026). A board’s cards need nothing but the board.

pub async fn set_field( &self, client: &GitHubClient, board: &str, item: &str, field: &str, value: Option<&ProjectFieldWrite>, ) -> Outcome<GitHubProjectItem>

Set one field of one card, or take its value off with None.

Clearing is its own act rather than an empty value: an empty text IS a value, and a board that could not tell “no due date” from “a due date of nothing” shows a column of blanks where it means to show none.

pub async fn move_card( &self, client: &GitHubClient, board: &str, item: &str, after: Option<&str>, ) -> Outcome<GitHubProjectItem>

Order a card: behind after, or first with None.

pub async fn set_archived( &self, client: &GitHubClient, board: &str, item: &str, archived: bool, ) -> Outcome<GitHubProjectItem>

Archive a card, or bring it back. Stated rather than toggled: a toggle acts on what the caller last saw.

pub async fn edit_draft( &self, client: &GitHubClient, board: &str, item: &str, content: &str, title: &str, body: &str, ) -> Outcome<GitHubProjectItem>

Rewrite a draft card’s title and body, whole.

pub async fn add_draft( &self, client: &GitHubClient, board: &str, title: &str, body: &str, ) -> Outcome<GitHubProjectItem>

A card that lives only on the board.

pub async fn add_existing( &self, client: &GitHubClient, board: &str, url: &str, ) -> Outcome<GitHubProjectItem>

A card for an issue or pull request that already exists, by its URL.

pub async fn remove_card( &self, client: &GitHubClient, board: &str, item: &str, ) -> Outcome<()>

Take a card off the board. The issue itself is untouched — a board owns cards, not issues — and a draft has nowhere else to be.

pub async fn add_column( &self, client: &GitHubClient, board: &str, field: &str, name: &str, color: &str, description: &str, ) -> Outcome<(GitHubProject, Vec<GitHubProjectItem>)>

Add a column to a board’s single-select field.

pub async fn remove_column( &self, client: &GitHubClient, board: &str, field: &str, option: &str, ) -> Outcome<(GitHubProject, Vec<GitHubProjectItem>)>

Remove a column. GitHub clears that value from affected cards; every card is read again before the mirror changes, so they land in no column.

Trait Implementations

impl Clone for Service

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Service

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

Formats the value using the given formatter.