Struct BaseResolution 

pub struct BaseResolution {
    pub spec: String,
    pub reference: Option<String>,
    pub commit: String,
    pub upstream: Option<Upstream>,
}

What a review’s --base <spec> resolved to — see Repo::resolve_base.

Serialisable because a report that does not say what it compared against cannot be checked against the question it was asked. Issue #649’s whole complaint about review was that its output under-describes its own basis: the diff was missing, and so was this.

Fields

spec: String

The revspec exactly as it was given on the command line.

Kept beside BaseResolution::reference rather than replaced by it, because the gap between the two is the defect: main and refs/heads/main printed together are what let a reader see that they did not ask for refs/remotes/origin/main.

reference: Option<String>

The full name of the ref the spec bound to (refs/heads/main), or None when the spec named no ref — a raw sha, HEAD~3.

commit: String

The commit it resolved to, in full hex.

upstream: Option<Upstream>

How that commit stands against its upstream, when it has one.

Implementations

impl BaseResolution

pub fn short_commit(&self) -> &str

The first twelve hex digits of BaseResolution::commit, for a summary line.

Twelve rather than git’s default seven: seven is chosen for typing, and this is chosen for comparing — the reader’s next move is git rev-parse --short main origin/main, whose seven-digit answer is a prefix of this one, so the comparison still works in the direction it is actually made.

Trait Implementations

impl Clone for BaseResolution

fn clone(&self) -> BaseResolution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BaseResolution

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

Formats the value using the given formatter.

impl Eq for BaseResolution

impl PartialEq for BaseResolution

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BaseResolution

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BaseResolution