Crate vix_git 

Git integration for Vix.

Two layers:

• Pure logic (unit-tested, no I/O): parse_status turns git status --porcelain output into FileStatus rows, and diff_marks computes per-line editor-gutter LineMarks between the committed text and the current buffer (via the similar crate).
• Runners (shell out to the git CLI): is_repo, branch, status, head_blob, and the staging/commit helpers. Using the user’s own git means credential helpers, SSH agents, and hooks all behave exactly as on the command line.

Structs

BlameLine

One line’s git blame attribution: the short commit hash, author name, YYYY-MM-DD authored date, and the commit summary.

FileStatus

One changed path from git status, with its staged (index) and unstaged (working-tree) change, if any.

Hunk

A contiguous changed region between the committed text and the current buffer, for hunk navigation and revert.

LogEntry

One git log row.

LogPanel

A commit-list overlay: log/file_log entries, a highlighted row, and a scroll offset.

Enums

Change

A kind of change to a file (in the index or the working tree).

LineMark

A per-line change marker for the editor’s diff gutter.

LogScope

Where a LogPanel’s entries came from, and what its Enter should diff against.

Functions

blame_line

git blame for a single 1-based line of a repo-relative path, parsed into a BlameLine. None when not a repo, the path is untracked, or on error.

branch

The current branch name, or None when detached / not a repo. A detached HEAD yields the short commit hash via the caller’s discretion (here None).

checkout

Check out an existing branch (git switch <branch>). Returns Ok(()) on success, or the captured stderr on failure (e.g. a conflicting dirty tree).

commit

Commit the staged changes with message. Returns Ok(()) on success, or the captured stderr on failure (e.g. nothing staged, hook rejected).

commit_amend

Amend the previous commit, folding in currently-staged changes and keeping its message (git commit --amend --no-edit).

commit_count

The number of commits reachable from HEAD (git rev-list --count HEAD), or None when not a repo or there are no commits yet.

commit_signing_needs_tty

Whether committing in dir would sign with a terminal pinentry, which cannot run under Vix’s raw-mode screen (T570): commit.gpgsign is true, the signing format is GPG, and the user’s gpg-agent.conf selects a curses/tty pinentry.

create_branch

Create a new branch and switch to it (git switch -c <name>). Returns Ok(()) on success, or the captured stderr on failure (e.g. the name already exists or is invalid).

diff_marks

Compute per-line gutter marks between the committed text (head) and the current buffer (current), keyed by current line index (0-based).

file_log

The max most recent commits touching rel_path, following renames (Git → File History).

head_blob

The committed (HEAD) contents of a repo-relative path, or None if the path is not in HEAD (newly added/untracked) or on any error.

hunks

Group the line diff between committed text (head) and the current buffer into Hunks — maximal runs of adjacent changed lines — in current-line order. Pairs with diff_marks (which colors individual gutter lines).

index_blob

The staged (index) version of rel_path (git show :path), trailing newline preserved. None when the file is not in the index.

is_dirty

Whether the working tree has any staged or unstaged changes (incl. untracked).

is_repo

Whether dir is inside a git working tree.

local_branches

The local branch names, current branch first when it can be determined.

log

The repository’s max most recent commits on HEAD (Git → Log).

parse_blame_porcelain

Parse one entry of git blame --line-porcelain output into a BlameLine. Returns None if no header (hash) line is present.

parse_status

Parse git status --porcelain (v1) output into one FileStatus per path.

pinentry_wants_tty

Whether a gpg-agent.conf selects a terminal-based pinentry (pinentry-curses, pinentry-tty): the last pinentry-program line wins. Such a program draws on and reads from /dev/tty directly, so running it under Vix’s raw-mode screen corrupts the display and steals keystrokes (T570).

resolve_short_sha

Resolve revision (a branch, tag, or any commit-ish) to its abbreviated hash (git rev-parse --short), for titling an Open File at Revision tab. None when it doesn’t resolve or fails the ref-name validation.

show_commit

A commit’s own unified diff (git show <sha>), or just the part touching rel_path when given. None on any failure, including an invalid sha (rejected before shelling out, the same guard checkout uses).

show_file_at

rel_path’s content at revision (git show <revision>:<rel_path>, e.g. Git → Open File at Revision…). None when revision doesn’t resolve, the path isn’t in that tree, or revision fails the same validation checkout applies to a ref name.

stage

Stage a path (git add -- <path>).

stage_all

Stage every change in the working tree (git add -A).

stage_content

Replace the index entry for rel_path with exactly content (used to stage a single hunk): hash the content into a blob and point the index at it, keeping the working tree untouched.

staged_diff

The staged diff (git diff --staged), for feeding to an AI commit-message generator (T125) — None on any failure, or when nothing is staged (an empty diff is not useful context and would only prompt a generic reply).

stash_pop

Restore the most recent stash (git stash pop).

stash_push

Stash the working tree and index (git stash push).

status

The changed files reported by git status --porcelain.

unstage

Unstage a path (git restore --staged -- <path>).