Struct GitRepository 

pub struct GitRepository { /* private fields */ }

A wrapper around gix::Repository providing a simplified interface for Git repository operations.

Implementations

impl GitRepository

pub fn init(path: &Path) -> Result<Self>

Initialize a new Git repository at the given path.

Creates the directory (and parents) if it does not exist, then initializes a standard (non-bare) Git repository with a .git directory.

pub fn open(path: &Path) -> Result<Self>

Open an existing Git repository at the given path.

pub fn path(&self) -> &Path

Get the working directory path of the repository.

Returns the working tree directory if available, otherwise falls back to the .git directory itself.

pub fn inner(&self) -> &Repository

Get a reference to the inner gix::Repository.

pub fn commit( &self, message: &str, author_name: &str, author_email: &str, ) -> Result<String>

Create a Git commit with the current working directory state. Uses command-line git for simplicity (gix’s commit API is complex).

pub fn read_tree_entry(&self, commit_hex: &str, path: &str) -> Result<Vec<u8>>

Read a file’s content from a specific commit’s tree (NOT the working directory). This is the core isolation primitive for Native Session Isolation.

commit_hex — hex SHA of the commit whose tree to read from. path — relative file path within the tree (e.g. “src/main.rs”).

Returns the raw bytes of the blob, or an error if the commit / path does not exist or the entry is not a blob.

pub fn list_tree_files(&self, commit_hex: &str) -> Result<Vec<String>>

List all files (recursive) in a commit’s tree. Returns relative paths using forward-slash separators.

Only non-tree entries (blobs, symlinks, submodules) are included.

pub fn commit_tree_overlay( &self, base_commit_hex: &str, overlay: &[(String, Option<Vec<u8>>)], parent_commit_hex: &str, message: &str, author_name: &str, author_email: &str, ) -> Result<String>

Build a new git tree by applying overlay changes on a base tree, create a commit, and update the working directory.

For each overlay entry:

• Some(content) → upsert a blob at that path
• None → delete the entry at that path

After committing, the working directory is updated via git checkout HEAD -- ..

Returns the hex SHA of the new commit.

pub fn commit_initial_overlay( &self, overlay: &[(String, Option<Vec<u8>>)], message: &str, author_name: &str, author_email: &str, ) -> Result<String>

Create an orphan commit from overlay entries on an empty repository (no existing commits). This is used for the very first commit.

Builds a tree from scratch using only the overlay entries (ignoring None/deletion entries since there’s nothing to delete), creates a root commit with no parents, and updates HEAD.

Returns the hex SHA of the new commit.

pub fn head_hash(&self) -> Result<Option<String>>

Get the HEAD commit hash as a hex string, or None if the repository is empty (no commits yet).