Struct Attribution 

pub struct Attribution { /* private fields */ }

Maps a reverted commit back to the mainline commit that introduced it.

Needed because the obvious labelling — “a revert whose target is a merge” — sees almost nothing in a pull-request workflow. Measured on rust-lang/rust: of 307 unique revert targets, 39 are merges and 267 are ordinary commits, because a revert names the change, not the merge that landed it. Without attribution the proxy undercounts by roughly eight to one.

A struct rather than a bare map so it can carry why a target went unresolved, which is the part that would otherwise be silently lost.

Implementations

impl Attribution

pub fn new() -> Self

An empty attribution: every revert is matched by exact oid only, which is the behaviour before attribution existed.

pub fn insert(&mut self, target: String, introduced_by: String)

Records that target arrived on the mainline at introduced_by.

pub fn insert_unresolved(&mut self, target: String)

Records a target that could not be placed — not an ancestor of the branch tip, or absent from the clone.

pub fn get(&self, target: &str) -> Option<&str>

The mainline commit that introduced target, if known.

pub fn resolved_count(&self) -> usize

How many targets were placed.

pub fn unresolved(&self) -> &BTreeSet<String>

Targets that could not be placed. Non-empty is normal — a revert may target work that never reached this branch — but a large fraction means the corpus or the branch is the wrong one.

Trait Implementations

impl Clone for Attribution

fn clone(&self) -> Attribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attribution

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

Formats the value using the given formatter.

impl Default for Attribution

fn default() -> Attribution

Returns the “default value” for a type.

impl PartialEq for Attribution

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Attribution

impl StructuralPartialEq for Attribution