Enum Outcome 

pub enum Outcome {
    Applied {
        edit: ManifestEdit,
        target: ConcreteVersion,
    },
    Skipped {
        reason: SkipReason,
        target: Option<ConcreteVersion>,
    },
    RequiresLockfileUpdate {
        target: ConcreteVersion,
    },
    Unfixable(UnfixableReason),
}

A dependency’s disposition within an UpdatePlan.

The invalid state this makes unrepresentable (#1349, #1615)

Before this type carried ManifestEdit directly, PlannedUpdateItem stored outcome and edit: Option<ManifestEdit> as two independent fields the caller had to keep in sync by convention (#1349) — that combination made apply_plan report success (Ok(())) without writing anything. edit was folded into Self::Applied to close that gap, but the dependency’s target version stayed a second, independently settable field on PlannedUpdateItem itself, which reopened the same class of bug: an Applied item with no target. #1615 folds the target into each variant that actually carries one instead, so Self::Applied with no target fails to compile:

use deps_cli::update::Outcome;
use deps_core::edit::ManifestEdit;
use deps_core::position::{Position, Range};

let outcome = Outcome::Applied {
    edit: ManifestEdit {
        range: Range::new(Position::new(0, 9), Position::new(0, 14)),
        new_text: "1.2.0".to_string(),
    },
};

Variants

Applied

A fix plan existed and its edit was written (or would be, under --dry-run). Contributes to exit 0. Carries the edit and its target version — #1349/#1615: this makes “applied, but no edit/target to write” unrepresentable, where separate PlannedUpdateItem fields previously let them drift out of sync (apply_plan would report success without writing anything).

Fields

edit: ManifestEdit

The edit apply_plan writes.

target: ConcreteVersion

The version this edit moves the dependency to.

Skipped

Excluded from this run, for SkipReason.

Fields

reason: SkipReason

Why this candidate was skipped.

target: Option<ConcreteVersion>

The target version considered for this occurrence, when one was known — None when no concrete target exists (an unplannable latest, an ignore-rule skip of an OSV-blocked fallback, or — under --security-only — a not-requested item).

RequiresLockfileUpdate

(--security-only only) The dependency is Vulnerable, but its declared requirement already admits the fix target, so no requirement-level edit exists — needs #1116. Contributes to exit 1.

Fields

target: ConcreteVersion

The already-admitted fix target.

Unfixable(UnfixableReason)

(--security-only only) No verified fix could be written, for UnfixableReason. Contributes to exit 1.

Implementations

impl Outcome

pub const fn wire_token(&self) -> &'static str

The FR-021 wire token (--format json’s outcome field, and the table’s [..] prefix): one of exactly applied / skipped / requires-lockfile-update / unfixable — a SkipReason/UnfixableReason’s own detail is carried in PlannedUpdateItem::reason instead, not folded into this token.

pub const fn target(&self) -> Option<&ConcreteVersion>

This outcome’s target version, when its variant carries one — the sole read path for a dependency’s considered/applied target (#1615), used by PlannedUpdateItem::target and every formatter.

Trait Implementations

impl Clone for Outcome

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 Outcome

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

Formats the value using the given formatter.

impl Eq for Outcome

impl From<&Outcome> for OutcomeToken

fn from(outcome: &Outcome) -> Self

Converts to this type from the input type.

impl PartialEq for Outcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Outcome