Enum InstallationDiscovery 

pub enum InstallationDiscovery {
    NotInstalled {
        install_url: Url,
    },
    Indeterminate {
        skipped: usize,
    },
    Installed(ReachableTargets),
}

What auth status and auth login show after a successful sign-in.

Variants

NotInstalled

The credential is valid, GitHub reported nothing this client could not describe, and still nothing is reachable: the App is installed nowhere, or on nothing. 03-control-flows.md flow 1.1 requires the installation URL here, and the URL is the remediation.

Fields

install_url: Url

Indeterminate

Nothing is reachable, but at least one installation was skipped, so this client cannot tell “not installed” from “installed on something it could not describe”.

Why this variant exists at all

Skipping an unnameable installation is the right trade — one odd installation must not take down auth status for every other one — but it was made silently, and the silence flipped a verdict. An account this client cannot name, on the only installation the credential has, used to collapse to InstallationDiscovery::NotInstalled, and auth status then handed an already-installed operator the “install the App” URL. That is a wrong remediation on the only authentication path there is, contradicted by nothing louder than a warn! in a log the operator is not reading.

So the skip stays and the verdict does not flip. There is deliberately no install_url here: the whole point is that this client does not know whether installing is the remedy, and offering the URL anyway would put the wrong answer back one field over. f1 says “1 installation could not be described” and stops there, which is true.

Fields

skipped: usize

Installed(ReachableTargets)

The credential reaches at least one repository or organization. It may still be an incomplete picture — see ReachableTargets::skipped.

Implementations

impl InstallationDiscovery

pub fn targets(&self) -> Option<&ReachableTargets>

pub fn install_url(&self) -> Option<&Url>

The installation URL, and only when installing is actually the remediation. See InstallationDiscovery::Indeterminate.

pub fn skipped(&self) -> usize

How many installations GitHub reported that this client could not describe, whichever verdict was reached. One call for f1, so that “this report is incomplete” does not depend on which variant it landed in.

Trait Implementations

impl Clone for InstallationDiscovery

fn clone(&self) -> InstallationDiscovery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstallationDiscovery

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

Formats the value using the given formatter.

impl Eq for InstallationDiscovery

impl PartialEq for InstallationDiscovery

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InstallationDiscovery