Struct EventIndex 

pub struct EventIndex { /* private fields */ }

The contribution set for one scope: contributions in first-seen order, deduplicated by event id (T005).

Inflating this type is deliberate — the count-mode fold (WP02) reads it once, so a contribution cannot be counted twice by being walked twice, and the dedupe lives here rather than at each caller.

Implementations

impl EventIndex

pub fn new(scope: AnalyticsScope) -> Self

An empty index for a scope.

pub fn scope(&self) -> &AnalyticsScope

The scope every contribution in this index was classified against.

pub fn contribute(&mut self, event: AnalyticsEvent) -> Contribution

Contribute one event, reporting what happened.

The duplicate check covers ids already admitted and ids already refused for being outside the period, and it comes first; the period check comes second. So classifying one recorded event twice is inert whichever side of the period it fell on, and both counters measure recorded events rather than classifications.

pub fn contribute_history( &mut self, source_ref: &str, history: &History, ) -> usize

Contribute every parsed entry of a History section, returning how many were newly added.

The ordinal an event is identified by counts parsed events only: an unparseable line a human inserted occupies no ordinal, so it cannot renumber the events after it and two classifications of one file agree on every id. A line that was a readable event and was mangled into unreadability does still close up the ordinals behind it — see the module’s provenance note for why that is the accepted trade rather than a content hash.

pub fn events(&self) -> impl Iterator<Item = &AnalyticsEvent> + '_

The contributed events, in first-seen order.

pub fn of_class( &self, class: EventClass, ) -> impl Iterator<Item = &AnalyticsEvent> + '_

The contributed events of one class, in first-seen order.

pub fn count_of(&self, class: EventClass) -> usize

How many events of one class contributed.

pub fn len(&self) -> usize

How many contributions the index holds.

pub fn is_empty(&self) -> bool

Whether the index holds no contribution at all — which is the honest answer for a project whose files carry no events, not an error.

pub fn duplicates(&self) -> usize

How many repeated classifications the index rejected (C-002).

pub fn outside_period(&self) -> usize

How many recorded events fell outside the scope’s period and were therefore not contributions — an event count, not a count of classifications, because an id already refused here is remembered (C-002). Coverage context: a non-zero count says the period excluded recorded history, never that the history is absent.

Trait Implementations

impl Clone for EventIndex

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 EventIndex

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

Formats the value using the given formatter.