Struct GitHub 

pub struct GitHub { /* private fields */ }

The GitHub implementation of RemoteHost, driven through gh.

Every method is one gh invocation, and the program that answers as gh is the seam a journey substitutes: GitHub’s decisioning is what a test replaces, never the git underneath it.

Implementations

impl GitHub

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

Address this host at one repository, named owner/name.

Checked here rather than at each call: the slug is interpolated into every gh --repo invocation, and a value that is not one repository is a value that addresses something nobody asked for.

Trait Implementations

impl Clone for GitHub

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 GitHub

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

Formats the value using the given formatter.

impl Eq for GitHub

impl PartialEq for GitHub

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl RemoteHost for GitHub

fn check_log(&self, cr: &ChangeRequest, check: &Check) -> Result<ArtifactId>

Store one check’s log as an artifact, or refuse.

A fetch that did not produce the log is an error and no artifact: an artifact reads as what the check printed, so one holding the reason there is none is a lie in the only record a consumer has. A caller that must not fail over a missing log declines to fail over this error, as crate::publish does.

fn describe_change( &self, cr: &ChangeRequest, title: Option<&str>, body: &str, ) -> Result<()>

One gh pr edit, handing the body over as a file.

A file rather than --body, because a body is prose of unbounded size and an argument vector is not where multi-line Markdown belongs: the same reason onevcs publish takes --body-file. The file is written under a scratch directory that goes when this returns, and gh reads it before then.

fn change_description(&self, cr: &ChangeRequest) -> Result<Description>

One gh pr view, reading exactly the two fields a description is.

A response missing either is refused rather than read as empty: “the change request has no body” and “the host would not say what the body is” are different facts, and a caller finishing a description off what it reads here would otherwise start from a blank the host never answered.

fn is_draft(&self, cr: &ChangeRequest) -> Result<bool>

One gh pr view, reading the one field the host decides a draft by.

A response that does not carry it is refused rather than read as “not a draft”: what this decides is whether a change may be asked to merge, and “could not look” reported as “nothing is holding it” is the one answer that lands work somebody held back.

fn merged_at(&self, cr: &ChangeRequest) -> Result<Option<Sha>>

One gh pr view, reading exactly the two fields a merge is decided from — the same read merge makes, through the same parser, so watching a change request and merging one cannot come to disagree about what merged means.

fn authenticated_user(&self) -> Result<String>

Who the host believes is calling.

fn open_change(&self, req: ChangeSpec) -> Result<ChangeRequest>

Open a change request.

fn find_changes(&self, head: &str, base: &str) -> Result<Vec<ChangeRequest>>

Every open change request from head into base.

fn change_checks(&self, cr: &ChangeRequest) -> Result<ChangeChecks>

The checks the host is reporting on a change request, and which of its sources that answer was read from.

fn merge(&self, cr: &ChangeRequest, policy: MergePolicy) -> Result<MergeOutcome>

Merge a change request under a policy.

fn ready_for_review(&self, cr: &ChangeRequest) -> Result<()>

Take a change request out of its draft state, so the host will let it land.

fn required_checks_on(&self, base: &str) -> Result<RequiredChecks>

The checks the repository requires before anything merges into base, asked of the branch itself rather than of a change request targeting it.

impl StructuralPartialEq for GitHub