Struct BlameSession 

pub struct BlameSession { /* private fields */ }

Available on crate feature vcs-git only.

A PerFunctionBlame bound to one thread, holding the state a blame would otherwise rebuild per file.

Obtained from PerFunctionBlame::session. Not Sync — it holds a gix::Repository — so a worker pool wants one session per thread. The engine it was opened from is kept alive by the session and readable through engine, so a caller memoising sessions can confirm a cached one belongs to the engine at hand.

Implementations

impl BlameSession

pub fn engine(&self) -> &Arc<PerFunctionBlame>

The engine this session was opened from.

Compare with Arc::ptr_eq to confirm a memoised session belongs to the engine a caller is about to blame with.

pub fn commits_resolved(&self) -> usize

How many distinct commits this session has resolved so far — the size of the memo that makes a session worth holding.

Grows only when a blame meets a commit the session has not seen, so it is also how a caller sizes the session’s memory (see SessionState::commits) or confirms the memo is doing its job.

pub fn per_function( &mut self, absolute: &Path, spans: &[LineSpan], ) -> Result<Vec<Stats>, Error>

Blame the file at absolute once and return one Stats per entry in spans, in the same order — the session-backed form of PerFunctionBlame::per_function, with identical semantics.

Errors

See PerFunctionBlame::per_function.

Trait Implementations

impl Debug for BlameSession

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

Formats the value using the given formatter.