Struct LockLedger 

pub struct LockLedger { /* private fields */ }

What: Where a command’s Git child can leave reference locks. Why: The sweep after a stop judges the locks of this repository, the one the child worked in; the time taken before the child started tells a lock born in its life from an older one.

In TS you’d write (pseudocode):

type LockLedger = { roots: string[]; since: Date; judge?: Judge };

Implementations

impl LockLedger

pub fn none() -> Self

A ledger that finds nothing: for a child that holds no Git lock, such as a reader of objects.

pub fn before_start(command: &Command) -> Self

The ledger of a command that has not started yet: its repository comes from GIT_DIR in its environment, or from its working directory (the process’s own when the command sets none).

pub fn sweep(&self, tree: &[TreeMember]) -> Vec<PathBuf>

What: Judge the reference locks of the repository once the child is gone, remove the ones whose holder is proven gone, say what was found about the rest, and return the paths removed. Why: Nothing ties a lock to the stopped child except a proof about its holder: the stopped child’s tree, a time of birth and an empty file all fit a live writer of another Git as well. The judgement is the one that runs before every fetch and push, so the proof, the notice and the conditional removal are the same everywhere.

In TS you’d write (pseudocode):

function sweep(tree: TreeMember[]): string[];

Trait Implementations

impl Clone for LockLedger

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 LockLedger

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

Formats the value using the given formatter.