Struct Repo 

pub struct Repo { /* private fields */ }

Implementations

impl Repo

pub fn open(dir: &Path) -> Result<Self, EngineError>

Open the repository containing dir.

pub fn root(&self) -> &Path

Trait Implementations

impl Ancestry for Repo

fn commit_of(&self, spec: &str) -> Result<Option<String>, EngineError>

The commit a spec names NOW, or None if it names nothing.

fn is_ancestor(&self, older: &str, newer: &str) -> Result<bool, EngineError>

Is older reachable from newer?

impl AttributeSource for Repo

fn check_attr( &self, attr: &str, paths: &[&[u8]], ) -> Result<Vec<AttrValue>, EngineError>

Note, unchanged from before this trait existed: check-attr consults the worktree/index .gitattributes, not the reviewed revisions — acceptable for a hint that can never remove a file from enumeration.

impl Clone for Repo

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommitHistory for Repo

fn has_commits(&self) -> bool

False on an unborn HEAD — there is nothing to diff against.

fn recent_commits( &self, from: &str, max: usize, ) -> Result<Vec<CommitSummary>, EngineError>

The most recent max commits reachable from from, newest first.

fn refs_by_commit(&self) -> HashMap<String, Vec<String>>

Branch/tag/remote names by the COMMIT sha they point at, annotated tags peeled.

impl CommitWriter for Repo

fn commit_tree( &self, tree: &str, parent: &str, message: &[u8], identity: CommitIdentity<'_>, ) -> Result<String, EngineError>

impl Debug for Repo

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

Formats the value using the given formatter.

impl DiffSource for Repo

fn raw_records(&self, base: &str, head: &str) -> Result<Vec<u8>, EngineError>

diff-tree -r -z --raw --full-index --no-renames: authoritative modes, full oids, dispositions.

fn canonical_patch( &self, base: &str, head: &str, ) -> Result<Vec<u8>, EngineError>

diff-tree -r -U0 --no-renames --no-color --no-ext-diff: the canonical patch. Every hunk in the system comes from here.

fn rename_records(&self, base: &str, head: &str) -> Result<Vec<u8>, EngineError>

diff-tree -r -M -z --name-status: rename-detected annotations only (ADR 0003). Never affects what exists.

impl Fetcher for Repo

fn fetch(&self, remote: &str, refspecs: &[&str]) -> Result<(), EngineError>

git fetch <remote> <refspec>…, and nothing about what came back: the caller asks Ancestry::commit_of afterwards, as it did before.

impl ObjectReader for Repo

fn blob(&self, rev: &str, path: &[u8]) -> Result<Option<Vec<u8>>, EngineError>

Blob content at rev:path, with path kept as raw bytes.

fn blobs( &self, specs: &[(&str, &[u8])], ) -> Result<Vec<Option<Vec<u8>>>, EngineError>

The same, for several specs at once, answered in the order given.

fn require_object(&self, oid: &str) -> Result<(), EngineError>

Assert oid is present in the odb.

impl ObjectWriter for Repo

fn write_blob(&self, content: &[u8]) -> Result<String, EngineError>

Write content as a blob and return its oid.

impl RangeResolver for Repo

fn merge_base(&self, a: &str, b: &str) -> Result<String, EngineError>

fn resolve_endpoint(&self, rev: &str) -> Result<String, EngineError>

Resolve to a commit sha, or accept a raw tree oid.

impl RecountSource for Repo

fn recount_patch(&self, from: &str, to: &str) -> Result<Vec<u8>, EngineError>

Spelled out here rather than delegating to canonical_patch, and the argv genuinely differs from it (no --no-color --no-ext-diff). Both facts are deliberate: invariant 4’s independence is the whole point, so one edit to enumeration’s flags must not move both sides of the comparison. Do not “tidy” these two into one.

impl RefWriter for Repo

fn update_ref(&self, name: &str, target: &str) -> Result<(), EngineError>

impl RepoLayout for Repo

fn common_dir(&self) -> Result<PathBuf, EngineError>

The shared git directory, absolutised (worktree-safe).

impl TreeBuilder for Repo

type Session = ScratchIndex

Not object-safe, by design: an associated type makes Box<dyn TreeBuilder> impossible, so runtime dispatch cannot creep back in behind this seam.

fn begin_from_tree(&self, tree_ish: &str) -> Result<ScratchIndex, EngineError>

A scratch index seeded from tree_ish.

fn begin_from_current_index(&self) -> Result<ScratchIndex, EngineError>

A scratch index seeded from the repository’s CURRENT index, for the ADR-0017 uncommitted-state snapshots.

impl TreeResolver for Repo

fn tree_of(&self, rev: &str) -> Result<String, EngineError>

impl WorkingCopy for Repo

fn has_tracked_changes(&self) -> Result<bool, EngineError>

diff-index --quiet HEAD --: exit 1 means differences, which is the answer rather than a failure — hence run_status instead of run.

fn tracked_paths(&self) -> Result<Vec<u8>, EngineError>

NUL-terminated tracked paths.

fn untracked_paths(&self) -> Result<Vec<u8>, EngineError>

NUL-terminated untracked-but-not-ignored paths.